Axis2快速上手指南(2)

创建客户端
在这个部分，我们将看看基于StockQuoteService类创建客户端的四种方式:构建基于AXIOM的客户端，使用Axis2 Databinding Frame
work(ADB)生成客户端，使用XMLBeans生成客户端，使用JiBX生成客户端。

使用AXIOM创建一个客户端
执行以下步骤来使用AXIOM构建一个客户端。
也注意在使用AXIOM创建服务部分显示的目录结构，为了完整性下面的重复了。

代码

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   

<script>render_code();</script>
上面提到的AXIOMClient.java类的定义显示在下面的Code Listing 9。
Code Listing 9:使用AXIOM的AXIOMClient类

代码

1. package samples.quickstart.clients;   
2.   
3. import org.apache.axiom.om.OMAbstractFactory;   
4. import org.apache.axiom.om.OMElement;   
5. import org.apache.axiom.om.OMFactory;   
6. import org.apache.axiom.om.OMNamespace;   
7. import org.apache.axis2.Constants;   
8. import org.apache.axis2.addressing.EndpointReference;   
9. import org.apache.axis2.client.Options;   
10. import org.apache.axis2.client.ServiceClient;   
11.   
12. public class AXIOMClient {   
13.   
14.     private static EndpointReference targetEPR =    
15.         new EndpointReference("http://localhost:8080/axis2/services/StockQuoteService");   
16.   
17.     public static OMElement getPricePayload(String symbol) {   
18.         OMFactory fac = OMAbstractFactory.getOMFactory();   
19.         OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");   
20.   
21.         OMElement method = fac.createOMElement("getPrice", omNs);   
22.         OMElement value = fac.createOMElement("symbol", omNs);   
23.         value.addChild(fac.createOMText(value, symbol));   
24.         method.addChild(value);   
25.         return method;   
26.     }   
27.   
28.     public static OMElement updatePayload(String symbol, double price) {   
29.         OMFactory fac = OMAbstractFactory.getOMFactory();   
30.         OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");   
31.   
32.         OMElement method = fac.createOMElement("update", omNs);   
33.   
34.         OMElement value1 = fac.createOMElement("symbol", omNs);   
35.         value1.addChild(fac.createOMText(value1, symbol));   
36.         method.addChild(value1);   
37.   
38.         OMElement value2 = fac.createOMElement("price", omNs);   
39.         value2.addChild(fac.createOMText(value2,   
40.                                          Double.toString(price)));   
41.         method.addChild(value2);   
42.         return method;   
43.     }   
44.   
45.     public static void main(String[] args) {   
46.         try {   
47.             OMElement getPricePayload = getPricePayload("WSO");   
48.             OMElement updatePayload = updatePayload("WSO", 123.42);   
49.             Options options = new Options();   
50.             options.setTo(targetEPR);   
51.             options.setTransportInProtocol(Constants.TRANSPORT_HTTP);   
52.   
53.             ServiceClient sender = new ServiceClient();   
54.             sender.setOptions(options);   
55.   
56.             sender.fireAndForget(updatePayload);   
57.             System.err.println("done");   
58.             OMElement result = sender.sendReceive(getPricePayload);   
59.   
60.             String response = result.getFirstElement().getText();   
61.             System.err.println("Current price of WSO: " + response);   
62.   
63.         } catch (Exception e) {   
64.             e.printStackTrace();   
65.         }   
66.     }   
67.        
68. }   

<script>render_code();</script>
Axis2使用AXIOM，或者AXIs Object Model，一个基于StAX API(Streaming API for XML)的DOM(Document Object Model)类似的结构
这里你为服务的update和getPrice方法建立有效载荷。有效载荷的创建类似于你为AXIOM服务创建getPriceResponse有效载荷。然后
你创建Options类，并创建用来与服务交流的ServiceClient。首先你调用update方法，一个什么也不返回的fireAndForget方法。最后
你调用getPrice方法，并从服务得到当前价格并显示它。
现在你可以通过在Axis2_HOME/samples/quickstartaxiom目录键入 ant run.client构建并运行AXIOM客户端。
你应该得到以下输出:

代码

1. done   
2. Current price of WSO: 123.42  

<script>render_code();</script>

 

使用ADB生成一个客户端
执行以下步骤来使用Axis Data Binding(ADB)构建一个客户端。
通过在Axis2_HOME/samples/quickstartadb目录键入以下命令来生成客户端数据绑定:
%AXIS2_HOME%/bin/WSDL2Java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.clients -d adb -s
-o build/client
或者在Axis2_HOME/samples/quickstartadb目录简单的键入ant generate.client。
下一步看看quickstartadb/src/samples/quickstart/clients/ADBClient.java，并看看它在Code Listing 10中是怎样定义的。
Code Listing 10:ADBClient类

