四、 使用XMLStreamWriter進行寫操作
首先，你要創建將待分析的XML文檔。由StAX的XMLStreamWriter生成XML。然而，XMLStreamWriter的一個限制是，它不一定會生成良構的文檔-而且生成的文檔也不一定是有效的。你需要確保生成的XML文檔是良構的。列表1是一個由XMLStreamWriter生成的原始XML文檔的示例。
在此，你試圖使用XMLStreamWriter API生成列表1中的catalog.xml。在本節中的代碼片斷節選自XMLWriter.Java應用程序，顯示於列表2中。首先，你將導入StAX包類，請參考下列編碼：
import Javax.XML.stream.*;
import Javax.XML.stream.events.*;
import Javax.xml.stream.XMLOutputFactory;
你要從一個XMLOutputFactory中得到你的XMLStreamWriter。因此，首先你必須創建一個新的XMLOutputFactory：
XMLOutputFactory outputFactory=XMLOutputFactory.newInstance();
接下來，創建一個FileWriter以輸出XML文檔-它將被生成到一個XML文件中：
FileWriter output=new FileWriter(new File("C:/STAX/catalog.XML"));
接下來，創建一個XMLStreamWriter：
XMLStreamWriter XMLStreamWriterr=outputFactory.createXMLStreamWriter(output);
現在，使用writeStartDocument()方法創建一個文檔開頭。添加要在XML聲明中指定的編碼和版本（記住，指定的編碼並不是生成的XML文檔的編碼）。如果你需要指定XML文檔的編碼，該怎麼辦呢？當從一個XMLOutputFactory對象創建一個XMLStreamWriter對象時，你會這樣做：
XMLStreamWriter.writeStartDocument("UTF-8"，"1.0");
使用writeComment()方法以輸出一個注釋：
XMLStreamWriter.writeComment("A OReilly Journal Catalog");
使用writeProcessingInstruction()方法以輸出一條處理指令：
XMLStreamWriter.writeProcessingInstruction("catalog"，"journal='OReilly'");
使用writeStartElement()方法以輸出'catalog'元素的開始（元素前綴和命名空間URI也可以在這個方法中指定的）：
XMLStreamWriter.writeStartElement("journal"，"catalog"，"http://OnJava.com/Journal");
使用writeNamespace()方法以添加'journal'命名空間聲明（命名空間前綴和命名空間URI也是在這個方法中指定的）：
XMLStreamWriter.writeNamespace("journal"，"http://OnJava.com/Journal");
再次使用writeNamespace()方法添加xsi命名空間：
XMLStreamWriter.writeNamespace("xsi"，"http://www.w3.org/2001/XMLSchema-instance");
使用writeAttribute()方法添加xsi:namespaceSchemaLocation屬性：
XMLStreamWriter.writeAttribute("xsi:noNamespaceSchemaLocation"，"file://c:/Schemas/catalog.xsd");
使用writeAttribute()方法添加'publisher'屬性：
XMLStreamWriter.writeAttribute("publisher"，"OReilly");
輸出'journal'元素的開始。當增加一個新元素時，前一個元素的'>'括號也被添加上：
XMLStreamWriter.writeStartElement("journal"，"journal"，"http:
//OnJava.com/Journal");
使用writeAttribute()方法以添加'date'和'title'屬性。然後，使用writeElement()方法以添加'article'和'title'元素。然後，使用writeCharacters()方法輸出'title'元素的文本：
XMLStreamWriter.writeCharacters("Data Binding with XMLBeans");
任何包含文本或子元素的元素都要有一個結束標簽。使用writeEndElement()元素來添加'title'元素的結束標簽：
XMLStreamWriter.writeEndElement();
添加'author'元素和'journal'元素的結束標簽。在writeEndElement()方法中，不必要指定元素前綴和命名空間URI。以類似方式添加另一個'journal'元素。然後，添加'catalog'元素的結束標簽。最後，輸出緩沖的數據：
XMLStreamWriter.flush();
最後一步，關閉XMLStreamWriter。
XMLStreamWriter.close();
這就是生成catalog.XML的過程。
源碼中的列表2展示了完整的Java應用程序-XMLWriter.Java。這個應用程序可以作為一個命令行應用程序運行或在一種例如Eclipse這樣的IDE中運行。
五、 使用XMLStreamReader進行分析
通過使用XMLStreamReader API分析列表1中的文檔，我們來詳細分析一下其工作原理。XMLStreamReader使用一種光標分析XML文檔。它的接口包含一個next()方法-由它分析下一個分析事件。getEventType()方法返回事件類型。後面的代碼片斷來自於XMLParser.Java應用程序，詳見列表3。
在這個XMLParser.Java應用程序中，首先，你要導入StAX類：
import Javax.XML.stream.*;
import Javax.XML.stream.events.*;
import Javax.xml.stream.XMLInputFactory;
然後，創建一個XMLInputFactory，由此你會得到一個XMLStreamReader：
XMLInputFactory inputFactory=XMLInputFactory.newInstance();
現在，你需要創建一個InputStream，作為一個輸入流，它描述了將被分析的文件。另外，還要從前面創建的XMLInputFactory對象中創建一個XMLStreamReader。
InputStream input=new FileInputStream(new File("C:/STAX/catalog.XML"));
XMLStreamReader xmlStreamReader =inputFactory.createXMLStreamReader(input);
如果更多分析事件可用，hasNext()方法返回true。然後，使用next()方法獲得下一個分析事件：
int event=XMLStreamReader.next();
比較於SAX分析，StAX分析的優點是，一個分析事件可以被跳過-通過調用next()方法，詳見下面的代碼。例如，如果分析事件類型為ENTITY_DECLARATION，那麼開發者可以決定是要從當前事件中獲得事件信息，還是檢索下一個事件：
If(event.getEventType()==XMLStreamConstants.ENTITY_DECLARATION){
int event=XMLStreamReader.next();
}
通過不調用next()方法，分析也可以被推遲。next()方法返回int，它代表了一個分析事件-通過使用一個XMLStreamConstants常量指定。
XMLStreamReader所返回的不同的事件類型列舉於表格１中。
事件類型 描述START_DOCUMENT 一個文檔的開始START_ELEMENT一個元素的開始ATTRIBUTE一個元素屬性NAMESPACE一個命名空間聲明CHARACTERS字符可以是文本，或是一個空格COMMENT一個注釋SPACE可忽略的空格PROCESSING_INSTRUCTION處理指令DTD一個DTDENTITY_REFERENCE一個實體參考CDATACdata節END_ELEMENT結束元素END_DOCUMENT結束文檔ENTITY_DECLARATION一個實體聲明NOTATION_DECLARATION一個標志聲明
表格1.XMLStreamReader事件
這些不同的分析事件能夠使你獲得XML文檔中的數據和元數據。如果分析事件類型是START_DOCUMENT，那麼你將使用getEncoding()方法獲得XML文檔中的指定編碼，而你將使用getVersion()方法返回XML文檔的XML版本。
同樣，如果你在使用一個START_ELEMENT事件類型工作，那麼你將使用getPrefix()方法來返回元素前綴並且使用getNamespaceURI來返回元素前綴命名空間或默認命名空間。為了獲得元素的本地命名，你將使用getLocalName()方法並且使用getAttributesCount()方法獲得屬性數目。你將使用getAttributePrefix(i)方法得到一個指定的屬性索引i的屬性前綴，而使用getAttributeNamespace(i)方法取得屬性命名空間。使用getAttributeLocalName(i)方法獲得屬性本地命名，使用getAttributeValue(i)方法獲得屬性值。如果事件類型是CHARACTERS或COMMENT，則使用getText()方法獲得相應的文本。
列表4顯示了示例XML文檔，catalog.XML，的分析輸出結果。
列表3顯示了用於分析XML文檔的Java應用程序。你可以從命令行上或在一種例如Eclipse這樣的IDE中來運行該應用程序。記住：如果你沒有首先運行XMLWriter.java應用程序而運行XMLParser.Java(見源碼中的列表2)，那麼你需要把catalog.XML(見源碼中的列表1)復制到C:/StAX目錄下。
六、 使用XMLEventReader進行分析
本節將向你展示如何使用XMLEventReader來分析catalog.xml。XMLEventReader接口使用一個事件對象迭代算子分析一個XML文檔；通過這種方式，一個XML事件生成一個XMLEvent對象。XMLEventReader類似於XMLStreamReader-分析事件是由StAX分析器生成的。然而，XMLEventReader比XMLStreamReader有一個優點：通過使用XMLEventReader，一個應用程序可以使用peek()方法來"偷看"下一個事件，而不必從流中讀取事件。這樣，一個應用程序客戶端可以決定是否有必要分析下一個事件。本節中的代碼片斷節選自XMLEventParser.Java應用程序，請參見列表5。
首先，導入StAX類：
import Javax.XML.stream.*;
import Javax.XML.stream.events.*;
import Javax.xml.stream.XMLInputFactory;
接下來，創建一個XMLInputFactory，由它獲得一個XMLEventReader對象：
XMLInputFactory inputFactory=XMLInputFactory.newInstance();
InputStream input=new FileInputStream(new File("C:/STAX/catalog.XML"));
XMLEventReader xmlEventReader =inputFactory.createXMLEventReader(input);
在StAX中，XML文檔事件是通過XMLEvent對象描述的。使用nextEvent()方法來遍歷XMLEventReader對象以獲得下一個事件：
XMLEvent event=XMLEventReader.nextEvent();
使用getEventType()方法來獲得事件類型(請參考表格１)。XMLEvent接口還提供布爾方法來獲得事件類型。例如，isStartDocument()返回true，如果事件是開始文檔類型。在下列代碼中，事件是開始元素類型，因此一個StartElement對象可以從這個XMLEvent接口獲得：
if(event.isStartElement()){
StartElement startElement=event.asStartElement();
}
使用getAttributes()方法獲得元素屬性：
Iterator attributes=startElement.getAttributes();
這個Iterator描述了一個Javax.XML.stream.events.Attribute對象。使用next()方法遍歷該Iterator。
Attribute attribute=(Javax.XML.stream.events.Attribute)(attributes.next());
最後，使用getName()方法獲得屬性命名，使用getValue()方法獲得屬性值。
列表5顯示出分析該XML文檔的Java應用程序。應用程序XMLEventReader可以作為一個命令行應用程序運行，或在一種例如Eclipse這樣的IDE中運行。記住：如果你運行XMLWriter.java或XMLParser.java應用程序而不首先運行XMLEventParser.Java應用程序，那麼你將需要把catalog.XML復制到C:/StAX目錄下。
最終，基於拉的事件生成把事件規則提供到分析器應用程序而不是提供到分析器。