Axis2创建webservice服务的方式 之 ADB 方式(一)

1. ADB方式生成webservice服务的流程:

   

(1)首先需要一个wsdl文件.

   这个文件可以自己手写,或者从第三方获取,或者自己写一个interface,

   然后使用Axis2的Java2wsdl工具生成.

  

(2) 根据(1)中wsdl文件,使用Axis2的wsdl2java工具生成服务的骨架文件

    (还包含发布服务的services.xml文件,已经ant编译脚本文件build.xml等)

 

(3) 修改  wsdl2java工具生成的文件,发布服务.

 

2. 以ADB方式创建服务

 

2.1 先编写一个interface文件,如下:

package test.adb.theinterface;

public interface ITestAdb
{
  void setName(String name);
  String getName();
}

 

接口文件放到test.adb.theinterface包中.

 

2.2 使用axis的java2wsdl方式生成wsdl文件.

 

以工程的calss目录为当前目录

(比如 web程序一般以WEB-INF\classes为当前目录,因为-cn表示类名,该类名需要包含完整的包名

 且改命令需要找到.class文件),

 

执行命令: 

 

%AXIS2_HOME%\bin\java2wsdl -o build -of TestAdb.wsdl  -sn TestAdb -cn test.adb.theinterface.ITestAdb

 

-o build 表示在当前文件夹下面,新建一个build文件夹,生成的wsdl文件放到这个build文件夹下面

-of TestAdb.wsdl 指定生成的wsdl文件名为TestAdb.wsdl

-sn TestAdb 表示服务名称为TestAdb

-cn 表示类名,需要完整包名

 

%AXIS2_HOME%中的AXIS2_HOME是事先创建的指向axis2版本根目录的环境变量.

 

命令参数详情参考: http://jackyin5918.iteye.com/blog/1908559

 

执行上面的命令后,就得到了下面的wsdl文件:

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:ns="http://theinterface.adb.test" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" targetNamespace="http://theinterface.adb.test">
    <wsdl:types>
        <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://theinterface.adb.test">
            <xs:element name="setName">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element minOccurs="0" name="args0" nillable="true" type="xs:string"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="getName">
                <xs:complexType>
                    <xs:sequence/>
                </xs:complexType>
            </xs:element>
            <xs:element name="getNameResponse">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element minOccurs="0" name="return" nillable="true" type="xs:string"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
        </xs:schema>
    </wsdl:types>
    <wsdl:message name="getNameRequest">
        <wsdl:part name="parameters" element="ns:getName"/>
    </wsdl:message>
    <wsdl:message name="getNameResponse">
        <wsdl:part name="parameters" element="ns:getNameResponse"/>
    </wsdl:message>
    <wsdl:message name="setNameRequest">
        <wsdl:part name="parameters" element="ns:setName"/>
    </wsdl:message>
    <wsdl:portType name="TestAdbPortType">
        <wsdl:operation name="getName">
            <wsdl:input message="ns:getNameRequest" wsaw:Action="urn:getName"/>
            <wsdl:output message="ns:getNameResponse" wsaw:Action="urn:getNameResponse"/>
        </wsdl:operation>
        <wsdl:operation name="setName">
            <wsdl:input message="ns:setNameRequest" wsaw:Action="urn:setName"/>
        </wsdl:operation>
    </wsdl:portType>
    <wsdl:binding name="TestAdbSoap11Binding" type="ns:TestAdbPortType">
        <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
        <wsdl:operation name="getName">
            <soap:operation soapAction="urn:getName" style="document"/>
            <wsdl:input>
                <soap:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="setName">
            <soap:operation soapAction="urn:setName" style="document"/>
            <wsdl:input>
                <soap:body use="literal"/>
            </wsdl:input>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:binding name="TestAdbSoap12Binding" type="ns:TestAdbPortType">
        <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
        <wsdl:operation name="getName">
            <soap12:operation soapAction="urn:getName" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="setName">
            <soap12:operation soapAction="urn:setName" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:binding name="TestAdbHttpBinding" type="ns:TestAdbPortType">
        <http:binding verb="POST"/>
        <wsdl:operation name="getName">
            <http:operation location="getName"/>
            <wsdl:input>
                <mime:content type="application/xml" part="parameters"/>
            </wsdl:input>
            <wsdl:output>
                <mime:content type="application/xml" part="parameters"/>
            </wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="setName">
            <http:operation location="setName"/>
            <wsdl:input>
                <mime:content type="application/xml" part="parameters"/>
            </wsdl:input>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:service name="TestAdb">
        <wsdl:port name="TestAdbHttpSoap11Endpoint" binding="ns:TestAdbSoap11Binding">
            <soap:address location="http://localhost:8080/axis2/services/TestAdb"/>
        </wsdl:port>
        <wsdl:port name="TestAdbHttpSoap12Endpoint" binding="ns:TestAdbSoap12Binding">
            <soap12:address location="http://localhost:8080/axis2/services/TestAdb"/>
        </wsdl:port>
        <wsdl:port name="TestAdbHttpEndpoint" binding="ns:TestAdbHttpBinding">
            <http:address location="http://localhost:8080/axis2/services/TestAdb"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

 2.3 根据wsdl文件生成webservice服务代码骨架

 

通过 wsdl2java命令,生成骨架代码:

 

%AXIS2_HOME%\bin\wsdl2java -uri build/TestAdb.wsdl -p test.adb.service -d adb -s -ss -sd -ssi -o build\code

 

-uri build/TestAdb.wsdl 指定wsdl文件

-p 指定生成的代码 所在的包名

-d adb 指定绑定方式为 adb, 合法的方式为adb, xmlbeans, jibx and jaxbri (Default: adb).

-s 指创建代码使用 同步方式(阻塞方式)

-ss 指创建服务端代码骨架

-sd 指定需要创建services.xml

-ssi 指给服务代码java类创建一个interface

-o 指定生成文件的存放目录

 

2.4 将生成的代码拷贝到工程目录中.

 

生成的代码文件目录结构如下,

 

 

 

将resources, src 文件夹和build.xml文件拷贝到 web工程的根目录下,

这里的web工程时TestWebService,

所以将上面的resources, src 文件夹和build.xml文件都拷贝到TestWebService目录下.

拷贝后目录结构如下:

 

只关注展开的两个包即可.可以看到生成的文件.