代码

1. package samples.quickstart.clients;   
2.   
3. import samples.quickstart.service.adb.StockQuoteServiceStub;   
4.   
5. public class ADBClient{   
6.     public static void main(java.lang.String args[]){   
7.         try{   
8.             StockQuoteServiceStub stub =   
9.                 new StockQuoteServiceStub   
10.                 ("http://localhost:8080/axis2/services/StockQuoteService");   
11.   
12.             getPrice(stub);   
13.             update(stub);   
14.   
15.         } catch(Exception e){   
16.             e.printStackTrace();   
17.             System.err.println("\n\n\n");   
18.         }   
19.     }   
20.   
21.     /* fire and forget */  
22.     public static void update(StockQuoteServiceStub stub){   
23.         try{   
24.             StockQuoteServiceStub.Update req = new StockQuoteServiceStub.Update();   
25.             req.setSymbol ("ABC");   
26.             req.setPrice (42.35);   
27.   
28.             stub.update(req);   
29.             System.err.println("done");   
30.         } catch(Exception e){   
31.             e.printStackTrace();   
32.             System.err.println("\n\n\n");   
33.         }   
34.     }   
35.   
36.     /* two way call/receive */  
37.     public static void getPrice(StockQuoteServiceStub stub){   
38.         try{   
39.             StockQuoteServiceStub.GetPrice req = new StockQuoteServiceStub.GetPrice();   
40.   
41.             req.setSymbol("ABC");   
42.   
43.             StockQuoteServiceStub.GetPriceResponse res =   
44.                 stub.getPrice(req);   
45.   
46.             System.err.println(res.get_return());   
47.         } catch(Exception e){   
48.             e.printStackTrace();   
49.             System.err.println("\n\n\n");   
50.         }   
51.     }   
52.   
53. }   

<script>render_code();</script>
该类使用你创建的Axis Data Bindings创建一个客户端存根。然后它在Web服务上调用getPrice和update操作。getPrice方法操作创建
GetPrice有效载荷并设置symbol为ABC。然后它发送请求并显示当前价格。update方法创建一个Update有效载荷，设置symbol为ABC及
price为42.35。
现在通过在Axis2_HOME/samples/quickstartadb目录键入 ant run.client来构建并运行客户端。
你应该得到以下输出:

代码

1. 42  
2. done   

<script>render_code();</script>

 

使用XMLBeans生成一个客户端
执行以下步骤来使用XMLBeans数据绑定来构建一个客户端。
通过在xmlbeansClient目录键入以下命令来生成数据绑定:
%AXIS2_HOME%/bin/WSDL2Java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.service.xmlbeans -d
xmlbeans -s -o build/client
或者简单的在Axis2_HOME/samples/quickstartxmlbeans目录下键入ant generate.client。
注意这只会创建客户端存根代码而不会创建服务器端代码。
下一步看看quickstartxmlbeans/src/samples/quickstart/clients/XMLBEANSClient.java，并在Code Listing 11看看它怎样定义的
Code Listing 11:XMLBEANSClient类

代码

1. package samples.quickstart.clients;   
2.   
3. import samples.quickstart.service.xmlbeans.StockQuoteServiceStub;   
4. import samples.quickstart.service.xmlbeans.xsd.GetPriceDocument;   
5. import samples.quickstart.service.xmlbeans.xsd.GetPriceResponseDocument;   
6. import samples.quickstart.service.xmlbeans.xsd.UpdateDocument;   
7.   
8. public class XMLBEANSClient{   
9.   
10.     public static void main(java.lang.String args[]){   
11.         try{   
12.             StockQuoteServiceStub stub =   
13.                 new StockQuoteServiceStub   
14.                 ("http://localhost:8080/axis2/services/StockQuoteService");   
15.   
16.             getPrice(stub);   
17.             update(stub);   
18.   
19.         } catch(Exception e){   
20.             e.printStackTrace();   
21.             System.err.println("\n\n\n");   
22.         }   
23.     }   
24.   
25.     /* fire and forget */  
26.     public static void update(StockQuoteServiceStub stub){   
27.         try{   
28.             UpdateDocument reqDoc = UpdateDocument.Factory.newInstance();   
29.             UpdateDocument.Update req = reqDoc.addNewUpdate();   
30.             req.setSymbol ("ABC");   
31.             req.setPrice (42.32);   
32.   
33.             stub.update(reqDoc);   
34.             System.err.println("done");   
35.         } catch(Exception e){   
36.             e.printStackTrace();   
37.             System.err.println("\n\n\n");   
38.         }   
39.     }   
40.   
41.     /* two way call/receive */  
42.     public static void getPrice(StockQuoteServiceStub stub){   
43.         try{   
44.             GetPriceDocument reqDoc = GetPriceDocument.Factory.newInstance();   
45.             GetPriceDocument.GetPrice req = reqDoc.addNewGetPrice();   
46.             req.setSymbol("ABC");   
47.   
48.             GetPriceResponseDocument res =   
49.                 stub.getPrice(reqDoc);   
50.   
51.             System.err.println(res.getGetPriceResponse().getReturn());   
52.         } catch(Exception e){   
53.             e.printStackTrace();   
54.             System.err.println("\n\n\n");   
55.         }   
56.     }   
57. }   

