|
出自：yesky wayne 這是本系列的第二篇文章。在上一篇文章中，我們簡(jiǎn)要地討論了XML以及為什么一個(gè)樹(shù)形結(jié)構(gòu)適合顯示XML、如何處理XML數(shù)據(jù)、如何使用JTree Swing 組件以及如何創(chuàng)建一個(gè)可重用的能夠分析XML文檔以及在Jtree顯示數(shù)據(jù)的組件。 在本文中，我們將創(chuàng)建我們的XML編輯器的框架，為了達(dá)到這個(gè)目的，我們將用到許多Swing組件（包括JsplitPane、JscrollPane、Jbutton和JtextArea組件）。 一、問(wèn)題的提出與解決 我如何創(chuàng)建一個(gè)能夠?yàn)g覽文本和瀏覽視圖的XML文本編輯器呢？創(chuàng)建一個(gè)包含Jbutton和JsplitPane的Jframe對(duì)象， 然后讓JsplitPane對(duì)象包含兩個(gè)JscrollPane對(duì)象，一個(gè)用于瀏覽圖形(xTree類(lèi))，另一個(gè)用于瀏覽文本(JtextArea類(lèi))。Jbutton用來(lái)管理刷新圖形瀏覽的操作。 二、增強(qiáng)Xtree類(lèi)的功能 在上一篇文章中，我們開(kāi)發(fā)了Xtree類(lèi)，這是一個(gè)可重用的組件，繼承于Jtree類(lèi)并能夠把XML數(shù)據(jù)以圖形樹(shù)的形式顯示。我們現(xiàn)在就增強(qiáng)這個(gè)類(lèi)， 通過(guò)提供給它一個(gè)在顯示默認(rèn)的XML樹(shù)來(lái)We will now enhance that class by providing it with a default XML tree to display in the event that an XML file is not supplied at the command-line. 而且，我們還將添加一些錯(cuò)誤處理邏輯以便程序不會(huì)因?yàn)闊o(wú)效的XML而崩潰。 第一步是創(chuàng)建一個(gè)名為buildTree()的方法： private DefaultTreeModel buildTree( String text ) { DefaultMutableTreeNode treeNode; Node newNode; // 采用DOM根節(jié)點(diǎn)并把它轉(zhuǎn)化成為一個(gè)Tree模型 newNode = parseXml( text ); if ( newNode != null ) { treeNode = createTreeNode( newNode ); return new DefaultTreeModel( treeNode ); } else return null; } file://結(jié)束buildTree() 這個(gè)方法取得傳入的 XML字符串，分析這個(gè) XML字符串并構(gòu)造一個(gè)可以用來(lái)從數(shù)據(jù)中構(gòu)造圖形樹(shù)形結(jié)構(gòu)的DefaultTreeModel變量實(shí)例。這個(gè)功能原來(lái)包含在 XTree()構(gòu)造程序中，但是我們把它拿出來(lái)然后把它放進(jìn)一個(gè)單獨(dú)的方法中，這樣我們就有了創(chuàng)建一個(gè)默認(rèn)圖形樹(shù)的伸縮性。這就是我們接下來(lái)想做的事。 接下來(lái)一步是創(chuàng)建一個(gè)叫 buildWelcomeTree()的方法。這個(gè)方法一次構(gòu)建一個(gè)DefaultTreeModel變量，而不是通過(guò)分析一個(gè)現(xiàn)有的XML文字字符串。如果用戶(hù)沒(méi)有指定 XML文件就啟動(dòng)這個(gè)應(yīng)用程序，將顯示 DefaultTreeModel。見(jiàn)代碼段1 代碼段1： private DefaultTreeModel buildWelcomeTree() { DefaultMutableTreeNode root; DefaultMutableTreeNode instructions, openingDoc, editingDoc, savingDoc; DefaultMutableTreeNode openingDocText, editingDocText, savingDocText; DefaultMutableTreeNode development, addingFeatures, contactingKyle; root = new DefaultMutableTreeNode( \"Welcome to XML View 1.0\" ); instructions = new DefaultMutableTreeNode( \"Instructions\" ); openingDoc = new DefaultMutableTreeNode ( \"Opening XML Documents\" ); openingDocText = new DefaultMutableTreeNode ( \"When invoking the XmlEditor from the command-line, you must specify the filename.\" ); editingDoc = new DefaultMutableTreeNode ( \"Editing an XML Document\" ); editingDocText = new DefaultMutableTreeNode ( \"XML text in the right hand frame can be edited directly. The \\"refresh\\" button will rebuild the JTree in the left frame.\" ); savingDoc = new DefaultMutableTreeNode ( \"Saving an XML Document\" ); savingDocText = new DefaultMutableTreeNode ( \"This iteration of the XmlEditor does not provide the ability to save your document. That will come with the next article.\" ); root.add( instructions ); instructions.add( openingDoc ); instructions.add( editingDoc ); openingDoc.add( openingDocText ); editingDoc.add( editingDocText ); return new DefaultTreeModel( root ); } 接下來(lái)的我們需要添加一個(gè)新的構(gòu)造程序來(lái)簡(jiǎn)化默認(rèn)顯示功能，我們將修改主構(gòu)造程序，這樣它就不能接受任何參數(shù)，創(chuàng)建一個(gè)新的能接收單一的 XML文本字符串的構(gòu)造程序。這樣以來(lái)，如果沒(méi)有 XML文本被顯示的話(huà)就會(huì)創(chuàng)建默認(rèn) XTree對(duì)象，而如果 XML文本被顯示的話(huà)將創(chuàng)建一個(gè)唯一的 XTree對(duì)象。代碼段2中給出了兩個(gè)構(gòu)造程序。 代碼段2： public XTree( String text ) throws ParserConfigurationException { this(); refresh( text ); } public XTree() throws ParserConfigurationException { super(); getSelectionModel().setSelectionMode( TreeSelectionModel.SINGLE_TREE_SELECTION ); setShowsRootHandles( true ); setEditable( false ); dbf = DocumentBuilderFactory.newInstance(); dbf.setValidating( false ); db = dbf.newDocumentBuilder(); setModel( buildWelcomeTree() ); } 三、創(chuàng)建 XmlEditor類(lèi) XmlEditor類(lèi)與前面的那篇文章的XTreeTester類(lèi)有相同的用途，不同之處在于 XmlEditor包括一個(gè) JTextArea，允許你操作文本版XML。之后，你可以點(diǎn)擊 “Refresh”按鈕并查看 XTree組件中反映出來(lái)的變化。 如果直接修改第一篇文章中的代碼，你就能節(jié)省很多時(shí)間，你可以把 XTreeTester.java文件重命名為 XmlEditor.java (不過(guò)一定要修改構(gòu)造程序 )并把它當(dāng)成模板文件。 要做的第一件事是添加下列 Swing組件：另一個(gè) JScrollPane、 JSplitPane、 JTextArea和 JButton。通過(guò)聲明所有的這些組件以及其他組件開(kāi)始（看代碼段3）。 代碼段3： private XTree xTree; private JScrollPane jScroll, jScrollRt; private JSplitPane splitPane; private JButton refreshButton; private WindowListener winClosing; 首先，我們將創(chuàng)建并添加“ Refresh”按鈕。這個(gè)按鈕用來(lái)指示這個(gè) XTree組件將使用當(dāng)前 XML文本來(lái)刷新。我們還需要使用一個(gè)ActionListener來(lái)注冊(cè)它。(參見(jiàn)代碼段 4 ) 為了攔截按鈕事件，我們需要有這個(gè)類(lèi)還要實(shí)現(xiàn) ActionListener，而且我們還需要?jiǎng)?chuàng)建一個(gè) actionPerformed()方法 (參見(jiàn)代碼段 5 )。 代碼段4： refreshButton = new JButton( \"Refresh\" ); refreshButton.setBorder( BorderFactory.createRaisedBevelBorder() ); refreshButton.addActionListener( this ); getContentPane().add( refreshButton, BorderLayout.NORTH ); 代碼段5： public void actionPerformed( ActionEvent ae ) { if ( ae.getActionCommand().equals( \"Refresh\" ) ) xTree.refresh( textArea.getText() ); } 接下來(lái)，我們將創(chuàng)建新的 JScrollPane和 JTextArea并且把 JTextArea添加到 JScrollPane中。這樣，我們將得到包含 XTree組件的原始的 JScrollPane和包含 JTextArea組件的新的 JScrollPane。這個(gè)原始的 XTree構(gòu)造程序還有一個(gè)修改之處。我們將刪除先前傳進(jìn)這個(gè)方法的字符串參數(shù)。（該功能通過(guò)我們接下來(lái)要構(gòu)建的另一個(gè) XmlEditor()構(gòu)造程序操作）我們把這兩個(gè)方框放進(jìn)一個(gè) JSplitPane中，它是一個(gè)有分隔器的組件，可以在這個(gè)分隔器的另一邊包含一個(gè)組件。(參見(jiàn)代碼段6)。 代碼段6： jScroll = new JScrollPane(); jScrollRt = new JScrollPane(); textArea = new JTextArea( 200,150 ); jScrollRt.getViewport().add( textArea ); xTree = new XTree(); xTree.getSelectionModel().setSelectionMode( TreeSelectionModel.SINGLE_TREE_SELECTION ); xTree.setShowsRootHandles( true ); xTree.setEditable( false ); jScroll.getViewport().add( xTree ); splitPane = new JSplitPane( JSplitPane.HORIZONTAL_SPLIT, jScroll, jScrollRt ); splitPane.setOneTouchExpandable(true); splitPane.setDividerLocation(200); minimumSize = new Dimension(200, 150); jScroll.setMinimumSize( minimumSize ); jScrollRt.setMinimumSize( minimumSize ); splitPane.setPreferredSize( new Dimension(400, 300) ); getContentPane().add( splitPane, BorderLayout.CENTER ); 現(xiàn)在我們需要修改這個(gè)構(gòu)造程序來(lái)處理這個(gè)非 XML文件的情景。刪除當(dāng)前構(gòu)造程序需要的第二個(gè)字符串參數(shù)。這個(gè)構(gòu)造程序現(xiàn)在就是默認(rèn)的構(gòu)造程序。我們將創(chuàng)建一個(gè)新的構(gòu)造程序來(lái)接收一個(gè)字符串參數(shù)。它將先調(diào)用默認(rèn)構(gòu)造程序，然后處理這個(gè)參數(shù)。(參見(jiàn)代碼段7 )而且，main()方法必須被修改以便在沒(méi)有XML文件的事件中，仍然能創(chuàng)建一個(gè)默認(rèn)的XmlEditor對(duì)象。(參見(jiàn)代碼段8) 代碼段7： public XmlEditor( String title, ArrayList xmlText ) throws ParserConfigurationException { this( title ); textArea.setText( ( String )xmlText.get( 0 ) + \"\n\" ); for ( int i = 1; i < xmlText.size(); i++ ) textArea.append( ( String )xmlText.get( i ) + \"\n\" ); xTree.refresh( textArea.getText() ); } 代碼段8： public static void main( String[] args ) { String fileName = \"\"; BufferedReader reader; String line; ArrayList xmlText = null; XmlEditor xmlEditor; try { if( args.length > 0 ) { fileName = args[0]; if ( fileName.substring( fileName.indexOf( \‘.\‘ ) ).equals( \".xml\" ) ) { reader = new BufferedReader( new FileReader( fileName ) ); xmlText = new ArrayList(); while ( ( line = reader.readLine() ) != null ) { xmlText.add( line ); } reader.close(); xmlEditor = new XmlEditor( \"XmlEditor 1.0\", xmlText ); } else { help(); } } else { xmlEditor = new XmlEditor( \"XmlEditor 1.0\" ); } } catch( FileNotFoundException fnfEx ) { System.out.println( fileName + \" was not found.\" ); exit(); } catch( Exception ex ) { ex.printStackTrace(); exit(); } } 為了很容易地處理 JTextArea數(shù)據(jù)，還需要最后一次必要的修改。一般我們不把這段文本當(dāng)成一個(gè)長(zhǎng)的字符串，而是把它當(dāng)成一系列字符串，每行表示一個(gè)包含在數(shù)組列表中的字符串。這需要修改我們的構(gòu)造程序接收的參數(shù)，并且修改在先前把這個(gè)數(shù)據(jù)作為一個(gè)字符串傳入的那個(gè)main()方法中的任何調(diào)用。這還需要導(dǎo)入 java.util包 (參見(jiàn)代碼段8 ) 。 測(cè)試這個(gè)應(yīng)用程序 最后，我們必須添加一些異常處理到 XTree類(lèi)中。如果你運(yùn)行這個(gè)應(yīng)用程序并輸入無(wú)效的XML數(shù)據(jù)到 JTextArea中，這個(gè)程序就會(huì)崩潰。我們當(dāng)然不想這樣的事情發(fā)生。目前，我們把出錯(cuò)信息打印到命令行中。在下一篇文章中，我們將在一個(gè)圖形對(duì)話(huà)框中顯示出錯(cuò)信息。 如果無(wú)效的或格式不好的 XML數(shù)據(jù)被輸入 JTextArea然后按“Refresh”按鈕，然后解析器將拋出一個(gè)錯(cuò)誤，在本例中，parseXML()方法中包含的當(dāng)前異常處理將立即退出。我們想要這個(gè)程序報(bào)告這個(gè)錯(cuò)誤并返回一個(gè)空值來(lái)指出這個(gè)解析是不成功的。（見(jiàn)代碼段9）你可能注意到 XTree類(lèi)中的“buildTree()”和“refresh()”這兩個(gè)方法有一個(gè)條件語(yǔ)句以避免處理空值。這是因?yàn)槿绻鼈冊(cè)囍ヌ幚硪粋€(gè)空值它們也會(huì)報(bào)告異常。這個(gè)事件鏈保持程序流進(jìn)行并且保持 XTree模型穩(wěn)定。 |
|
|
