Axis学习（一）

今天开始，我们来一起学习一下 Axis，我们以 Axis 1.4 版本为例。


一、准备环境：

　　1、Eclipse：http://www.eclipse.org/downloads/ 下载较新版本的 Eclipse，里面已经自带了WebService插件。

　　2、Axis1.4：下载 axis-bin-1_4.zip  文件。

　　3、JDK 1.6：这个就不用多说了。（1.6以前的版本也可以，不过运行时会有警告。）

　　4、Tomcat：这个也不多说了，5.0以上版本即可。


二、安装部署Axis：

　　1、解圧 axis-bin-1_4.zip文件，在解压目录中找到 webapps 文件夹中的 axis 目录，拷贝到 tomcat 的 webapps 下，然后启动 Tomcat 服务器。


　　2、在浏览器里输入 http://localhost:8080/axis ，如果看到欢迎页面，说明部署成功：

 

 

　　然后点击第一个链接 Validation，检查一下是否所需要的 jar 包全部存在。如果缺少一些 jar 包，会有以下提示：

 

 

 

 

　　如上图有一个错误。（上图出现的错误是因为 JDK 版本的问题，Tomcat 所用的 JDK 不是 1.6 以上版本。不会影响使用，但是要知道，我们可以用 Validation 链接来校验我们的环境是否正确。）如果没有错误，那们我们的环境就没有任何问题了。我们可以来做第一个 Webservice 了。

 

三、写服务端代码：

 

　　Axis 中，Webservice 的发布方式有两种，一种是以 JWS （即时发布），另一种是以 WSDD（定制发布）。JWS 比较简单，但是应用较少，很多时候，我们都是以 WSDD 方法发布我们的 Webservice。但是，我们还是从 JWS 发布开发说起。

 

　　先编写服务器端的代码，代码很简单，就对传入的“人名”说一句 hello。以下是服务器端（WSServer.java）代码：

 

/**
 * 服务器端代码，不能用包名，只能存在于 default 包下
 */
public class WSServer {

	public String sayHello(String name) {

		return name + ", hello!!";
	}
}

  

　　写好以后， WSServer.java 文件拷贝到 Tomcat 的 webapps\axis\ 目录下，改名为 WSServer.jws 。然后重启 Tomcat 服务器。

 

四、编写客户端代码：

 

　　1、由于代码比较简单，我们可以直接编写客户端代码（WSClient.java）：

 

import javax.xml.rpc.ParameterMode;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;

public class WSClient {
	public static void main(String[] args) throws Exception {
		String endpoint = "http://localhost:8080" + "/axis/WSServer.jws";
		Service service = new Service();
		Call call = (Call) service.createCall();
		call.setTargetEndpointAddress(new java.net.URL(endpoint));
		call.setOperationName("sayHello");
		call.addParameter("op1", XMLType.XSD_STRING, ParameterMode.IN);
		call.setReturnType(XMLType.XSD_STRING);
		String ret = (String) call.invoke(new Object[] { "World" });
		System.out.println(ret);
	}
}

  

　　写好后运行，得到输出结果：World, hello!!

 

　　2、利用 WSDL 文件编写客户代码：

 

　　访问 http://localhost:8080/axis/WSServer.jws 

 

 

　　在 Click to see the WSDL 处 右键另存为，把后缀改为 .wsdl 后保存。将保存后的 .wsdl 文件拷贝到 Eclipse 的工程目录下。如图：

 

 

　　

　　然后在 .wsdl 文件上，右键 ---> web serivec ---> Generate Client。如图：

 

 

 

　　然后点 finish ，生成客户端代码。这要比我们上面的代码复杂得多，也有了一些固定的结构。我们新建我们的测试代码 WSClient.java，内容如下：

 

 

import java.rmi.RemoteException;

import javax.xml.rpc.ServiceException;

import localhost.axis.WSServer_jws.WSServerServiceLocator;

public class WSClient {

	public static void main(String[] args) {

		WSServerServiceLocator lo = new WSServerServiceLocator();
		String ret = null;

		try {
			ret = lo.getWSServer().sayHello("tom");
			System.out.println(ret);
		} catch (RemoteException e) {
			// do something
		} catch (ServiceException e) {
			// do something
		}
	}
}

 

　　打印结果：tom, hello!!

 

　　如果有兴趣，可以看看生成代码的结构，把很多共用性的东西都封装了起来。这里就先不说明了。以后再具体说明。