基于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);     } }