【旧文】web service与axis(二)

四、利用axis开发服务端web服务

在跟其他公司合作完成一个大的项目的过程中，有时候对方的程序需要从我们的程序读取某些数据，通过web服务给对方提供服务是选择之一。要从头建立一个能够给对方提供web服务的应用，需要如下的步骤：

1. 新建web应用

按照J2EE规范在%CATALINA_HOME%\webapps新建一个应用，如webserviceTest；

2. 在web应用中配置axis

将%AXIS_HOME%\lib下的各个jar包拷贝到%CATALINA_HOME%\webapps\webserviceTest\WEB-INF\lib下；

将%AXIS_HOME%\WEB-INF下的web.xml拷贝到%CATALINA_HOME%\webapps\webserviceTest\WEB-INF下；

这两个操作相当于在我们的web应用程序中配置了Axis。

3. 编写提供web服务的java类

这个java类跟我们平时用到的java类没有任何不同，需要提供给他人的服务对应该java类的方法。在我们的示例中，提供web服务的java类如下：

package com.ufgov.webservice;

public class WsTest {

       public WsBean getWsBean(String name,int age){

              WsBean wsBean = new WsBean();

              wsBean.setAge(age);

              wsBean.setName(name);

              return wsBean;

       }

       public String getName(){

              return new WsBean().getName();

       }

}

 

在这个类中，提供了两个方法getWsBean()、getName()，其中getWsBean()方法返回一个自定义的对象：

package com.ufgov.webservice;

public class WsBean {

       private String name;

       private int age;

       public WsBean(){

              name = "WsTest";

              age = 20;

       }

       public String getName() {

              return name;

       }

       public void setName(String name) {

              this.name = name;

       }

       public int getAge() {

              return age;

       }

       public void setAge(int age) {

              this.age = age;

       }

}

 4. 编写deploy.wsdd文件

在%CATALINA_HOME%\webapps\webserviceTest\WEB-INF下新建deploy.wsdd文件，内容如下：

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> 

       <handler name="print" type="java:LogHandler"/> 

       <service name="wstest" provider="java:RPC">

              <requestFlow>

                     <handler type="print"/>

              </requestFlow>

              <parameter name="className" value="com.ufgov.webservice.WsTest"/>

              <parameter name="allowedMethods" value="*"/> 

       </service>

</deployment>

 在deploy.wsdd文件中，配置了一个service元素，name属性为wstest，表明我们的web服务名称为wstest。其中className参数是你的想部署的类名（全名），allowedMethods是调用的服务的方法，如果有多个方法的话可以用空格分开（如： <parameter name="allowedMethods" value="getStr  getMoney"/>),当用*的时候表示全部。

在deploy.wsdd文件中，还配置了一个handler，用到的LogHandler如下：

import org.apache.axis.AxisFault;

import org.apache.axis.Handler;

import org.apache.axis.MessageContext;

import org.apache.axis.handlers.BasicHandler;

import java.util.Date;

public class LogHandler extends BasicHandler {

       public void invoke(MessageContext msgContext) throws AxisFault{

              /** Log an access each time 

              we get invoked.

              */

              try {

                     Handler serviceHandler = msgContext.getService();

                     Integer numAccesses = (Integer)serviceHandler.getOption("accesses");

                     if (numAccesses == null)

                            numAccesses = new Integer(0);

                     numAccesses = new Integer(numAccesses.intValue() + 1);

                     Date date = new Date();

                     String result = date + ": service " + msgContext.getTargetService() + " accessed " + numAccesses + " time(s).";

                     serviceHandler.setOption("accesses", numAccesses);

                     System.out.println(result);

              } catch (Exception e){

                     throw AxisFault.makeFault(e);

              }

       }

}

 注意：很多网上文章里介绍deploy.wsdd文件时都没有提到handler元素和requestFlow元素，可能是axis版本不一致导致的，在我用到的axis1.4里，如果不配置handler，启动Tomcat时就会报错。另外，我怀疑直接使用axis自带的handler可能也可以，没有试过。

5. 发布web服务

编译所有的java类，并将class文件拷贝到%CATALINA_HOME%\webapps\webserviceTest\WEB-INF\classes文件夹下，确保Tomcat已经启动，DOS窗口下进入%CATALINA_HOME%\webapps\webserviceTest\WEB-INF目录，运行如下命令生成server-config.wsdd：

java org.apache.axis.client.AdminClient deploy.wsdd -p8090

如果屏幕上出现：

Processing file deploy.wsdd

<Admin>Done processing</Admin>

表示成功，在%AXIS_HOME%\WEB-INF下会找到server-config.wsdd文件，拷贝到%CATALINA_HOME%\webapps\webserviceTest\WEB-INF下，重新加载webserviceTest应用，现在访问http://localhost:8090/webserviceTest/services/wstest?wsdl ，会出现一个页面包含XML代码，这个就是我们web服务的WSDL文件，如果其他的人要访问我们的web服务，必须知道该WSDL的URL。

6. 关于生成server-config.wsdd文件的几点说明

Ø         因为我的tomcat端口已经改为8090，所以在命令的最后有 -p8090参数，如果你的tomcat端口没有改变，只需运行java org.apache.axis.client.AdminClient deploy.wsdd即可。

Ø         如果在前面配置环境变量时，没有在CLASSPATH 中加入% AXIS_LIB %下的各个jar包，也可以通过如下命令生成server-config.wsdd：

Java -Djava.ext.dirs=lib org.apache.Axis.client.AdminClient deploy.wsdd

Ø         许多网上文章上介绍生成server-config.wsdd文件时使用如下命令：

java org.apache.axis.client.AdminClient -l http://localhost:8090/webserviceTest/services/wstest deploy.wsdd

        这种情况下，server-config.wsdd文件应该自动在%CATALINA_HOME%\webapps\webserviceTest\WEB-INF下生成，但是我还没试成功。

Ø         如果在web服务里需要传输自定义对象，还需对生成的server-config.wsdd文件进行修改，注册自定义对象的序列化/反序列化器，具体来说，就是找到如下代码：

<service name="wstest" provider="java:RPC">

  <requestFlow>

   <handler type="print"/>

  </requestFlow>

  <parameter name="allowedMethods" value="*"/>

  <parameter name="className" value="com.ufgov.webservice.WsTest"/>

 </service>

 修改为：

<service name="wstest" provider="java:RPC">

  <requestFlow>

   <handler type="print"/>

  </requestFlow>

  <parameter name="allowedMethods" value="*"/>

  <parameter name="className" value="com.ufgov.webservice.WsTest"/>

<beanMapping languageSpecificType="java:com.ufgov.webservice.WsBean" qname="ns:WsBean" xmlns:ns="urn:BeanService"/>

 </service>

 注意service/beanMapping的定义。languageSpecificType中定义使用那个类, qname定义类的名称。

（未完待续……）