基于axis1.4的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的形式作为入参
RequestBean.java
|
package com.webservice.request;
public class RequestBean {
private String msg;
public String getMsg() { return msg; }
public void setMsg(String msg) { this.msg = msg; } } |
2.写一个方法类，以bean的形式作为回参
ResultResponse.java
|
package com.webservice.respone;
public class ResultResponse {
private int code;
private String errorMsg;
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; } }
|
3.写一个方法类service，以上面两个bean作为入参和回参
BusinessService.java
|
package com.webservice.service;
import com.webservice.request.RequestBean; import com.webservice.respone.ResultResponse;
public class BusinessService {
public ResultResponse send(RequestBean requestBean)
{ ResultResponse res = new ResultResponse();
try { String msg = requestBean.getMsg(); System.out.println("收到消息:" + msg);
if (null != msg && !"".equals(msg)) { res.setCode(0); res.setErrorMsg("ok"); } else { res.setCode(-1); res.setErrorMsg("msg is null"); } } catch (Exception e) { res.setCode(-1); res.setErrorMsg("exception:" + e.getMessage()); } return res; } } |
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:RequestBean" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.request.RequestBean" /> <beanMapping qname="myNS:ResultResponse" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.respone.ResultResponse" /> </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.my.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); // 传参数bean RequestBean requestBean = new RequestBean(); requestBean.setMsg("wwww.servyou.com.cn"); // requestBean.setMsg("");
// 发送并接收返回的结果 ResultResponse resp = client.send(requestBean); System.out.println("消息已发送...");
int code = resp.getCode(); String errorMsg = resp.getErrorMsg();
System.out.println("消息已返回，code=" + code + ",errorMsg=" + errorMsg); } }
|
