Axis通过wsdd部署Web Service

axis网上的教程很多，不过搜来搜去，总是只有那么几篇。仔细看了一下那几篇文章，都感觉到不是自己想要的，所以自己整理了一篇分享一下。

本文介绍axis应用的一个小例子，没有麻烦的命令行操作，只需照下面的步骤做就可以了。以下是详细的操作步骤。(注：本实例用的是axis，非axis2)

 

1. 1.       环境准备

l  MyEclipse 6.5

l  Tomcat 6

l  JDK 1.5

l  axis(非axis2)

 

1. 2.       新建web工程

新建一web工程，工程名称为axistest。新建完成后，导入下图所示的axis相关的jar包。

 

 

1. 3.       在web.xml中添加axis相关的配置信息

 

<servlet>
    <display-name>Apache-Axis Servlet</display-name>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
</servlet>

<servlet>
    <display-name>Axis Admin Servlet</display-name>
    <servlet-name>AdminServlet</servlet-name>
    <servlet-class>org.apache.axis.transport.http.AdminServlet</servlet-class>
    <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>AdminServlet</servlet-name>
    <url-pattern>/servlet/AdminServlet</url-pattern>
</servlet-mapping>

 

1. 4.       新建提供服务的Java类

在src下新建com包，在com包下新建HelloWorld类，HelloWorld的内容如下：

 

package com;

public class HelloWorld {

    public String sayHello(String msg){
        if(null==msg || "".equals(msg)){
            return "您好!";
        }else{
            return "您好" + msg + "!";
        }
    }

    public int sayAge(){
        return 28;
    }

}

  

1. 5.       配置server-config.wsdd

在WEB-INF下新建server-config.wsdd文件，内容如下：

 

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

    <!-- 处理器 -->
    <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper" />

    <!-- 一个服务 -->
    <!-- provider="java:RPC"  webservice是以javabean的形式提供的-->
    <service name="helloWorldService" provider="java:RPC">
        <!-- 指定类名 -->
        <parameter name="className" value="com.HelloWorld" />
        <!-- 类中允许访问的方法 -->
        <parameter name="allowedMethod" value="*"></parameter>
    </service>

    <!-- 指定处理器 -->
    <transport name="http">
        <requestFlow>
            <handler type="URLMapper"/><!-- 引用上边的 -->
        </requestFlow>
    </transport>

</deployment>

wsdd文件标签节点说明：

deployment：表明这是一个axis部署描述文件；

service：axis提供的一个web service服务。service标签中parameter allowedMethod用于指定一个以空格分隔的方法名，只有这些方法可以通过web service访问。也可以将这个值指定为“*”表示所有的方法都可以访问。

provider：服务类型，共有四种，分别是RPC,Document,Wrapped和Message。详见org.apache.axis.providers包的API文档；

parameter：用来设置Axis的各种属性；

requestFlow：局的请求Handlers，在调用实际的服务之前调用；

transport：定义了服务器端的传输方式

 

至此web service相关的东西已经配置好，此时工程的目录结构如下

 

 

 

 

1. 6.       部署到Tomcat测试

将工程发布到Tomcat,在浏览器里访问http://127.0.0.1:9999/axistest/services，如果出现如下页面，则表示web service部署成功

 

 

点击上面的wsdl链接，进入下图所示页面

 

注意上面的红圈的namespace，下面测试QName有用到。

 

1. 7.       客户端测试

在com包下新建测试类，名称为ClientTest,内容如下：

 

package com;

import java.NET.MalformedURLException;
import java.rmi.RemoteException;

import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceException;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

/**
 * @author 花非花雾非雾
 * @date 2010-12-24
 */
public class ClientTest {

    public static void main(String[] args) throws MalformedURLException, RemoteException {

        Service service = new Service();
        try {

            Call call = (Call) service.createCall();
            //设置地址
            call.setTargetEndpointAddress(new java.Net.URL("http://127.0.0.1:9999/axistest/services/helloWorldService?wsdl"));
            //设置要执行的方法
            call.setOperationName(new QName("http://com","sayHello"));
            //设置要传入参数,如果没有要传入的参数，则不要写这个
            call.addParameter("msg", org.apache.axis.Constants.XSD_STRING,javax.xml.rpc.ParameterMode.IN);
            //设置返回的类型
            call.setReturnType(org.apache.axis.Constants.XSD_STRING);

            String name = "花非花雾非雾";
            //执行，调用webservice
            String result = (String) call.invoke(new Object[]{name});
            System.out.println("返回的结果是："+result);

        } catch (ServiceException e) {
            e.printStackTrace();
        }
    }

}

  

如果一切正常，运行结果如下：

返回的结果是：您好花非花雾非雾!

 

参考资料:

1. axis 的官方资料