axis WebService

   一、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.javaeye.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;
	}
}