Axis2快速上手指南2

创建服务
在这个部分，我们将看看根据StockQuoteService类创建服务的五种方式:部署Plain Old Java Objects(POJO)，使用AXIOM的OMElement
构建服务，使用Axis2 Databinding Framework(ADB)生成服务，使用XMLBeans生成服务和使用JiBX生成服务。

部署POJOs
使用POJOs(Plain Old Java Objects)来部署服务，执行下面的步骤。
注意包含在<AXIS2_HOME>/samples/quickstart的目录结构(services.xml文件来自于该指南的第一个部分):

- quickstart
    - README.txt
    - build.xml
    - resources
      - META-INF
        - services.xml
    - src
      - samples
        - quickstart
          - service
            - pojo
              - StockQuoteService.java

- quickstart    - README.txt    - build.xml    - resources      - META-INF        - services.xml    - src      - samples        - quickstart          - service            - pojo              - StockQuoteService.java

注意你可以通过在quickstart目录键入ant generate.wsdl来生成WSDL。
尽管如此，创建StockQuoteService.wsdl是可选的。它可以是直接从Java类生成的版本，或者该文件的一个自定义版本，并且servi
ces.xml是本文档前面提到的同一文件。
现在通过在quickstart目录键入ant generate.service来构建工程，该目录创建了以下目录结构:

- quickstart/build/classes
    - META-INF
      - services.xml
    - samples
      - quickstart
        - service
          - pojo
            - StockQuoteService.class

- quickstart/build/classes    - META-INF      - services.xml    - samples      - quickstart        - service          - pojo            - StockQuoteService.class

如果你想以爆发形式部署服务，重命名classes目录为StockQuoteService，并复制它到你的servlet引擎的webapps/axis2/WEB-INF/s
ervices目录。否则，复制build/StockQuoteService.aar文件到你的servlet引擎的webapps/axis2/WEB-INF/services目录。然后通过
视察以下服务列表来确认服务被正确部署:
http://localhost:8080/axis2/services/listServices
你也可以检验以下WSDL:
http://localhost:8080/axis2/services/StockQuoteService?wsdl
以及以下结构:
http://localhost:8080/axis2/services/StockQuoteService?xsd
一旦这些urls工作，让我们快速测试一下服务。让你的浏览器访问以下URL试试:
http://localhost:8080/axis2/rest/StockQuoteService/getPrice?symbol=IBM
你将得到如下应答:

<ns:getPriceResponse xmlns:ns="http://pojo.service.quickstart.samples/xsd"><ns:return>42</ns:return></ns:getPriceResponse>

<ns:getPriceResponse xmlns:ns="http://pojo.service.quickstart.samples/xsd"><ns:return>42</ns:return></ns:getPriceResponse>

如果你像这样调用update方法:
http://localhost:8080/axis2/rest/StockQuoteService/update?symbol=IBM&price=100
然后调用第一个getPrice url。你可以看到price被更新了。

使用AXIOM构建服务
为了使用AXIOM"从零开始"构建一个服务，执行以下步骤。
注意包含在/samples/quickstartaxiom的目录结构:

- quickstartaxiom
    - README.txt
    - build.xml
    - resources
      - META-INF
        - services.xml
        - StockQuoteService.wsdl
    - src
      - samples
        - quickstart
          - service
            - axiom
              - StockQuoteService.java
          - clients
            - AXIOMClient.java

- quickstartaxiom    - README.txt    - build.xml    - resources      - META-INF        - services.xml        - StockQuoteService.wsdl    - src      - samples        - quickstart          - service            - axiom              - StockQuoteService.java          - clients            - AXIOMClient.java

由于AXIOM有一点不同，你将需要一个与POJO所用不同的services.xml文件，在Code Listing 4中显示了它的定义。
Code Listing 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 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文件中，而且MessageReceiver现在是RawXML。
现在，上面提到的简单的使用Axis2库的类的StockQuoteService.java类，在Code Listing 5中定义。
Code Listing 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));
     }
}

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 Object Model，一个基于StAX API(Streaming API for XML)的DOM(Document Object Model)类似的结构
作为服务的方法必须使用OMElement作为它们的参数，OMElement表示一个XML元素，在这里它则为进来的SOAP消息的有效载荷。这里，
你提取有效载荷元素的第一个孩子，添加文本给它，并使用它作为返回的OMElement的内容。除非这是一个"只有in"的服务，这些方法
必须返回一个OMElement，因为它成为返回的SOAP消息的有效载荷。
现在通过在Axis2_HOME/samples/quickstartaxiom目录键入ant generate.service来构建工程。
把StockQuoteService.aar文件放在servlet引擎的webapps/axis2/WEB-INF/services目录，通过视察下面的服务列表来确 ...