本文介绍如何开发一个基本的WebService,不涉及具体IDE.
首先,编写一个WSDL文件.
hello.wsdl
下面是定义的Web服务的名字,Axi2根据这个生成对应的服务端骨架类WebServiceSkeleton和客户端存根类WebServiceStub.location定义Web服务发布的路径.此处既是http://localhost:8080/services/WebService.
从上面可以看出,一个WSDL文件由TYPES, MESSAGE, PORTTYPE, BINDING, PORT, SERVICE 六部分组成.
其次,利用工具类生成服务端骨架类及消息对应的POJO等.
1.将hello.wsdl放入工程的resources目录下
2.创建工具类CodeGenerator
运行工具类,刷新工程,会在src目录下生成服务端骨架类及消息对应的POJO及资源文件.
[img]http://dl.iteye.com/upload/attachment/300219/c848872a-8748-3d94-af99-1dce65cbae4c.bmp[/img]
注意引入工程所依赖的包,推荐使用Maven.
最后,部署服务端:
在工程内导出JAR包,对应的lib中的JAR文件,资源文件.
[img]http://dl.iteye.com/upload/attachment/300221/000e2e4f-5b92-3c53-ade5-4c35cfc4c8cb.bmp[/img]
将导出的JAR包重命名为WebService.aar. 这是的名字注意与WSDL中定义的相同.
下载Aix2 Server,
[url="http://219.239.26.9/download/1615051/1709442/2/zip/68/224/1257570511428_224/axis2-1.5.1-bin.zip"]http://219.239.26.9/download/1615051/1709442/2/zip/68/224/1257570511428_224/axis2-1.5.1-bin.zip[/url]
解压并将WebService.aar部署到axis2-1.5.1\repository\services\目录下,启动Aix2 Server.运行axis2-1.5.1\bin\axis2server.bat.
打开浏览器,
[url="http://localhost:8080/axis2/services/"]http://localhost:8080/axis2/services[/url]
显示如下:
[img]http://dl.iteye.com/upload/attachment/300223/64420442-59e3-333c-a336-4b2043e8e05f.bmp[/img]
服务端已经成功部署.
接下来是客户端.
1. 在另一个工程中,创建resources目录,并将服务端的hello.wsdl复制过来.创建工具类生成客户端存根.
2. 编写测试类
3.运行测试类,在控制台输出测试结果为:
hello, bisoft!
4.去Aisx2服务端也会输出:
server recv: hello, bisoft!
Axis2服务端默认会生成异步与同步方法,因此异步处理只修改客户端即可.
异步处理客户端:
首先,编写一个WSDL文件.
hello.wsdl
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="hello" targetNamespace="http://www.bisoft.tl/hello/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://www.bisoft.tl/hello/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.bisoft.tl/hello/">
<xsd:element name="helloRequest">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="msg" type="xsd:string"></xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="helloResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="rtn" type="xsd:string"></xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:message name="helloRequest">
<wsdl:part name="helloRequest" element="tns:helloRequest"></wsdl:part>
</wsdl:message>
<wsdl:message name="helloResponse">
<wsdl:part name="helloResponse" element="tns:helloResponse"></wsdl:part>
</wsdl:message>
<wsdl:portType name="HelloService">
<wsdl:operation name="hello">
<wsdl:input message="tns:helloRequest"></wsdl:input>
<wsdl:output message="tns:helloResponse"></wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="binding1" type="tns:HelloService">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="hello">
<soap:operation soapAction="http://www.bisoft.tl/hello/hello" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="WebService">
<wsdl:port name="Port1" binding="tns:binding1">
<soap:address location="http://localhost:8080/services" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
下面是定义的Web服务的名字,Axi2根据这个生成对应的服务端骨架类WebServiceSkeleton和客户端存根类WebServiceStub.location定义Web服务发布的路径.此处既是http://localhost:8080/services/WebService.
<wsdl:service name="WebService">
<wsdl:port name="Port1" binding="tns:binding1">
<soap:address location="http://localhost:8080/services" />
</wsdl:port>
</wsdl:service>
从上面可以看出,一个WSDL文件由TYPES, MESSAGE, PORTTYPE, BINDING, PORT, SERVICE 六部分组成.
其次,利用工具类生成服务端骨架类及消息对应的POJO等.
1.将hello.wsdl放入工程的resources目录下
2.创建工具类CodeGenerator
package std.ws.util;
import org.apache.axis2.wsdl.WSDL2Code;
public class CodeGenerator {
public static void main(String[] args) throws Exception {
WSDL2Code.main
(
new String[]
{
"-ss",
"-sd",
"-S", "src",
"-R", "src/META-INF",
"-ns2p", "http://www.bisoft.tl/hello=tl.bisoft.hello",
"-uri", "resources/hello.wsdl"
}
);
System.out.println("Done!");
}
}
运行工具类,刷新工程,会在src目录下生成服务端骨架类及消息对应的POJO及资源文件.
[img]http://dl.iteye.com/upload/attachment/300219/c848872a-8748-3d94-af99-1dce65cbae4c.bmp[/img]
注意引入工程所依赖的包,推荐使用Maven.
最后,部署服务端:
在工程内导出JAR包,对应的lib中的JAR文件,资源文件.
[img]http://dl.iteye.com/upload/attachment/300221/000e2e4f-5b92-3c53-ade5-4c35cfc4c8cb.bmp[/img]
将导出的JAR包重命名为WebService.aar. 这是的名字注意与WSDL中定义的相同.
下载Aix2 Server,
[url="http://219.239.26.9/download/1615051/1709442/2/zip/68/224/1257570511428_224/axis2-1.5.1-bin.zip"]http://219.239.26.9/download/1615051/1709442/2/zip/68/224/1257570511428_224/axis2-1.5.1-bin.zip[/url]
解压并将WebService.aar部署到axis2-1.5.1\repository\services\目录下,启动Aix2 Server.运行axis2-1.5.1\bin\axis2server.bat.
打开浏览器,
[url="http://localhost:8080/axis2/services/"]http://localhost:8080/axis2/services[/url]
显示如下:
[img]http://dl.iteye.com/upload/attachment/300223/64420442-59e3-333c-a336-4b2043e8e05f.bmp[/img]
服务端已经成功部署.
接下来是客户端.
1. 在另一个工程中,创建resources目录,并将服务端的hello.wsdl复制过来.创建工具类生成客户端存根.
package std.ws.client.util;
import org.apache.axis2.wsdl.WSDL2Code;
public class CodeGenerator {
public static void main(String[] args) throws Exception {
WSDL2Code.main(new String[] {
"-S", "src",
"-R", "src/META-INF",
"-ns2p", "http://www.bisoft.tl/hello=tl.bisoft.hello",
"-uri", "resources/hello.wsdl" });
System.out.println("Done!");
}
}
2. 编写测试类
package std.ws.client;
import java.rmi.RemoteException;
import tl.bisoft.www.hello.WebServiceStub;
import tl.bisoft.www.hello.WebServiceStub.HelloRequest;
import tl.bisoft.www.hello.WebServiceStub.HelloResponse;
public class WSClient {
public static void main(String[] args) throws RemoteException {
String endpoint = "http://localhost:8080/axis2/services/WebService";
WebServiceStub stub = new WebServiceStub(endpoint);
HelloRequest request = new HelloRequest();
request.setMsg("hello, bisoft!");
HelloResponse reponse = new HelloResponse();
reponse = stub.hello(request);
String rtn = reponse.getRtn();
System.out.println(rtn);
}
}
3.运行测试类,在控制台输出测试结果为:
hello, bisoft!
4.去Aisx2服务端也会输出:
server recv: hello, bisoft!
Axis2服务端默认会生成异步与同步方法,因此异步处理只修改客户端即可.
异步处理客户端:
public class WSClient {
public static void main(String[] args) throws IOException {
String endpoint = "http://localhost:8080/axis2/services/WebService";
WebServiceStub stub = new WebServiceStub(endpoint);
HelloRequest request = new HelloRequest();
request.setMsg("hello, bisoft!");
WebServiceCallbackHandler callback = new WebServiceCallbackHandler() {
public void receiveResulthello(HelloResponse response) {
String rtn = response.getRtn();
System.out.println("async message!");
System.out.println(rtn);
}
};
stub.starthello(request, callback);
System.out.println("Please enter to exit!");
new BufferedReader(new InputStreamReader(System.in)).readLine();
}
}