WebService AXIS  学习笔记

 

一、概述

WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术。

二、Axis环境的安装

　　1、安装环境 J2SE SDK 1.4，Tomcat 5.0，eclipse 3.2。

　  2、到 http://xml.apache.org 网站下载Axis安装包。

3、将Axis相关包文件放在WEB-INF\lib目录下。

        

　　4、Axis可选的包：activation.jar； mail.jar； xmlsec-1.4.Beta1.jar，生成客户端时候需要使用。

　　Axis支持三种web service的部署和开发，分别为：

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

　　前两种方式我就不介绍了，建议使用Stubs方式，因此我就主要就介绍一下第三种方式。，我自己的Java源代码是放在D:\workspace\WebServiceAxis\src\目录下，Axis相关包文件放在D:\workspace\WebServiceAxis\webroot\WEB-INF\lib目录下。

二、编写wsdd发布web服务，编写stub client访问web服务

　1、编写服务端程序server，SayHello.java，编译server.SayHello.java

package server;

public class SayHello

{

    public String getName(String name)

    {

        return "hello "+name;

    }

}

3、发布服务：

　　编辑一个deploy.bat，Axis_Lib为axis.jar路径。内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib

set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%

set Axis_Servlet=http://localhost:8080/test/servlet/AxisServlet

说明：test为 放在Tomcat下的项目名称. AxisServlet必须要，不能变.

%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

 

4．you may need to copy your class files/tree into the right location (which depends on the servlet system you are using).; nested exception is: 

        java.lang.ClassNotFoundException: server.SayHello

 复制SayHello.class到depends on the servlet system you are using

 

执行这个批处理文件，这时候，如果提示成功的话，访问http://localhost:8080/axis/services 就会显示服务列表。

5、生成客户端client stub文件

　　在浏览器上访问服务器端的服务，可以下载到WSDL文件，通过Axis的相关工具，可以自动从WSDL文件中生成Web Service的客户端代码。

　　编写一个WSDL2Java.bat文件，其内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib

set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%

set Output_Path=D:\workspace\test\src

set Package=server.sayhello

%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl

　　执行这个批处理文件就可以生成client stub.

　　生成的stub client文件列表为：SayHello_PortType.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

6、编写客户端程序，编译并执行

　　下面是一段junit测试客户端代码。

import java.net.URL;

import junit.framework.Test;

import junit.framework.TestCase;

import junit.framework.TestSuite;

public class TestWSClient extends TestCase {

    public TestWSClient(String string) {

        super(string);

    }

    public void SayHelloClient() throws Exception {

        SayHelloService service = new SayHelloServiceLocator();

        SayHello_PortType client = service.getSayHello() ;

        String retValue = client.getName("clientname");

        System.out.println(retValue);

    }

    public static Test suite() {

        TestSuite suite = new TestSuite();

        suite.addTest(new TestWSClient("SayHelloClient"));

        return suite;

    }

}

　　至此，整个服务器端和客户端的Web Service框架代码就完成了，剩下的就是在里面加入你的业务代码了，怎么样，Web Service并不难开发吧。