基于Axis1.4开发Web Service程序

随着 Web Services 以及 SOA 的不断发展，越来越多的人投入到了相关技术的实现、开发和标准的制定的工作中。而实现Web Services的主要途径由Axis1.x，Axis2.x以及XFire等技术。
这里提及Axis1.x是由于存在大量的旧项目中所用到的技术；Axis2是Apache Axis SOAP 项目的后继项目。此项目是 Web Services 核心引擎的重要改进，目标是成为 Web Services 和面向服务的体系结构（Service-Oriented Architecture，SOA）的下一代平台；而XFire是与Axis2并列的新一代WebService框架。

以下先摘录了Axis1.x的开发过程：
一、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拷贝到WEB-INF目录下，生成客户端时候需要使用。

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

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

　1、DII(Dynamic Invocation Interface )方式web服务主要方式是：
a 编写服务端程序HelloClient.java
b 将源码拷贝到Axis_HOME下，重命名为 HelloClient.jws
c 访问连接http://localhost:8080/Axis/HelloClient.jws?wsdl，页面显示Axis自动生成的wsdl
这种方式的局限性太大。

2、编写Dynamic Proxy方式访问服务
a 编写部署服务端程序，同上边DII方式，本次仍使用上边部署的HelloClient
b 编写代理接口
3 编写并执行客户端程序TestHelloClient.java 主要是通过调用Service专递endpoint和相关信息调用接口 大家可参照其他文章（http://www.iteye.com/topic/210733）。


3、Stubs方式（推荐使用）

　　我自己的Java源代码是放在D：\workspace\test\目录下，Axis相关包文件放在D：\workspace\test\WEB-INF目录下。

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

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

package server;

public class SayHello {
	public String getName(String name) {
		return "hello " + name;
	}
}

　2、编写wsdd文件

　　deploy.wsdd文件内容如下：

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

　　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    
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd 

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

　　4、生成客户端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.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

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

　　下面是一段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框架代码就完成了，剩下的就是在里面加入你的业务代码了。