竹十一
在匆忙与奔走中堕落

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="http://ot.demo.axiom">YY</y:fool>
 <ns:ele xmlns:ns="http://namespace">ELE</ns:ele>
</x:root>


参考:
AXIOM Tutorial : http://ws.apache.org/commons/axiom/OMTutorial.html

posted on 2006-12-08 21:47 竹十一 阅读(4037) 评论(0)  编辑  收藏 所属分类: SOA

只有注册用户登录后才能发表评论。


网站导航: