Axis2快速应用指南

最新推荐文章于 2021-07-03 22:16:19 发布
最新推荐文章于 2021-07-03 22:16:19 发布
阅读量1.3k 收藏 1
点赞数
分类专栏： java_webservice 文章标签： hashmap exception servlet 服务框架 java service
本文介绍了如何使用Axis2快速建立和部署服务及客户端。通过五个不同的方法部署“StockQuoteService”服务，并展示了四种方法来建立客户端以访问这些服务。此外，还提供了详细的步骤说明和示例代码。
摘要由CSDN通过智能技术生成

这片指南的目的是让你尽可能快的开始用Axis2建立服务和客户端。我们将学习一个简单的“StockQuote”服务，并向你展示用不同的方法来建立和部署他，也会看一下Axis2带来的一到两个功能。接下来我们可以看到建立客户端来访问这些服务。

  目录

 快速安装笔记：
文档中的代码可以在被解开的 标准二进制发行包中 找到, 更具体的说是在Axis2_HOME/samples/下的quickstart, quickstartadb, quickstartaxiom, quickstartjibx和quickstartxmlbeans目录中。（考虑现在就获得它对你后面的学习是有益的。）代码包括了Ant创建文件 （build.xml)，我们将在学习的例子中使用这种文件，它使编译更方便。

  介绍

让我们从服务本身开始。我们将使之简化，以使你可以看到在搭建和部署服务时到底发生了什么？一个“StockQuoteService”的例子在类似的场合是必须的，所以让我们使用下面的代码（参见代码列表1）。 代码列表1：StockQuoteService类 
package samples.quickstart.service.pojo;

import java.util.HashMap;

public class StockQuoteService {
    private HashMap map = new HashMap();

    public double getPrice(String symbol) {
        Double price = (Double) map.get(symbol);
        if(price != null){
            return price.doubleValue();
        }
        return 42.00;
    }

    public void update(String symbol, double price) {
        map.put(symbol, new Double(price));
    }
}
它是一个有两个可能调用的服务。一个是输入/输出消息，另一个是只读服务。最后，我们将会把这个服务压缩打包，然后用四种不同的方法来部署它。首先，让我们看一下这个简单的Java类是怎么关联到一个服务的。

  开始

在用Axis2搭建任何东西前，我们必须关心一些小家务。首先，你要准备好Axis2的工作环境。幸运的是，它只是涉及到一些简单的步骤：
  1. 下载安装Java（最低JDK 1.4）。将JAVA_HOME环境变量设置到你安装JDK发行包的目录路径。
  2. 下载Axis2，并解压到一个目标目录。
  3. 复制axis2.war文件到你Servlet引擎的webapps目录。
  4. 将AXIS2_HOME 环境变量指向步骤2中的目标目录。注意，Axis2所有的脚本和搭建文件依赖这个值，所以不要跳过这一步。Linux用户也可以运行 AXIS2_HOME/bin目录下的setenv.sh文件，这样就可以将AXIS2_HOME环境变量设置到Axis2的解压目录路径。
在大多数情况下，我们的服务也需要一个WSDL文件。Axis2的Java2WSDL可以用来产生一个WSDL。从一个Java类生成一个WSDL文件，执行一下步骤：
  1. 建立并编译Java类。
  2. 用这个命令生成WSDL：
  3. %AXIS2_HOME%/bin/java2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService -of StockQuoteService.wsdl
一旦你生成了WSDL文件，你可以做你需要的修改。例如，你可以加入你的定制错误或者改变生成的元素名称。例如：这个 StockQuoteService.wsdl 文件存放在%AXIS2_HOME%/samples/quickstartadb/resources/META-INF 文件夹中，我们会在整个文档中使用它，替换那些用生成程序建立的普通参数。

  Axis2服务

在我们搭建前，理解完成成果是什么样的是很有帮助的。Axis2的服务端可以在任何Servlet引擎上部署，它的结构如下面的代码列表2所示。 代码列表2：axis2.war的目录结构 
axis2-web 
META-INF
WEB-INF
    classes 
    conf
        axis2.xml 
    lib
        activation.jar
        ...
        xmlSchema.jar
    modules
        modules.list 
        addressing.mar
        ...
        soapmonitor.mar
    services
        services.list
        aservice.aar
        ...
        version.aar
    web.xml
