2.2 Apache Axis2 快速学习手册之 AXIOM 构建 Web Service

时间：2023-12-01 20:08:26

和上一篇的POJO 部署相比主要是services.xml 中配置的消息接受处理器类不一样和Java 类中写法不一样。

使用AXIOM构建服务

样例源码路径: C:\Apps\axis2\axis2-1.7.9\samples\quickstartaxiom

请注意/ samples / quickstartaxiom中包含的目录结构：

- quickstartaxiom

   - README.txt

   - build.xml

   - resources

     - META-INF

       - services.xml

       - StockQuoteService.wsdl

   - src

     - samples

       - quickstart

         - service

           - axiom

             - StockQuoteService.java

         - clients

           - AXIOMClient.java

由于AXIOM略有不同，因此您需要一个与POJO不同的service.xml文件。定义它，如代码清单4所示。

代码4：服务定义文件。

<service name="StockQuoteService" scope="application">

    <description>

        Stock Quote Service

    </description>

    <operation name="getPrice">

        <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>

    </operation>

    <operation name="update">

        <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>

    </operation>

    <parameter name="ServiceClass">samples.quickstart.service.axiom.StockQuoteService</parameter>

</service>

请注意，它几乎相同，只是在service.xml文件中显式定义了操作，MessageReceivers现在是RawXML。

现在，上面引用的StockQuoteService.java类是一个使用Axis2库中的类的普通Java类，其定义如代码清单5所示。

代码5：使用AXIOM的StockQuoteService类

package samples.quickstart.service.axiom;

import javax.xml.stream.XMLStreamException;

import org.apache.axiom.om.OMAbstractFactory;

import org.apache.axiom.om.OMElement;

import org.apache.axiom.om.OMFactory;

import org.apache.axiom.om.OMNamespace;

import java.util.HashMap;

public class StockQuoteService {

    private HashMap map = new HashMap();

    public OMElement getPrice(OMElement element) throws XMLStreamException {

        element.build();

        element.detach();

        OMElement symbolElement = element.getFirstElement();

        String symbol = symbolElement.getText();

        String returnText = "42";

        Double price = (Double) map.get(symbol);

        if(price != null){

            returnText  = "" + price.doubleValue();

        }

        OMFactory fac = OMAbstractFactory.getOMFactory();

        OMNamespace omNs =

            fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");

        OMElement method = fac.createOMElement("getPriceResponse", omNs);

        OMElement value = fac.createOMElement("price", omNs);

        value.addChild(fac.createOMText(value, returnText));

        method.addChild(value);

        return method;

    }

    public void update(OMElement element) throws XMLStreamException {

        element.build();

        element.detach();

        OMElement symbolElement = element.getFirstElement();

        String symbol = symbolElement.getText();

        OMElement priceElement = (OMElement)symbolElement.getNextOMSibling();

        String price = priceElement.getText();

        map.put(symbol, new Double(price));

    }

}

Axis2使用AXIOM，或AXIs对象模型，类似于DOM（文档对象模型）的结构，它基于StAX API（用于XML的Streaming API）。充当服务的方法必须将OMElement作为其参数，OMElement表示在这种情况下发生的XML元素是传入SOAP消息的有效负载。例如，方法getPrice（OMElement）提取有效负载元素的第一个子元素的内容，该元素对应于股票代码，并使用它来查找股票的当前价格。除非这是“仅在”服务，否则这些方法必须返回OMElement，因为它成为返回SOAP消息的有效负载。

现在通过在Axis2_HOME / samples / quickstartaxiom目录中键入ant generate.service来构建项目。

将StockQuoteService.aar文件放在servlet引擎的webapps / axis2 / WEB-INF / services目录中，并通过查看服务列表来检查是否已正确部署该服务，

http://localhost:8080/axis2/services/listServices

您还可以在以下位置检查自定义WSDL：

http://localhost:8080/axis2/services/StockQuoteService?wsdl

the schema

http://localhost:8080/axis2/services/StockQuoteService?xsd

相关文章