最近在学习webservice时,发现很多框架,技术都在使用StAX作为底层XML解析工具,于是今天看了看资料,简单学习了下,在这里做个总结。
简介
StAX,全称
Streaming API for XML,一种全新的,基于流的JAVA XML解析标准类库。其最终版本于 2004 年 3 月发布,并成为了 JAXP 1.4(将包含在即将发布的 Java 6 中)的一部分。在某种程度上来说,StAX与SAX一样是基于XML事件的解析方式,它们都不会一次性加载整个XML文件。但是它们之间也有很大的不同。
与SAX相比
虽然StAX与SAX一样基于XML事件解析,相比于DOM将整个XML加载进内存来说效率高。不同的是,StAX在在处理XML事件的方式上使得应用程序更接近底层,所以在效率上比SAX更优秀。
使用SAX时,我们知道XML事件是由解析器调用开发人员编写的回调方法来处理的,也就是说应用程序是被动于解析器的。应用程序只能被动的等待解析器将XML事件推送给自己处理,对于每一种事件都需要在解析开始之前就做好准备。这种方式被称为‘推(push)‘。
而StAX正好相反,
StAX采用一种‘拉(pull)‘的方式,由应用程序主动从解析器中获取当前XML事件然后更具需求处理(保存或者忽略)。StAX使得应用程序掌握了主动权,可以简化调用代码来准确地处理它预期的内容,或者发生意外时停止解析。此外,由于该方法不基于处理程序回调,应用程序不需要像使用 SAX 那样模拟解析器的状态。
StAX的应用
以下是StAX的应用场景,来自:http://docs.oracle.com/cd/E17802_01/webservices/webservices/docs/1.6/tutorial/doc/index.html
Data binding
- Unmarshalling an XML document
- Marshalling an XML document
- Parallel document processing
- Wireless communication
SOAP message processing
使用 IteratorAPI 读XML文件:
- Parsing simple predictable structures
- Parsing graph representations with forward references
- Parsing WSDL
Virtual data sources
- Viewing as XML data stored in databases
- Viewing data in Java objects created by XML data binding
- Navigating a DOM tree as a stream of events
简单使用
获取解析器工厂
与其他解析技术一样,在使用StAX解析器之前也需要获取其工厂类。
import java.io.InputStream; import java.io.OutputStream; import javax.xml.stream.XMLInputFactory; import javax.xml.stream.XMLOutputFactory; public class StAX_Frist { public void writeXMlByStream(OutputStream out){ XMLOutputFactory outFactor=XMLOutputFactory.newInstance();//写解析器工厂 ....... } public void readXmlByStream(InputStream in){ XMLInputFactory inFactory=XMLInputFactory.newInstance();//读解析器工厂 ....... }
主要API
StAX 实际上包括两套处理 XML 的 API,分别提供了不同程度的抽象。基于指针(Cursor)的 API 允许应用程序把 XML 作为一个标记(或事件)流来处理。在这里,解析器就像一跟指针一样在文件流上前进,应用程序可以跟随解析器从文件的开头一直处理到结尾。这是一种低层 API,尽管效率高,但是没有提供底层 XML 结构的抽象。Cursor API 由两个主要API组成,XMLStreamReader和XMLStreamWriter,分别由XMLInputStreamFactory和XMLOutputStreamFactory获取。
使用Cursor API 读XML文件:
import java.io.InputStream; import javax.xml.stream.XMLInputFactory;; import javax.xml.stream.XMLStreamConstants; import javax.xml.stream.XMLStreamReader; public class StAX_Frist { public void readXmlByStream(InputStream in){ XMLInputFactory inFactory=XMLInputFactory.newInstance();//读解析器工厂 try { XMLStreamReader reader=inFactory.createXMLStreamReader(in);//获取读解析器 while(reader.hasNext()){//reader.hasNext();说明文件未到结尾。 int eventId=reader.next(); switch (eventId) { case XMLStreamConstants.START_DOCUMENT: System.out.println("start docmuent"); break; case XMLStreamConstants.START_ELEMENT: System.out.println("<"+reader.getLocalName()+">"); for(int i=0;i<reader.getAttributeCount();i++){ System.out.println(reader.getAttributeLocalName(i)+"="+reader.getAttributeValue(i)); } break; case XMLStreamConstants.CHARACTERS: if(reader.isWhiteSpace()){ break; } System.out.println(reader.getText()); break; case XMLStreamConstants.END_ELEMENT: System.out.println("</"+reader.getLocalName()+">"); break; case XMLStreamConstants.END_DOCUMENT: System.out.println("end docmuent"); break; default: break; } } } catch (Exception e) { e.printStackTrace(); } }另外一种是较为高级的基于迭代器(Iterator)的 API ,它允许应用程序把 XML 作为一系列事件对象来处理,每个对象和应用程序交换 XML 结构的一部分。应用程序只需要确定解析事件的类型,将其转换成对应的具体类型,然后利用其方法获得属于该事件的信息。基于事件迭代器的方法具有一个基于指针的方法不具备的重要优点。通过将解析器事件变成一级对象,从而让应用程序可以采用面向对象的方式处理它们。这样做有助于模块化和不同应用程序组件之间的代码重用。IteratorAPI 由两个主要API组成,XMLEventReader和XMLEventWriter,分别由XMLInputStreamFactory和XMLOutputStreamFactory获取。
使用 IteratorAPI 读XML文件:
import java.io.InputStream; import java.util.Iterator; import javax.xml.stream.XMLEventReader; import javax.xml.stream.XMLInputFactory; import javax.xml.stream.XMLStreamConstants; import javax.xml.stream.events.Attribute; import javax.xml.stream.events.Characters; import javax.xml.stream.events.StartElement; import javax.xml.stream.events.XMLEvent; public class StAX_Frist { public void readXmlByEvent(InputStream in){ XMLInputFactory factory=XMLInputFactory.newInstance();//获取解析器工厂 try { XMLEventReader reader=factory.createXMLEventReader(in);//获取解析器 while(reader.hasNext()){ XMLEvent event=reader.nextEvent(); switch (event.getEventType()) { case XMLStreamConstants.START_DOCUMENT: System.out.println("start docmuent"); break; case XMLStreamConstants.START_ELEMENT: StartElement element=(StartElement)event; System.out.println("<"+element.getName().getLocalPart()+">"); for(Iterator it=element.getAttributes();it.hasNext();){ Attribute attr=(Attribute) it.next(); System.out.println(attr.getName().getLocalPart()+"="+attr.getValue()); } break; case XMLStreamConstants.CHARACTERS: Characters charData=(Characters)event; if(charData.isIgnorableWhiteSpace()&&charData.isWhiteSpace()){ break; } System.out.println(charData.getData()); break; case XMLStreamConstants.END_ELEMENT: element=(StartElement)event; System.out.println("</"+element.getName().getLocalPart()+">"); break; case XMLStreamConstants.END_DOCUMENT: System.out.println("end docmuent"); break; default: break; } } } catch (Exception e) { e.printStackTrace(); } }