从最上面开始，axis2-web是组成管理员应用的JSP文件集合，通过它你可以执行诸如添加服务和生效或者撤销模块。WEB-INF目录 包含了实际的Java类和其他支持文件，用它们来运行任何部署到服务目录的服务。这其中最主要的是axis2.xml，它控制应用程序如何处理接收到的消 息，决定Axis2是否需要用模块目录中定义的模块。象你在这里看到的一样，服务可以用aar后缀的文件来部署，但是它们的内容必须按照特定的方式安排。 例如，服务结构如下： 
- StockQuoteService
   - META-INF
     - services.xml
   - lib
   - samples
     - quickstart
       - service
         - pojo
           - StockQuoteService.class
这里，服务名称是StockQuoteService，它是在services.xml文件中指定以及和这个服务的顶层文件夹相对应。编译过 的Java类根据包的名字被放在这个目录下的合适位置。除了已经放在Axis2 WAR文件中和Servlet容器common JAR目录下的，lib目录包含了运行这个服务所需要的特定的JAR文件（本例中没有）。最后，META-INF目录包含了其他关于Axis2需要正确执 行这个服务的信息。services.xml文件定义了服务本身并且将Java类链接到服务上来（参见代码列表3）。 代码列表3：服务定义文件 
<service name="StockQuoteService" scope="application">
    <description>
        Stock Quote Sample Service
    </description>

    <messageReceivers>
        <messageReceiver 
            mep="http://www.w3.org/2004/08/wsdl/in-only"
    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
        <messageReceiver
            mep="http://www.w3.org/2004/08/wsdl/in-out"
    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>

    </messageReceivers>
    <parameter name="ServiceClass">
        samples.quickstart.service.pojo.StockQuoteService
    </parameter>
</service>
在这里，根据messageReceiver中不同消息交换模式的相关类型，定义了服务。META-INF目录也是你想放置在此应用中任何客户化WSDL 文件的位置。你可以通过复制这个简单文件层次结构到你Servlet引擎的webapps/axis2/WEB-INF/services目录来部署这个 服务。（注意，Axis2 WAR必须先安装在Servlet引擎中。）这就是分解模式。你也可以将你文档压缩为一个类似jar文件的aar文件，直接把这个aar文件放到 Servlet引擎的webapps/axis2/WEB-INF/services目录下。现在你知道我们要完成什么了，我们就要准备开始搭建了。首 先， 下载并解压合适的Axis2标准二进制发行包。确认你把AXIS2_HOME变量值设置为你解压这个发行包的目录路径。让我们看一些建立客户端和服务的不同方法。

  建立服务

在这一部分里，我们将看到用五种方法来创建基于StockQuoteService类的服务：部署Plain Old Java Objects (POJO)，用AXIOM's 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目录下通过输入以下命令来生成一个WSDL文件：
ant generate.wsdl

然而，创建StockQuoteService.wsdl是可选的。它可以是从Java类直接生成的版本，也可以是这个文件的一个定制版本，而且，和前面文档中引用的services.xml是同一个文件。

现在在quickstart目录下输入ant generate.service，这样就能创建如下目录结构： 
- quickstart/build/classes
   - META-INF
     - services.xml
   - samples
     - quickstart
       - service
         - pojo
           - StockQuoteService.class
如果你想要在一个分解开的目录格式下部署服务，将classes目录更名为，并把它复制到你的Servlet引擎的webapps/axis2/WEB- INF/services 目录。否则，复制build/StockQuoteService.aar文件到你Servlet引擎的webapps/axis2/WEB- INF/services目录。要检查确认服务被正确部署，可以访问服务列表： 
http://localhost:8080/axis2/services/listServices
你也可以检验WSDL文件: 
http://localhost:8080/axis2/services/StockQuoteService?wsdl
检验Schema: 
http://localhost:8080/axis2/services/StockQuoteService?xsd
一旦这些URL工作正常，马上测试这个服务。试着在浏览器中输入以下URL： 
http://localhost:8080/axis2/services/StockQuoteService/getPrice?symbol=IBM
你将得到以下反馈： 
<ns:getPriceResponse xmlns:ns="http://pojo.service.quickstart.samples/xsd"><ns:return>42</ns:return></ns:getPriceResponse>
如果你象下面这样调用update方法, 
http://localhost:8080/axis2/services/StockQuoteService/update?symbol=IBM&price=100
然后运行前面的getPrice URL，你将看到价格变化了。

 用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
