6. 使用Axis开发WebService程序

转自：http://www.itkeyword.com/doc/7529577946427268306/Apache-Servlet-WebSOAPWebService

所谓Web Service就是客户端以标准的SOAP消息将服务请求发给服务提供者，不论服务提供者用什么样的技术，Java、EJB、或者.NET执行相应的程序得到结果，然后将结果以SOAP消息返回给服务请求者。以axis为例，创建一个简单的Web Service

首先到http://ws.apache.org/axis/上去下载最新的axis版本。最新版本是axis-src-1_4.zip

NEWS (April 22, 2006): Axis 1.4 Final is now available!

第一步：创建WebService项目，命名为Webservice_Begin

解压axis-src-1_4.zip后，拷贝lib目录下最基本的jar包至项目WEB-INF/lib目录下，如下列表：

axis.jar

commons-discovery-0.2.jar

commons-logging-1.1.jar

jaxrpc.jar

mailapi_1_3_1.jar

wsdl4j-1.5.1.jar

junit-4.9-SNAPSHOT-20100512-0041.jar

第二步：创建WebService服务器端接口和实现类

1. package com.unis.p2p.server;
2. /**
3. * WebService服务器端业务逻辑接口
4. *
5. * @author Posey 2010-12-17
6. */
7. public interface Hello {
8. /**
9. * 接口方法：接收客户端WebService请求
10. *
11. * @author Posey 2010-12-17
12. * @param message
13. * @return
14. */
15. public String executeTaskList(String message);
16. }

1. package com.unis.p2p.server;
2. /**
3. * WebService服务器端业务逻辑实现类
4. * @author Posey 2010-12-17
5. *
6. */
7. public class HelloImpl implements Hello {
8. /**
9. * 接收客户端WebService请求，具体执行相关操作
10. *
11. * @author Posey 2010-12-17
12. */
13. public String executeTaskList(String message) {
14. return "OK|调用成功! " + message;
15. }
16. }

第三步：修改WEB-INF/web.xml配置文件

1. <?xml version="1.0" encoding="UTF-8"?>
2. <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
5. http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
6. <!-- ********************************************** -->
7. <!-- WebService核心处理类 -->
8. <servlet>
9. <servlet-name>AxisServlet</servlet-name>
10. <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
11. </servlet>
12. <servlet-mapping>
13. <servlet-name>AxisServlet</servlet-name>
14. <url-pattern>/services/*</url-pattern>
15. </servlet-mapping>
16. <!-- ********************************************** -->
17. <welcome-file-list>
18. <welcome-file>index.jsp</welcome-file>
19. </welcome-file-list>
20. </web-app>

第四步：创建WebRoot/WEB-INF/server-config.wsdd文件，定义服务的名称，具体的实现类，以及发布的方法和属性等等

1. <?xml version="1.0" encoding="UTF-8"?>
2. <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
3. <handler type="java:org.apache.axis.handlers.http.URLMapper" name="URLMapper" />
4. <service name="executeTask" provider="java:RPC">
5. <parameter name="className" value="com.unis.p2p.server.HelloImpl" />
6. <parameter name="allowedMethods" value="executeTaskList" />
7. </service>
8. <transport name="http">
9. <requestFlow>
10. <handler type="URLMapper" />
11. </requestFlow>
12. </transport>
13. </deployment>

第五步：启动应用服务器，发布Web Service服务。

地址栏输入：http://127.0.0.1:8080/Webservice_Begin/services回车，如果没有错误提示，则恭喜你，你的Web Service已经发布成功。

点击wsdl，还可以看到具体的wsdl的配置信息如下：

1. <?xml version="1.0" encoding="UTF-8" ?>
2. - <wsdl:definitions targetNamespace="http://127.0.0.1:8080/Webservice_Begin/services/executeTask" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://127.0.0.1:8080/Webservice_Begin/services/executeTask" xmlns:intf="http://127.0.0.1:8080/Webservice_Begin/services/executeTask" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
3. - <!--
4. WSDL created by Apache Axis version: 1.4
5. Built on Apr 22, 2006 (06:55:48 PDT)
6. -->
7. - <wsdl:message name="executeTaskListResponse">
8. <wsdl:part name="executeTaskListReturn" type="soapenc:string" />
9. </wsdl:message>
10. - <wsdl:message name="executeTaskListRequest">
11. <wsdl:part name="message" type="soapenc:string" />
12. </wsdl:message>
13. - <wsdl:portType name="HelloImpl">
14. - <wsdl:operation name="executeTaskList" parameterOrder="message">
15. <wsdl:input message="impl:executeTaskListRequest" name="executeTaskListRequest" />
16. <wsdl:output message="impl:executeTaskListResponse" name="executeTaskListResponse" />
17. </wsdl:operation>
18. </wsdl:portType>
19. - <wsdl:binding name="executeTaskSoapBinding" type="impl:HelloImpl">
20. <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" />
21. - <wsdl:operation name="executeTaskList">
22. <wsdlsoap:operation soapAction="" />
23. - <wsdl:input name="executeTaskListRequest">
24. <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://server.p2p.unis.com" use="encoded" />
25. </wsdl:input>
26. - <wsdl:output name="executeTaskListResponse">
27. <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://127.0.0.1:8080/Webservice_Begin/services/executeTask" use="encoded" />
28. </wsdl:output>
29. </wsdl:operation>
30. </wsdl:binding>
31. - <wsdl:service name="HelloImplService">
32. - <wsdl:port binding="impl:executeTaskSoapBinding" name="executeTask">
33. <wsdlsoap:address location="http://127.0.0.1:8080/Webservice_Begin/services/executeTask" />
34. </wsdl:port>
35. </wsdl:service>
36. </wsdl:definitions>

第六步：创建WebService客户端测试类

/Webservice_Begin/test/com/unis/p2p/client/WebServiceTest.java

1. package com.unis.p2p.client;
2. import java.net.URL;
3. import org.apache.axis.client.Call;
4. import org.apache.axis.client.Service;
5. import org.junit.Test;
6. /**
7. * 类说明:Client端测试类，发出请求
8. * @author Posey 2010-12-17
9. *
10. */
11. public class WebServiceTest {
12. @Test
13. public void testExecuteTask() throws Exception {
14. String res = "";
15. String ss = "ERR|2352|5683|2235|8428";
16. String[] str = ss.split("\\|");
17. String tempMsg = "";
18. for (int i = 1; i < str.length; i++) {
19. tempMsg += str[i] + ",";
20. }
21. tempMsg = tempMsg.substring(0, tempMsg.length()-1);
22. //调接口
23. res = this.executeTask("http://127.0.0.1:8080/Webservice_Begin/services/executeTask",
24. "executeTaskList",
25. new Object[]{ tempMsg });
26. System.out.println(res);    //输出结果
27. }
28. //核心处理方法
29. private synchronized String executeTask(String url, String method, Object[] args) throws Exception {
30. // 创建Service实例
31. Service service = new Service();
32. // 通过Service实例创建Call实例
33. Call call = (Call) service.createCall();
34. // 将WebService的服务路径加入到Call实例中，并为Call设置服务的位置
35. URL webServiceUrl = new URL(url);
36. call.setTargetEndpointAddress(webServiceUrl);
37. // 调用WebService方法
38. call.setOperationName(method);
39. // 调用WebService传入参数
40. String result = (String) call.invoke(args);
41. return result;
42. }
43. }

第七步：Run As - JUnit Test，执行成功