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文件来自于该指南的第一个部分):
Java代码 复制代码
  1. - quickstart  
  2.     - README.txt  
  3.     - build.xml  
  4.     - resources  
  5.       - META-INF  
  6.         - services.xml  
  7.     - src  
  8.       - samples  
  9.         - quickstart  
  10.           - service  
  11.             - pojo  
  12.               - StockQuoteService.java  

注意你可以通过在quickstart目录键入 ant generate.wsdl来生成WSDL。
尽管如此,创建StockQuoteService.wsdl是可选的。它可以是直接从Java类生成的版本,或者该文件的一个自定义版本,并且servi
ces.xml是本文档前面提到的同一文件。
现在通过在quickstart目录键入 ant generate.service来构建工程,该目录创建了以下目录结构:
Java代码 复制代码
  1. - quickstart/build/classes  
  2.     - META-INF  
  3.       - services.xml  
  4.     - samples  
  5.       - quickstart  
  6.         - service  
  7.           - pojo  
  8.             - 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
你将得到如下应答:
Java代码 复制代码
  1. <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的目录结构:
Java代码 复制代码
  1. - quickstartaxiom  
  2.     - README.txt  
  3.     - build.xml  
  4.     - resources  
  5.       - META-INF  
  6.         - services.xml  
  7.         - StockQuoteService.wsdl  
  8.     - src  
  9.       - samples  
  10.         - quickstart  
  11.           - service  
  12.             - axiom  
  13.               - StockQuoteService.java  
  14.           - clients  
  15.             - AXIOMClient.java  

由于AXIOM有一点不同,你将需要一个与POJO所用不同的services.xml文件,在Code Listing 4中显示了它的定义。
Code Listing 4: 服务定义文件
Java代码 复制代码
  1. <service name="StockQuoteService" scope="application">  
  2.      <description>  
  3.          Stock Quote Service  
  4.      </description>  
  5.      <operation name="getPrice">  
  6.          <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>  
  7.      </operation>  
  8.      <operation name="update">  
  9.          <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>  
  10.      </operation>  
  11.      <parameter name="ServiceClass">samples.quickstart.service.axiom.StockQuoteService</parameter>  
  12. </service>  

注意,几乎是一样的,除了操作是显示地定义在service.xml文件中,而且MessageReceiver现在是RawXML。
现在,上面提到的简单的使用 Axis2库的类的StockQuoteService.java类,在Code Listing 5中定义。
Code Listing 5:使用AXIOM的StockQuoteService类
Java代码 复制代码
  1. package samples.quickstart.service.axiom;  
  2.   
  3. import javax.xml.stream.XMLStreamException;  
  4. import org.apache.axiom.om.OMAbstractFactory;  
  5. import org.apache.axiom.om.OMElement;  
  6. import org.apache.axiom.om.OMFactory;  
  7. import org.apache.axiom.om.OMNamespace;  
  8.   
  9. import java.util.HashMap;  
  10. public class StockQuoteService {  
  11.     private HashMap map = new HashMap();  
  12.   
  13.     public OMElement getPrice(OMElement element) throws XMLStreamException {  
  14.          element.build();  
  15.          element.detach();  
  16.   
  17.          OMElement symbolElement = element.getFirstElement();  
  18.          String symbol = symbolElement.getText();  
  19.   
  20.          String returnText = "42";  
  21.          Double price = (Double) map.get(symbol);  
  22.         if(price != null){  
  23.              returnText   = "" + price.doubleValue();  
  24.          }  
  25.          OMFactory fac = OMAbstractFactory.getOMFactory();  
  26.          OMNamespace omNs =  
  27.              fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");  
  28.          OMElement method = fac.createOMElement("getPriceResponse", omNs);  
  29.          OMElement value = fac.createOMElement("price", omNs);  
  30.          value.addChild(fac.createOMText(value, returnText));  
  31.          method.addChild(value);  
  32.         return method;  
  33.      }  
  34.   
  35.     public void update(OMElement element) throws XMLStreamException {  
  36.          element.build();  
  37.          element.detach();  
  38.   
  39.          OMElement symbolElement = element.getFirstElement();  
  40.          String symbol = symbolElement.getText();  
  41.   
  42.          OMElement priceElement = (OMElement)symbolElement.getNextOMSibling();  
  43.          String price = priceElement.getText();  
  44.   
  45.          map.put(symbol, new Double(price));  
  46.      }  
  47. }  

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目录,通过视察下面的服务列表来确 ...

你可能感兴趣的:(java,apache,xml,ant,REST)