使用axis开发java web service

在java平台开发web service，最方便、常用的方法是使用axis组件。首先，在axis官方站点下载axis；然后将压缩包中webapps目录下的axis文件夹拷贝到你本地web应用服务器的webapps目录下。这是我们的工作起点，可以开工了。。。

• 部署web service的方式一般有两种：

1. 编写java源文件，将文件的java后缀改为jws，然后部署到webapps/axis目录下，axia引擎可以直接执行源文件中定义的java方法为web service；另外，要让你的web应用服务器识别jws文件需要确定已在web.xml中配置servlet（如果你依照本文方法采用拷贝axis目录为工作起点的话，可以不考虑这步）：

<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-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>
2. 编写web service 部署描述文件（wsdd）。这种方法适用与手头没有java源文件或只需要发布java类中某些特定方法为web service的情况，而且还可以通过在wsdd文件中配置序列化、反序列化器，扩展SOAP定义的基本数据类型，使web service支持复杂数据类型、解决异构平台web service交互问题。可见，此种方法较jws方法更强大、可控。

具体过程可归结为如下两步:
1）. 部署classes和jar文件
2）. 通知axisEngine加载新服务

step1:

 在WEB-INF/classes目录下放置已编译的java class文件
 如果java代码已编译为jar文件，可以直接放到WEB-INF/lib下
step2:

编写deploy.wsdd文件，可以参考axis压缩包种samples\stock目录下的例子。下面是一个最简单的范例：

<deployment name="MyService1" xmlns="http://xml.apache.org/axis/wsdd/"
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 <service name="MyService1" provider="java:RPC">
  <parameter name="className" value="MyService1"/>
  <parameter name="allowedMethods" value="*"/>
 </service>
</deployment>

deploy.wsdd用来发布web service，aixs通常会将发布的服务(除jws文件定义的)保存到全局配置文件WEB-INF/server-config.wsdd中

执行java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService deploy.wsdd

定义AXISCLASSPATH环境变量，打开一个新的命令提示符窗口，输入下列命令(先定义环境变量，才能执行上面命令)：

set AXIS_HOME=c:\axis
set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar;%AXIS_LIB%\commons-logging.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

Trouble shooting:

1. 以上设置环境变量的命令如果直接拷贝本文给出的到你本地执行，注意你本地文件commons-discovery.jar和commons-logging.jar是否有版本号，如果有，以上命令需要做相应修改；

2. axis建议的XML parser为Xerces，环境变量给出的也使用这个，而不是java默认的Crimson parser，所以你可能需要到Xerces站点下载此组件，拷贝到WEB-INF/lib下；

3. 执行以上命令要先确保Tomcat已启动，否则会出现Connection refused错误。

4. 笔者lib目录下有的jar包为activation.jar axis.jar commons-discovery.jar commons-logging.jar jaxrpc.jar log4j-1.2.9.jar mail.jar NetComponents.jar portal-client.jar saaj.jar wsdl4j.jar xercesImpl.jar xml-apis.jar，共13个，可以对比你是否缺少，否则可能出现java.lang.NoClassDefFoundError错误。

顺便提一下，不执行AdminClient工具部署web service这步也行，替代的方法是直接编辑server-config.wsdd文件，然后重新启动web服务器。

• 取消已发布的web service：

编写undeploy.wsdd文件，内容如下

<undeployment xmlns="http://xml.apache.org/axis/wsdd/">  

      <service name="MyService1"/>  

</undeployment> 

 执行如下命令

 java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService undeploy.wsdd

参考：
http://ws.apache.org/axis/java/install.html#Introduction