创建客户端
在这个部分,我们将看看基于StockQuoteService类创建客户端的四种方式:构建基于AXIOM的客户端,使用Axis2 Databinding Frame
work(ADB)生成客户端,使用XMLBeans生成客户端,使用JiBX生成客户端。
使用AXIOM创建一个客户端
执行以下步骤来使用AXIOM构建一个客户端。
也注意在使用AXIOM创建服务部分显示的目录结构,为了完整性下面的重复了。
代码
- - quickstartaxiom
- - README.txt
- - build.xml
- - resources
- - META-INF
- - services.xml
- - StockQuoteService.wsdl
- - src
- - samples
- - quickstart
- - service
- - axiom
- - StockQuoteService.java
- - clients
- - AXIOMClient.java
<script>render_code();</script>
上面提到的AXIOMClient.java类的定义显示在下面的Code Listing 9。
Code Listing 9:使用AXIOM的AXIOMClient类
代码
- package samples.quickstart.clients;
-
- 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 org.apache.axis2.Constants;
- import org.apache.axis2.addressing.EndpointReference;
- import org.apache.axis2.client.Options;
- import org.apache.axis2.client.ServiceClient;
-
- public class AXIOMClient {
-
- private static EndpointReference targetEPR =
- new EndpointReference("http://localhost:8080/axis2/services/StockQuoteService");
-
- public static OMElement getPricePayload(String symbol) {
- OMFactory fac = OMAbstractFactory.getOMFactory();
- OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");
-
- OMElement method = fac.createOMElement("getPrice", omNs);
- OMElement value = fac.createOMElement("symbol", omNs);
- value.addChild(fac.createOMText(value, symbol));
- method.addChild(value);
- return method;
- }
-
- public static OMElement updatePayload(String symbol, double price) {
- OMFactory fac = OMAbstractFactory.getOMFactory();
- OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");
-
- OMElement method = fac.createOMElement("update", omNs);
-
- OMElement value1 = fac.createOMElement("symbol", omNs);
- value1.addChild(fac.createOMText(value1, symbol));
- method.addChild(value1);
-
- OMElement value2 = fac.createOMElement("price", omNs);
- value2.addChild(fac.createOMText(value2,
- Double.toString(price)));
- method.addChild(value2);
- return method;
- }
-
- public static void main(String[] args) {
- try {
- OMElement getPricePayload = getPricePayload("WSO");
- OMElement updatePayload = updatePayload("WSO", 123.42);
- Options options = new Options();
- options.setTo(targetEPR);
- options.setTransportInProtocol(Constants.TRANSPORT_HTTP);
-
- ServiceClient sender = new ServiceClient();
- sender.setOptions(options);
-
- sender.fireAndForget(updatePayload);
- System.err.println("done");
- OMElement result = sender.sendReceive(getPricePayload);
-
- String response = result.getFirstElement().getText();
- System.err.println("Current price of WSO: " + response);
-
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
-
- }
<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客户端。
你应该得到以下输出:
代码
- done
- 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类
代码
- package samples.quickstart.clients;
-
- import samples.quickstart.service.adb.StockQuoteServiceStub;
-
- public class ADBClient{
- public static void main(java.lang.String args[]){
- try{
- StockQuoteServiceStub stub =
- new StockQuoteServiceStub
- ("http://localhost:8080/axis2/services/StockQuoteService");
-
- getPrice(stub);
- update(stub);
-
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void update(StockQuoteServiceStub stub){
- try{
- StockQuoteServiceStub.Update req = new StockQuoteServiceStub.Update();
- req.setSymbol ("ABC");
- req.setPrice (42.35);
-
- stub.update(req);
- System.err.println("done");
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void getPrice(StockQuoteServiceStub stub){
- try{
- StockQuoteServiceStub.GetPrice req = new StockQuoteServiceStub.GetPrice();
-
- req.setSymbol("ABC");
-
- StockQuoteServiceStub.GetPriceResponse res =
- stub.getPrice(req);
-
- System.err.println(res.get_return());
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
- }
<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来构建并运行客户端。
你应该得到以下输出:
代码
<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类
代码
- package samples.quickstart.clients;
-
- import samples.quickstart.service.xmlbeans.StockQuoteServiceStub;
- import samples.quickstart.service.xmlbeans.xsd.GetPriceDocument;
- import samples.quickstart.service.xmlbeans.xsd.GetPriceResponseDocument;
- import samples.quickstart.service.xmlbeans.xsd.UpdateDocument;
-
- public class XMLBEANSClient{
-
- public static void main(java.lang.String args[]){
- try{
- StockQuoteServiceStub stub =
- new StockQuoteServiceStub
- ("http://localhost:8080/axis2/services/StockQuoteService");
-
- getPrice(stub);
- update(stub);
-
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void update(StockQuoteServiceStub stub){
- try{
- UpdateDocument reqDoc = UpdateDocument.Factory.newInstance();
- UpdateDocument.Update req = reqDoc.addNewUpdate();
- req.setSymbol ("ABC");
- req.setPrice (42.32);
-
- stub.update(reqDoc);
- System.err.println("done");
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void getPrice(StockQuoteServiceStub stub){
- try{
- GetPriceDocument reqDoc = GetPriceDocument.Factory.newInstance();
- GetPriceDocument.GetPrice req = reqDoc.addNewGetPrice();
- req.setSymbol("ABC");
-
- GetPriceResponseDocument res =
- stub.getPrice(reqDoc);
-
- System.err.println(res.getGetPriceResponse().getReturn());
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
- }
<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构建并运行工程。
你应该得到下列输出:
代码
<script>render_code();</script>
使用JiBX生成一个客户端
执行以下步骤来使用JiBX构建一个客户端。
通过在Axis2_HOME/samples/quickstartjibx目录的控制台键入以下命令来生成客户端存根:
代码
- %AXIS2_HOME%/bin/wsdl2java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.clients -d jibx -s
- -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类
代码
- package samples.quickstart.clients;
-
- import samples.quickstart.service.jibx.StockQuoteServiceStub;
-
- public class JiBXClient{
- public static void main(java.lang.String args[]){
- try{
- StockQuoteServiceStub stub =
- new StockQuoteServiceStub
- ("http://localhost:8080/axis2/services/StockQuoteService");
-
- getPrice(stub);
- update(stub);
-
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void update(StockQuoteServiceStub stub){
- try{
- stub.update("ABC", new Double(42.35));
- System.err.println("done");
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
-
- public static void getPrice(StockQuoteServiceStub stub){
- try{
- System.err.println(stub.getPrice("ABC"));
- } catch(Exception e){
- e.printStackTrace();
- System.err.println("\n\n\n");
- }
- }
-
- }
<script>render_code();</script>
该类使用创建的JiBX客户端存根在Web服务上访问getPrice和update操作。getPrice方法为股票"ABC"发送请求并显示当前price。
update方法为股票"ABC"设置价格为42.35。
现在通过在Axis2_HOME/samples/quickstartjibx目录的控制台键入"
ant run.client[b]"来构建并运行客户端。
你应该得到以下输出:
代码
<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服务的灵活性。
分享到:
相关推荐
XFire 还具有易于上手、快速发布服务、灵活的 Binding 机制等特点。 与 Axis1 相比,XFire 的性能有了质的提高,XFire 比 Axis1.3 快 2-6 倍,XFire 的响应时间是 Axis1.3 的 1/2 到 1/5。XFire 的灵活性更高,...
Axis2是Apache软件基金会的一个用于构建和部署WebService的引擎,它基于Apache Axis项目,并且是Apache Web服务堆栈的...通过这个指南,开发者可以快速上手Axis2的使用,以及深入理解和应用其在各种场景下的强大功能。
在IT行业中,Web服务是应用程序之间进行通信的一种标准方法,而Axis和Axis2是两种流行的Java SOAP(简单对象访问协议)框架,用于...在实际工作中,结合详细的API文档,开发者可以快速上手,实现高效的服务开发和集成。
- `samples`目录:可能包含了一些示例服务和使用指南,帮助初学者快速上手。 了解了这些基础知识后,开发者可以利用Apache Axis2 1.7.9创建高效率、可扩展的Web服务,同时享受其强大的功能和灵活性。在实际项目中,...
- `README.txt`:通常包含快速安装指南、基本操作和一些重要的提示,帮助用户快速上手使用Axis2。 Axis2的核心特性包括: - **模块化**:Axis2允许通过模块进行功能扩展,模块可以独立于服务存在,提高代码复用性...
4. **文档**:可能会包含用户指南、API参考文档和其他技术文档,解释了Axis2的用法和配置选项。 5. **源代码**:如果标记正确,那么会有一系列的源代码文件,这包括了Axis2的实现,开发者可以研究并学习其设计和...
"经典实例,工程导入就能用"意味着这是一个可以直接运行的项目,无需过多的设置,这对于初学者或开发者快速上手Axis2非常有帮助。 【标签】"Axis2"、"myeclipse"和"例子"、"jar"揭示了几个关键概念。Axis2是Apache...
6. **samples**:可能包含示例Web服务和教程,帮助用户快速上手。 7. **docs**:可能包含API文档和用户指南。 8. **Distributions**或**WebContent**:包含Axis2的Web应用程序结构,可以部署到Web服务器如Tomcat。 ...
4. **示例和服务**:可能包含一些预打包的示例Web服务,帮助用户快速上手和理解如何在Axis2中部署和调用服务。 5. **文档**:包括用户手册、开发者指南和API文档,帮助开发者了解如何使用和扩展Axis2。 6. **模块**...
- **samples**目录:包含示例服务和客户端应用,帮助开发者快速上手。 - **repository**目录:存储服务、模块和依赖的仓库。 - **docs**目录:可能包含API文档和用户指南。 通过解压并探索这个“axis2-1.4.1-bin”...
- "axis2&axis教程资料"可能包含了关于这两个框架的详细教程、示例代码和最佳实践,可以帮助初学者快速上手。 - 在线文档:Apache官方提供了详细的 Axis2 和 Axis 文档,包括用户指南、开发者指南和API参考。 7. ...
3. **README.txt** - 这个文件通常包含关于如何安装、配置和使用软件的基本指南,对于快速上手Axis2 1.5.4的部署和配置非常有帮助。 4. **NOTICE.txt** - 通知文件,列出在软件中使用的第三方组件及其各自的版权信息...
- **在线教程和示例代码**:帮助快速上手并深入理解Axis2的工作原理和实践技巧。 总之,Apache Axis2是一个强大且灵活的Web服务框架,为企业级应用提供了一套完善的解决方案,无论是对于初学者还是有经验的开发者,...
通过阅读“Quickstart Apache Axis2.pdf”,你可以逐步掌握这些概念并实践操作,从而快速上手Apache Axis2的使用。"E书说明.txt"可能包含了关于PDF文档的阅读和使用提示,而"阅读器下载.htm"可能是推荐的PDF阅读器...
AXIS简化了WebService的开发流程,通过自动代码生成和部署工具,使得开发人员可以快速地实现服务接口。 ### 2. 简单介绍 **2.1 WebService介绍** WebService是一种基于标准的、平台无关的通信方式,通过SOAP消息在...
总的来说,《Packt - Quickstart Apache Axis2》是一本全面的指南,涵盖了从基础到高级的Apache Axis2知识,适合想要快速上手并深入理解Web服务开发的开发者。通过阅读本书,读者将能够熟练地运用Apache Axis2构建...
4. **Samples**:提供示例代码和配置文件,帮助开发者快速上手,通过实际操作理解Axis2的功能和用法。 5. **Schema**:可能包含Axis2支持的数据交换格式(如WSDL和XML Schema)的定义文件。 6. **Deployment ...