因为AXIOM有一点不同，你需要一个与POJO中使用的不同的services.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>
注意大部分是一样的，除了在services.xml文件中明确定义的操作，以及现在的MessageReceivers用的是RawXML。
现在，在上面引用的StockQuoteService.java类在代码列表5中定义，这个类使用了来自Axis2库中的类。
代码列表类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对象模型，是一个基于StAX API（Streaming API for XML）接口的类DOM（Document Object Model）结构。作为服务的方法必须接受一个OMElement作为它的参数，OMElement代表一个XML Element,在这个例子中，它碰巧是一个输入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
和schema， 
http://localhost:8080/axis2/services/StockQuoteService?xsd

 用ADB生成服务
要用Axis2 Databinding Framework（ADB）生成和部署服务，执行以下步骤。

在Axis2_HOME/samples/quickstartadb目录下输入下列命令，就可以用WSDL2Java功能生成主要框架： 
%AXIS2_HOME%/bin/WSDL2Java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.service.adb -d adb -s -ss -sd -ssi -o build/service
或者在Axis2_HOME/samples/quickstartadb 目录下简单输入ant generate.service也可以。

选项-d adb指定了Axis Data Binding (ADB) 。-s开关指定了同步还是阻塞方式。-ss开关建立了服务端代码（框架和相关文件）。-sd开关建立了一个服务描述（services.xml file）。-ssi开关建立了服务框架的接口。服务文件现在应该位于build/service目录。

如果你直接用WSDL2Java生成代码，下一步你不得不为了实现服务而修改生成的框架（如果你用了“ant generate.service”，一个完整的框架将会覆盖自动生成的那个代码）。

打开并修改文件 build/service/src/samples/quickstart/adb/service/StockQuoteServiceSkeleton.java，加入你服务的功能到生成方法中，如代码列表6所示。
代码列表6：定义服务框架文件 
package samples.quickstart.service.adb;

import samples.quickstart.service.adb.xsd.GetPriceResponse;
import samples.quickstart.service.adb.xsd.Update;
import samples.quickstart.service.adb.xsd.GetPrice;

import java.util.HashMap;

public class StockQuoteServiceSkeleton {

    private static HashMap map;

    static{ map = new HashMap(); }

    public void update(Update param0) {
        map.put(param0.getSymbol(), new Double(param0.getPrice()));
    }

    public GetPriceResponse getPrice(GetPrice param1) {
        Double price = (Double) map.get(param1.getSymbol());
        double ret = 42;
        if(price != null){
            ret = price.doubleValue();
        }
        GetPriceResponse res =
                new GetPriceResponse();
        res.set_return(ret);
        return res;
    }
}
现在你可以在build/service 目录下输入下面的命令来搭建项目： 
ant jar.server
如果所有都运行正常，你将在窗口中看到BUILD SUCCESSFUL的消息，以及在build/service/build/lib目录中看到文件StockQuoteService.aar。复制这 个文件到你Servlet引擎的webapps/axis2/WEB-INF/services目录下。

要检查确认服务被正确部署，可以访问服务列表， 
http://localhost:8080/axis2/services/listServices
你还可以检查定制的WSDL, 
http://localhost:8080/axis2/services/StockQuoteService?wsdl
和schema, 
http://localhost:8080/axis2/services/StockQuoteService?xsd

 用XMLBeans生成服务
要使用XMLBeans生成一个服务，执行以下步骤。

在Axis2_HOME/samples/quickstartxmlbeans目录里输入以下命令，就可以用WSDL2Java功能生成框架。 
%AXIS2_HOME%/bin/WSDL2Java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.service.xmlbeans -d xmlbeans -s -ss -sd -ssi -o build/service
或者在Axis2_HOME/samples/quickstartxmlbeans 下简单的打ant generate.service。

选项-d xmlbeans指定了XML Beans数据绑定。 -s开关指定了同步或者阻塞方式调用。-ss开关建立服务端代码（框架和相关文件）。-sd开关建立了一个服务描述（services.xml文件）。- ssi开关建立了服务框架的一个接口。现在在build/service目录下应该有服务文件了。

