webservice复杂类型实例
1.准备工作：
概念：SOAP（简单对象访问协议）、WSDL（web服务描述语言）、XML（可扩展标记语言）、axis（阿帕奇可扩展交互系统）
（1） 下载axis1.4，将axis1.4中的axis项目中WEB-INF\lib，将lib下的jar文件拷贝到工程如webservice的WEB-INF\lib下
（2） 将axis1.4中的axis项目，拷贝到tomcat的webapps目录下
（3） 配置Java和Tomcat环境,设置axis环境，类似jdk的配置方法，例如：
|
AXIS_HOME= E:\apache-tomcat-6.0.37-windows-x86\apache-tomcat-6.0.37\webapps\axis AXIS_LIB=%AXIS_HOME%\lib AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar （最后两个可能没有，不是必须的） |
（4） 配置web.xml添加
|
<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>Apache-Axis</display-name> <listener> <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class> </listener> <servlet> <servlet-name>AxisServlet</servlet-name> <display-name>Apache-Axis Servlet</display-name> <servlet-class> org.apache.axis.transport.http.AxisServlet </servlet-class> </servlet> <servlet> <servlet-name>AdminServlet</servlet-name> <display-name>Axis Admin Servlet</display-name> <servlet-class> org.apache.axis.transport.http.AdminServlet </servlet-class> <load-on-startup>100</load-on-startup> </servlet> <servlet> <servlet-name>SOAPMonitorService</servlet-name> <display-name>SOAPMonitorService</display-name> <servlet-class> org.apache.axis.monitor.SOAPMonitorService </servlet-class> <init-param> <param-name>SOAPMonitorPort</param-name> <param-value>5001</param-value> </init-param> <load-on-startup>100</load-on-startup> </servlet> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/servlet/AxisServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>*.jws</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> <servlet-mapping <servlet-name>SOAPMonitorService</servlet-name> <url-pattern>/SOAPMonitor</url-pattern> </servlet-mapping> <session-config> <session-timeout>5</session-timeout> </session-config> <mime-mapping> <extension>wsdl</extension> <mime-type>text/xml</mime-type> </mime-mapping> <mime-mapping> <extension>xsd</extension> <mime-type>text/xml</mime-type> </mime-mapping> <welcome-file-list id="WelcomeFileList"> <welcome-file>index.jsp</welcome-file> <welcome-file>index.html</welcome-file> <welcome-file>index.jws</welcome-file> </welcome-file-list> </web-app>
|
2.实战
1.业务方法类的入参bean
Request.java
|
package com.webservice.request;
import java.util.ArrayList; import java.util.List;
public class Request {
// 基本类型 private String msg;
// 基本类型 ，list会在客户端生成对象数组Object[] private List<Integer> list = new ArrayList<Integer>();
// 不要使用数组，因为要指定大小，应该使用list替代 // private String[] array;
public List<Integer> getList() { return list; }
public String getMsg() { return msg; }
public void setList(List<Integer> list) { this.list = list; }
public void setMsg(String msg) { this.msg = msg; }
}
|
2. 业务方法类的回参bean
Response.java
|
package com.webservice.respone;
import java.util.ArrayList; import java.util.List;
public class Response {
// 基本类型 private int code;
private String errorMsg;
// 基本类型 ，list会在客户端生成对象数组Object[] private List<Integer> list = new ArrayList<Integer>();
// 不要使用数组，因为要指定大小，应该使用list替代 // private String[] array;
public int getCode() { return code; }
public void setCode(int code) { this.code = code; }
public String getErrorMsg() { return errorMsg; }
public void setErrorMsg(String errorMsg) { this.errorMsg = errorMsg; }
public List<Integer> getList() { return list; }
public void setList(List<Integer> list) { this.list = list; }
}
|
3. 业务方法类service，以上面两个bean作为入参和回参
BusinessService.java
|
package com.webservice.service;
import java.util.List;
import com.webservice.request.Request; import com.webservice.respone.Response;
public class BusinessService {
public Response send(Request request)
{ Response response = new Response();
try { //接收基本类型信息 String msg = request.getMsg();
//接收list List<Integer> integerList = request.getList();
System.out.println("收到基本类型消息：msg=" + msg); System.out.println("收到List<Integer>类型消息：list=" + integerList);
//组织反馈 if (null != msg && !"".equals(msg)) { //设置错误码 response.setCode(0); //设置错误消息 response.setErrorMsg("调用成功"); //设置list response.setList(request.getList());
} else { response.setCode(-1); response.setErrorMsg("消息不能为空"); } } catch (Exception e) { response.setCode(-1); response.setErrorMsg("发生异常:" + e.getMessage()); } return response; } }
|
4.在工程的WEB-INF目录下 编写deploy.wsdd
主要用来定义service名字，描述service、入参、回参
|
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <service name="businessService" provider="java:RPC"> <parameter name="className" value="com.webservice.service.BusinessService" /> <parameter name="allowedMethods" value="*" /> <beanMapping qname="myNS:Request" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.request.Request" /> <beanMapping qname="myNS:Response" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.respone.Response" /> </service> </deployment> |
5. 在工程的WEB-INF目录下编写undeploy.wsdd
用来卸载webservice服务
|
<undeployment xmlns="http://xml.apache.org/axis/wsdd/"> <service name="businessService"/> </undeployment> |
6. 部署项目（启动tomcat），接下来发布接口（关键一步）
进入到tomcat的项目中的WEB-INF目录下，执行下列命令进行发布。会在此WEB-INF下生成server-config.wsdd文件（以后可以在此目录配置其他接口）
|
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -lhttp://192.168.30.143:8080/webservice/servlet/AxisServlet deploy.wsdd |
Ps：下面命令用于取消一个已经发布的服务
|
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -lhttp://192.168.30.143:8080/webservice/servlet/AxisServlet undeploy.wsdd |
7.获取wsdl（完成）
（1）重启tomcat，访问工程目录，如：http://192.168.30.143:8080/webservice/servlet/AxisServlet（其中webservice为工程名）
（2）可以看到新的服务方法businessService，点击一下，跳到wsdl内容页面，ctr+A拷贝到文本编辑器，去掉开头的空格，替换去掉所有开头的“-”为空（即将- <替换为<）;另存为businessService.wsdl，即可提供其他方使用，注意：如果部署在linux上，要访问linux的网页获取wsdl，不然可能会有问题。
-----------------------------------------------至此发布完毕------------------------------------------------
3.测试验证
1.根据wsdl生成客户端代码
（1）首先制作生成代码工具，方便以后重用；
在D:\webservice，放个axis1.4的包，创建一个批处理文件“wsdl生成java客户端文件.bat”，内容如下：根据实际情况配置
|
set Axis_Lib=D:\webservice\axis1.4\axis\WEB-INF\lib set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib% set Output_Path=D:\webservice\Testclient set Package=com.webservice.client %Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% D:\webservice\businessService.wsdl @echo -------------OK----------------- @echo ---The code has been created in the folder: Testclient--- @pause |
说明：蓝色部分根据实际情况调整
Axis_Lib 是axis1.4的lib位置
Output_Path是生成客户端代码存放位置
Package 是生成客户端代码所在包
最后是wsdl文件位置
（2）生成客户端代码
将wsdl文件，如businessService.wsdl放到D:\webservice下（上一步应该做了），执行文件“wsdl生成java客户端文件.bat”，即可生成客户端代码，在Testclient目录。
2.测试接口
将生成的客户端带拷贝到java或其他web工程的src下
建立测试java类，如Test.java,测试完成
|
public class Test { public static void main(String[] args) throws RemoteException, ServiceException, MalformedURLException { // BusinessServiceService为接口；BusinessServiceServiceLocator为接口实现类 BusinessServiceService service = new BusinessServiceServiceLocator(); // 设置要使用的接口服务地址:多用于动态调用不同服务器上的接口 URL portAddress = new URL( "http://192.168.30.143:8080/webservice/services/businessService"); BusinessService client = service.getbusinessService(portAddress);
Request requestBean = new Request();
// 传递简单类型 requestBean.setMsg("wwww.servyou.com.cn");
// 传递数组，最好先由list转化 List<Integer> list = new ArrayList<Integer>(); for (int i = 0; i < 10; i++) { list.add(i); } requestBean.setList(list.toArray());
// 调用webservice Response resp = client.send(requestBean); System.out.println("消息已发送...");
//接收返回结果 int code = resp.getCode(); String errorMsg = resp.getErrorMsg();
Object[] integerList = resp.getList();
System.out.println("收到消息:"); System.out.println("错误码 code="+code); System.out.println("消息 errorMsg="+errorMsg); System.out.println("收到List<Integer>类型消息：list=" + Arrays.toString(integerList)); } }
|
服务端运行结果：
|
收到基本类型消息：msg=wwww.servyou.com.cn 收到List<Integer>类型消息：list=[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] |
客户端运行结果：
|
消息已发送... 收到消息: 错误码 code=0 消息 errorMsg=调用成功 收到List<Integer>类型消息：list=[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] |
