Axiom简述－－Axis2 的XML处理器

Axiom简述－－Axis2 的XML处理器

Axis2用Axiom，也就是Axis Object Model，处理SOAP文档。

Axiom采用pull解析方式，基于StAX（JSR173）。

Pull解析是最近处理XML的一种趋势。而SAX和DOM都是基于push的解析方式，也就是说解析控制在parser本身。Push解析方式很容易使用，但在处理巨型XML文档时效率并不好，（因为要在内存中生成完成的对象模型）。Pull解析方式颠倒了这种控制方式，增强了parser，只在用户需要的时候菜进行处理。用户决定处理或者忽略parser生成的事件。

Axiom和StAX紧密相关，要使用Axiom，StAX相关的jar包也必须在classpath下。

Axiom的一些特性：
1、Lightweight（轻量），更少的内存需要。
2、Deferred building（延迟构建），可以说是最重要的OM特性，
3、Pull based（pull模式），OM基于StAX－－标准的pull parser API。


Axiom读XML：

// 首先构建parser，
XMLStreamReader parser = XMLInputFactory.newInstance().createXMLStreamReader(
new FileInputStream("5.xml"));
// 还需要builder对象，
StAXOMBuilder builder = new StAXOMBuilder(parser);
// get the root element
// OMElement documentElement = builder.getDocumentElement();
OMDocument doc = builder.getDocument();

OMElement cre = doc.getOMDocumentElement().getFirstChildWithName(new QName("fool"));

// OMElement有一系列的get方法来获得内容。

cre.serialize(System.out); // cache on
cre.serializeAndConsume(System.out); // cache off

// will NOT build the OMTree in the memory.
// So you are at your own risk of losing information.
String creStr = cre.toStringWithConsume();
// call toString, will build the OMTree in the memory.
System.out.println(cre);

Axiom写XML：

// 可以构建writer做输出器，
XMLStreamWriter writer = XMLOutputFactory.newInstance().createXMLStreamWriter(
new FileOutputStream("2.xml"));

// 通常通过OMFactory来构造XML文档中的element，下面是一些示例代码。
OMFactory factory = OMAbstractFactory.getOMFactory();
OMDocument doc = factory.createOMDocument();

OMNamespace ns = factory.createOMNamespace("http://demo.axiom","x");
OMNamespace ns1 = factory.createOMNamespace("http://ot.demo.axiom","y");

OMElement root = factory.createOMElement("root",ns);

OMElement elt11 = factory.createOMElement("fool",ns1);
elt11.addChild(factory.createOMText("YY"));

OMElement ele = factory.createOMElement("ele", "http://namespace", "ns");
ele.addChild(factory.createOMText("ELE"));

root.addAttribute(factory.createOMAttribute("attr", ns, "test attr"));
root.addChild(elt11);
root.addChild(ele);

doc.addChild(root);
root.serialize(writer); // cache on
writer.flush();

doc.serializeAndConsume(new FileOutputStream("3.xml"));
OMOutputFormat oof = new OMOutputFormat();
doc.serializeAndConsume(new FileOutputStream("5.xml"), oof); // cache off
// ele.detach();
ele.serialize(System.out); // 即使detach()，依然会输出ele
doc.serialize(System.out); // 如果detach()，就不会有ele到document里。


关于serialize和serializeAndConsume，前者会强制构建OMTree，或者则不会。
关于detach，它只影响OMElement本身和OMTree的关系，并不影响OMElement本身。
与之对应的还有一个build方法，build会强制build整个OMTree出来。
这两个方法通常用在处理OMElement与OMTree的关系上。从输入流构建出OMElement(build)以及把OMElement从输入流断开(detach)，以便放到输出流。输入流和输出流是不同的OMTree。


测试用的XML文档（5.xml），

<?xml version=‘1.0‘ encoding=‘utf-8‘?>
<x:root xmlns:x="http://demo.axiom" x:attr="test attr">
<y:fool xmlns:y="yyhttp://ot.demo.axiom">YY</y:fool>
<ns:ele xmlns:ns="elehttp://namespace">ELE</ns:ele>
</x:root>