如果直接用WSDL2Java生成代码，接下来你不得不修改生成的框架来实现服务（如果你用“ant generate.service”，一个完整的框架将会覆盖自动生成的那个框架）。 接下来打开build/service/src/samples/quickstart/service/xmlbeans/StockQuoteServiceSkeleton.java 文件，加入你的服务功能到生成的方法中（参见代码列表7）。
代码列表7：定义服务框架 
package samples.quickstart.service.xmlbeans;

import samples.quickstart.service.xmlbeans.xsd.GetPriceDocument;
import samples.quickstart.service.xmlbeans.xsd.GetPriceResponseDocument;
import samples.quickstart.service.xmlbeans.xsd.UpdateDocument;

import java.util.HashMap;

public class StockQuoteServiceSkeleton implements StockQuoteServiceSkeletonInterface {

    private static HashMap map;

    static{ map = new HashMap(); }

    public void update(UpdateDocument param0) {
        map.put(param0.getUpdate().getSymbol(), new Double(param0.getUpdate().getPrice()));
    }

    public GetPriceResponseDocument getPrice(GetPriceDocument param1) {
        Double price = (Double) map.get(param1.getGetPrice().getSymbol());
        double ret = 42;
        if(price != null){
            ret = price.doubleValue();
        }
        System.err.println();
        GetPriceResponseDocument resDoc =
                GetPriceResponseDocument.Factory.newInstance();
        GetPriceResponseDocument.GetPriceResponse res =
                resDoc.addNewGetPriceResponse();
        res.setReturn(ret);
        return resDoc;
    }
}
在build/service目录下输入下面的命令来搭建项目，这些命令包含在文件build.xml中： 
ant jar.server
如果一切运行正常，你将在你的窗口中看到BUILD SUCCESSFUL信息，以及在新建立的build/service/build/lib 目录下看到文件StockQuoteService.aar。把这个文件复制到Servlet引擎的the webapps/axis2/WEB-INF/services目录。

要检查确认服务被正确部署，可以访问服务列表， 
http://localhost:8080/axis2/services/listServices
你还可以检查定制的WSDL, 
http://localhost:8080/axis2/services/StockQuoteService?wsdl
和schema, 
http://localhost:8080/axis2/services/StockQuoteService?xsd

 用JiBX生成服务
要用 JiBX数据绑定生成和部署服务，执行以下步骤。

用一个控制台，并在Axis2_HOME/samples/quickstartjibx目录下输入以下命令就可以用WSDL2Java功能生成框架： 
%AXIS2_HOME%/bin/wsdl2java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.service.jibx -d jibx -s -ss -sd -ssi -uw -o build/service
或者在Axis2_HOME/samples/quickstartjibx 目录下简单输入“ant generate.service”。

选项-d jibx指定了JiBX数据绑定。-s开关指定了同步还是阻塞方式调用。-ss开关建立服务端代码（框架和相关代码）。-sd开关建立了一个服务描述 （service.xml文件）。-ssi开关建立了服务框架的一个接口。-uw开关解开传递给和获取自的服务操作的参数，这样可以建立一个更自然变成接 口。

在运行WSDL2Java后，在build/service目录下应该有服务文件。如果你用WSDL2Java直接生成代码，你需要修改生成的框架来实现 服务（如果你用“ant generate.service”，一个完整的框架将覆盖那个自动生成的框架）。打开并修改文件 build/service/src/samples/quickstart/service/jibx/StockQuoteServiceSkeleton.java， 在生成的方法中添加你的服务功能，如代码列表8所示。
代码列表8：定义服务框架文件 
package samples.quickstart.service.jibx;

import java.util.HashMap;

public class StockQuoteServiceSkeleton implements StockQuoteServiceSkeletonInterface {
    private HashMap map = new HashMap();

    public void update(String symbol, Double price) {
        map.put(symbol, price);
    }

    public Double getPrice(String symbol) {
        Double ret = (Double) map.get(symbol);
        if (ret == null) {
            ret = new Double(42.0);
        }
        return ret;
    }
}
现在你可以在build/service目录下输入以下命令搭建项目： 
ant jar.server
如果一切运行正常，你将在你的框口中看到BUILD SUCCESSFUL信息，以及在build/service/build/lib目录中看到文件StockQuoteService.aar。复制这个 文件到Servlet引擎的webapps/axis2/WEB-INF/services 目录。