<script>render_code();</script>
该类使用你创建的XMLBeans数据绑定创建一个客户端存根，然后它在Web服务上调用getPrice和update操作。getPrice方法操作创建
GetPriceDocument，它内部的GetPrice类，并设置symbol为ABC。然后它发送请求并得到GetPriceResponseDocument并显示当前price
update方法创建一个UpdateDocument和Update并设置symbol为ABC及price为42.32，当完成时显示done。
现在通过在Axis2_HOME/samples/quickstartxmlbeans目录键入 ant run.client构建并运行工程。
你应该得到下列输出:

代码

1. 42  
2. done   

<script>render_code();</script>

 

使用JiBX生成一个客户端
执行以下步骤来使用JiBX构建一个客户端。
通过在Axis2_HOME/samples/quickstartjibx目录的控制台键入以下命令来生成客户端存根:

代码

1. %AXIS2_HOME%/bin/wsdl2java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.clients -d jibx -s   
2. -uw -o build/client   

<script>render_code();</script>
或者简单的键入" ant generate.client"。
下一步看看quickstartjibx/src/samples/quickstart/clients/JiBXClient.java，在Code Listing 12显示了。
Code Listing 12:JiBXClient类

代码

1. package samples.quickstart.clients;   
2.   
3. import samples.quickstart.service.jibx.StockQuoteServiceStub;   
4.   
5. public class JiBXClient{   
6.     public static void main(java.lang.String args[]){   
7.         try{   
8.             StockQuoteServiceStub stub =   
9.                 new StockQuoteServiceStub   
10.                 ("http://localhost:8080/axis2/services/StockQuoteService");   
11.   
12.             getPrice(stub);   
13.             update(stub);   
14.   
15.         } catch(Exception e){   
16.             e.printStackTrace();   
17.             System.err.println("\n\n\n");   
18.         }   
19.     }   
20.   
21.     /* fire and forget */  
22.     public static void update(StockQuoteServiceStub stub){   
23.         try{   
24.             stub.update("ABC", new Double(42.35));   
25.             System.err.println("done");   
26.         } catch(Exception e){   
27.             e.printStackTrace();   
28.             System.err.println("\n\n\n");   
29.         }   
30.     }   
31.   
32.     /* two way call/receive */  
33.     public static void getPrice(StockQuoteServiceStub stub){   
34.         try{   
35.             System.err.println(stub.getPrice("ABC"));   
36.         } catch(Exception e){   
37.             e.printStackTrace();   
38.             System.err.println("\n\n\n");   
39.         }   
40.     }   
41.   
42. }   

<script>render_code();</script>
该类使用创建的JiBX客户端存根在Web服务上访问getPrice和update操作。getPrice方法为股票"ABC"发送请求并显示当前price。
update方法为股票"ABC"设置价格为42.35。
现在通过在Axis2_HOME/samples/quickstartjibx目录的控制台键入" ant run.client[b]"来构建并运行客户端。
你应该得到以下输出:

代码

42   done   

<script>render_code();</script>
参考JiBX代码生成集成来得到更多关于同Axis2使用JiBX的信息细节。

 

[b]总结

进一步学习
Apache Axis2-http://ws.apache.org/axis2/
Axis2 Architecture-http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html
Introduction to Apache Axis2-http://www.redhat.com/magazine/021jul06/features/apache_axis2/
Working With Apache Axis2-http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2

Axis2是一个立刻让web服务运行起来的灵活和健壮的方式。本指南呈现了创建一个可以在Axis2上部署的服务的五种方法。现在你拥有
了使用多种不同技术来创建Web服务的灵活性。