今天开始,我们来一起学习一下 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!!
如果有兴趣,可以看看生成代码的结构,把很多共用性的东西都封装了起来。这里就先不说明了。以后再具体说明。