要检查确认服务被正确部署，可以访问服务列表， 
http://localhost:8080/axis2/services/listServices
你还可以检查定制的WSDL, 
http://localhost:8080/axis2/services/StockQuoteService?wsdl
和schema, 
http://localhost:8080/axis2/services/StockQuoteService?xsd
要获得更多的关于在Axis2中使用JiBX的信息，参见 JiBX代码生成集成细节。 你也可以检查 JiBX Axis2 Wiki 网页，以获得关于Axis2中使用JiBX的更新信息。

  生成客户端

在这一部分中，我们将看到四种方法来建立客户端，这个客户端基于StockQuoteService类：建立基于AXIOM的客户端，用Axis2数据绑定框架（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
上面引用的AXIOMClient.java类如下代码列表9所示。

代码列表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("price updated");
            OMElement result = sender.sendReceive(getPricePayload);

            String response = result.getFirstElement().getText();
            System.err.println("Current price of WSO: " + response);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
}
Axis2使用AXIOM，或者说AXIs对象模型，这是一个基于StAX API接口（Streaming API for XML）的类DOM（Document Object Model）结构。你在这里建立服务中的update和getPrice方法的具体内容。建立这些内容和你建立AXIOM服务中的 getPriceResponse的方法是一样的。接下来你建立可选类，以及一个用来与服务通讯的ServiceClient。首先你调用update方 法，这是一个不返回人和东西的fireAndForget方法。最后，你调用getPrice方法，从服务处获得当前价格并显示它们。

现在你可以建立和运行AXIOM客户端，在Axis2_HOME/samples/quickstartaxiom 中输入ant run.client。

你应该得到以下输出： 
done
Current price of WSO: 123.42

 用ADB建立一个客户端
要用Axis数据绑定（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, 看看它在代码列表10中是怎么被定义的。

代码列表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);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* fire and forget */
    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("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* two way call/receive */
    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");
        }
    }

}
这个类用你建立的Axis数据绑定建立一个客户端功能组。接着它在Web Service上调用getPrice和update操作。getPrice方法建立一个GetPrice数据包并把symbol的值设为ABC。接着它 发送请求并显示当前价格。Update方法建立了一个Update数据包，把symbol和price的值分别设为ABC和42.35。

现在搭建并运行客户端，在Axis2_HOME/samples/quickstartadb 目录下执行ant run.client。

你将得到以下的输出： 
42
price updated
42.35

 用XMLBeans生成客户端
要用XML Beans数据绑定搭建一个客户端，执行以下步骤。

在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，看看它在代码列表11中匙如何定义的。

代码列表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);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* fire and forget */
    public static void update(StockQuoteServiceStub stub){
        try{
            UpdateDocument reqDoc = UpdateDocument.Factory.newInstance();
            UpdateDocument.Update req = reqDoc.addNewUpdate();
            req.setSymbol ("BCD");
            req.setPrice (42.32);

            stub.update(reqDoc);
            System.err.println("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* two way call/receive */
    public static void getPrice(StockQuoteServiceStub stub){
        try{
            GetPriceDocument reqDoc = GetPriceDocument.Factory.newInstance();
            GetPriceDocument.GetPrice req = reqDoc.addNewGetPrice();
            req.setSymbol("BCD");

            GetPriceResponseDocument res =
                stub.getPrice(reqDoc);

            System.err.println(res.getGetPriceResponse().getReturn());
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }
}
这个类用你建立的XML Beans数据绑定建立了一个客户端功能组。接着它在Web Service上调用getPrice和update操作。getPrice方法建立了GetPriceDocument实例，这是它的内部 GetPrice类，并设置symbol的值为ABC。接着发送请求并接收到一个GetPriceResponseDocument实例显示当前价格。。 update方法建立一个UpdateDocument实例，将symbol和price分别设置为ABC和42.32，在完成时显示‘done’。

现在搭建并运行项目，在Axis2_HOME/samples/quickstartxmlbeans 目录里输入ant run.client即可。

你将得到以下输出： 
42
price updated
42.32

 用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
或者简单输入“ant generate.client”。

接下来看一下quickstartjibx/src/samples/quickstart/clients/JiBXClient.java，如下面的代码列表12所示。

代码列表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);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* fire and forget */
    public static void update(StockQuoteServiceStub stub){
        try{
            stub.update("CDE", new Double(42.35));
            System.err.println("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

    /* two way call/receive */
    public static void getPrice(StockQuoteServiceStub stub){
        try{
            System.err.println(stub.getPrice("CDE"));
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("/n/n/n");
        }
    }

}
这个类用JiBX客户端功能组在Web Service上访问getPrice和update操作。getPrice方法发送一个股票“ABC”的请求并显示价格。Update方法将股票“ABC”的值设为42.35。 现在在Axis2_HOME/samples/quickstartjibx 目录里，打开一个控制台输入“ant run.client”，就能搭建和运行客户端了。

你将得到以下的输出： 
42
price updated
42.35
要获得更多的关于在Axis2上使用JiBX的信息，参见 JiBX代码生成集成的细节。

  小结

Axis2为快速获取和运行web service，提供了一个平滑和健壮的方法。 这篇指南述说了在Axis2上部署服务的五种方法和建立与服务通讯客户端的四种方法。你现在有了可以用不同技术建立Web service的灵活性了。

  进一步的学习

Apache Axis2 - http://ws.apache.org/axis2/

Axis2 体系结构 - http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html

Apache Axis2介绍 - http://www.redhat.com/magazine/021jul06/features/apache_axis2/

和Apache Axis2一起工作 - http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2
dainiao01
关注
专栏目录
Axis2的OMElement SOAP XML报文节点首字母小写转大写（注意，是节点，不是节点元素的值） java
07-10
Axis2的OMElement SOAP XML报文节点首字母小写转大写（注意，是节点，不是节点元素的值） java
java webservice 采用AXIS2开发时，OMElement和Java对象之间的转换
09-17 950
<!--google_ad_client = "pub-6251330221539112";/* 336x280 csdn.net内容 */google_ad_slot = "3096601444";google_ad_width = 336;google_ad_height = 280;//--><script type="text/javascript"sr
使用Axis2传输附件(AXIS2 MTOM)
weixin_33985679的博客
05-16 158
本文介绍如何使用Axis2传递附件。 author: ZJ 07-5-7 Blog: [url]http://zhangjunhd.blog.51cto.com/[/url] 1．工作环境 IDE: Eclipse 3.1.2 jdk: jdk1.5.0_04 Tomcat: apache-tomcat-5.0.28 AXIS2:1.0(war版本和bin...
Axis2的OMElement问题
embbls的博客
04-10 827
今天用Axis2来测试连接公司SAP服务上的wsdl接口, 代码报错, 发现有个解决方案,记下来. 当然是转自别人的:http://blog.csdn.net/lzj0470/article/details/16339799 经过调查,因为build path 下面我只引用了axis2-1.6.2.jar.但是axis2在这里依赖于axiom-api,所以我后来通过maven的repos
axis2 异常OMElement
hhj724的专栏
11-16 2413
问题产生：使用客户端访问axis2产生异常，具体如下： org.apache.axis2.AxisFault: The ServiceClass object does not implement the required method in the following form: OMElement XXX(OMElement e) 解决方法： 现使用版本是axis2-1.7.4
Apache Axis2 快速入门指南
本资源《Quickstart Apache Axis2》提供了一个快速入门的指南，帮助读者理解Web服务的基本概念，并通过Axis2进行实践操作。 在Java世界中，Web服务是一种标准的方式，用于不同应用程序之间的通信和数据交换。Axis2...
Apache Axis2 快速入门指南(PDF)
这本书"Quickstart Apache Axis2"旨在为开发者提供一个快速了解和使用Apache Axis2的实用指南。书中可能涵盖了以下关键知识点： 1. **Web服务基础**：首先，书可能会介绍Web服务的基本概念，包括SOAP（简单对象访问...
Axis2中OMElement对象解析的问题
no pay no gay
06-26 6308
Axis2中OMElement对象 -------------- 对iterator进行迭代，每次innerItr取其子元素，这不是相当于对innerItr进行迭代了吗？ —— 不是的，XML结构的关系就类似于 List 初学XML，最怕不知道进入了XML的什么位置，所以还是检查下你究竟在迭代什么元素吧： Java code ?
AXIS2实例1：通过AXIOM OMElement objects方式
jeanjeanfang的专栏
11-02 1845
1. Service的java代码D:/mysamples/sample2/src/SampleService.javaimport org.apache.axiom.om.OMNamespace;public class SampleService {    public OMElement sayHello(OMElement element) throws XMLStream
AXIS2中OMElement和Java对象之间的转换
小松的博客
12-04 546
[b]AXIOM[/b] Axis对象模型（AXIOM）是一个XML对象模型，设计用于提高XML处理期间的内存的使用率和性能，基于Pull解析。 Pull解析方式，基于STAX（Streaming API for XML），Pull解析是最近处理XML的一种趋势，而SAX和DOM都是基于push的解析方式，也就是说解析控制在parser本身。Push解析方式很容易使用，但在处理XML文...
Axis2中的操作OMElement【取得某一个节点下的子节点】
u010809395的专栏
12-01 1089
private static OMElement value = null; public static OMElement getTheNodeValue(OMElement in, String nodeName) { try { Iterator desc = in.getChildElements()...
Axis2简单入门
勐萌博文
07-22 277
1.到Apache官网下载Axis2   给你地址：http://axis.apache.org/axis2/java/core/download.cgi   2.设置环境   把下载好的Axis2放到一个你喜欢的位置，我放在了 F:\Program Files\axis2-1.5.5   然后设置环境变量： AXIS2_HOME=F:\Program Files\axis2...
深入剖析Axis2中参数为复杂自定义类型值【步步逼近实践篇】
webdev
12-28 433
问：Axis2中到底能否传递复杂以及自定义对象？ 答：肯定可以 上篇博客深入剖析Axis2中返回值为自定义对象以及复杂类型，比如：List&lt;User&gt;类型。 那这篇博客我们继续讲解，讲一下Axis2中参数为自定义对象，如User对象或List&lt;User&gt;参数。 首先说参数为User对象。 服务器端照常如旧。还是用最初的文档中方式搭建。其中...
Axis2快速上手指南(1)
DCTM + SAP
06-26 236
原文链接:http://ws.apache.org/axis2/1_1_1/quickstartguide.html 本指南的目的是让你尽可能快的创建使用Axis2的服务和客户端，我们将使用一个简单的StockQuote服务并显示给你一些创建和部署它 的不同的方式，以及快速的看看Axis2自带的一些工具，然后我们将看看创建访问这些服务的客户端。 内容 代码 介绍    ...
dom 元素 属性和方法
11-23 177
http://www.runoob.com/jsref/dom-obj-all.html 属性 / 方法描述 element.accessKey 设置或返回accesskey一个元素 element.addEventListener() 向指定元素添加事件句柄 element.appendChild() 为元素添加一个新的子元素 ...
axis2客户端调用webservice服务--通过wsdl生成客户端程序并本地调用
az44yao的专栏
07-03 1336
搬砖的过程总应该去和未知相遇 今天相遇的就是对接webservice接口，话不多说，讲讲最终选择的实现方案–通过wsdl生成客户端程序并本地调用 配置axis2环境： 1、下载axis2-1.7.9-bin.zip，官网路径：http://axis.apache.org/axis2/java/core/download.html，解压 2、在解压后的目录中找到wsdl2java.bat，我的目录是C:\Users\wensijia\axis2-1.7.9-bin\axis2-1.7.9\bin 3、配置ax
axis2 默认端口_Axis2学习教程之－ 如何安装Axis2到本地系统
weixin_36377930的博客
12-23 294
Axis2分发包Axis2分几种不同的分发包来提供，可以被当作独立的服务器运行或是当作j2ee兼容的servlet容器的一部分来运行，Axis2遵循Apache授权协议2.0这里的安装向导主要集中在使用独立的二进制分发包来运行Apache Axis2.Download Apache Axis2 1.6.3 (最新版).Download所有版本的 Apache Axis2.发布包以下列的几种形...
web Service 工具类
suwenLove的博客
05-18 299
package com.kBox.util; 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.AxisFault; import org.apache.axis2.addressing.
The type org.apache.axiom.om.OMElement cannot be resolved. It is indirectly referenced from require
热门推荐
lzj0470的专栏
11-15 1万+
经过调查,因为build path 下面我只引用了axis2-1.6.2.jar.但是axis2在这里依赖于axiom-api,所以我后来通过maven的repository搜索了axiom.我把最新版的依赖加入,如下:             org.apache.axis2         axis2         1.6.2                   ws-com
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值