使用Axis开发WebService
1.下载并安装Axis
1)登录http://axis.apache.org/axis/站点下载Axis
下载axis-bin-1_4.zip,解压后的目录结构以下:
2)安装Axis
首先要成功的安装Tomcat,而后将下载的Axis目录下面的webapps中的axis的
整个文件夹所有拷贝到Tomcat安装目录的Webapps下面
启动Tomcat,在浏览器中输入http://localhost:8080/axis以后
显示的界面以下:
Axis安装完毕。
2.开发WebService
1)即时发布的WebService
即时发布提供了一种很是简单的发布方式,发布者只要有Java源代码,而后把其后缀名改为jws,拷贝到%Tomcat_HOME%\webapps\axis下即完成了发布工做。
a)服务端代码:文件名SayHelloServer.java
- public class SayHelloServer {
-
- ublic String getName(String name){
- return "hello "+name;
-
- }
把SayHelloServer.java文件改成SayHelloServer.jws而后拷贝到%Tomcat_HOME%\webapps\axis目录下,启动Tomcat后访问http://locahost:8080/axis/SayHelloServer.jws能够看到Click to see the WSDL的超连接
说明服务器端已经发布成功,下面开始编写Client端代码。
b)客户端代码:
- package com.wl.webservice.test;
-
- import javax.xml.namespace.QName;
-
- import org.apache.axis.client.Call;
- import org.apache.axis.client.Service;
-
- public class SayHelloClient {
-
-
-
-
- public static void main(String[] args) {
-
-
- try {
- String endpoint="http://localhost:8080/axis/TestClient.jws";
- Service service=new Service();
- Call call=null;
- call=(Call)service.createCall();
- call.setOperationName(new QName(endpoint,"getName"));
- call.setTargetEndpointAddress(new java.net.URL(endpoint));
- String ret=(String)call.invoke(new Object[]{"zhangsan"});
- System.out.println("return value is "+ret);
- } catch (Exception e) {
-
- e.printStackTrace();
- }
- }
-
- }
执行客户端的代码结果以下:
总结:即时发布很简单,可是有不少弊端,假如你如今只有.class或者一个jar包,jws就再也不能知足你的需求了,最重要的是即时发布不支持带包的类。
2)定制发布的WebService
定制发布比即时发布更加繁琐和复杂,可是换来的是更大的灵活性。定制发布须要你本身编写一个WSDD(Web Service Deployment Descriptor)文件。
a)服务器端代码:
- package com.wl.webservice.test;
-
- public class HelloWorldWsdd {
-
- public String hello(String name){
- return "hello "+name;
- }
- }
这是一个带包的很简单的类,编译好以后将class文件拷贝到%Tomcat_HOME%\webapps\axis\WEB-INF\classes目录下
css
记得要拷贝class的包名,否则会报错
java
b)接下来就是编写发布文件deploy.wsdd,在%TOMCAT_HOME%\webapps\axis\WEB-INF目录下创建这个文件而且在其中添加以下内容:
- <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
- <service name="HelloWorldWsdd" provider="java:RPC">
- <parameter name="className" value="com.wl.webservice.test.HelloWorldWsdd"/>
- <parameter name="allowedMethods" value="hello"/>
- </service>
- </deployment>
这个wsdd文件是一个标准的XML文件,包含三个元素:
<deployment>元素制定了wsdd所用的XML命名空间,是这个文件的根。
<service>元素制定了一项SOAP服务。它有两个属性。name指定了这个服务的惟一标志符,provider指定了实现的语言及服务方式。一个wsdd文件可能有多个<service>元素。
<parameter>指定了服务详细信息,是一组name/value对应的值。其中,clcssName指定了实现这个服务的类的名字,allowedMethods指定了这个服务暴露的方法列表。
其中的com.wl.webservice.test是包的名称。
打开cmd命令窗口,进入%Tomcat_HOME%\webapps\axis\WEB-INF目录下面输入以下命令:
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -l http://localhost:8080/axis/services/AdminService deploy.wsdd
或者
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient deploy.wsdd
执行结果以下:
控制台返回Processing file deploy.wsdd 和Done processing 说明发布成功。
而且会在同一级别目录下生成一个service-config.wsdd文件。
发布成功以后,能够经过访问http://localhost:8080/axis/servlet/AxisServlet来查看全部的定制发布的服务。
可是我在经过http://localhost:8080/axis/servlet/AxisServlet查看的时候,页面报一些错误:
出错的缘由是:我建立的这个HelloWorldWsdd服务是有包名称com.wl.webservice.test
解决方法:在%Tomcat_HOME%\webapps\axis\WEB-INF\classes下面建立目录com,在com下建立目录wl,在wl下建立目录webservice,在webervice下建立目录test,最后把HelloWorldWsdd.class文件再 拷贝到test目录下面。
从新http://localhost:8080/axis/servlet/AxisServlet查看结果:
备注:发布deploy.wsdd可能会出现的问题:
I)axis所须要的Jar包以下:
在部署deploy.wsdd的时候会报一个Unable to find required classes的信息,具体:
可是影响不大,要是去掉这个警告信息的话,还须要一个Jar包mail.jar,从相关网站下载后拷贝到%Tomcat_HOME%\webapps\axis\WEB-INF\lib下面,再次从新部署deploy.wsdd就不会再报上面的警告信息了。
参考:
http://blog.csdn.net/foamflower/archive/2008/09/08/2897501.aspx
II)在部署deploy.wsdd的时候Tomcat服务器须要开启,不然会报异常信息:
c)客户端代码以下:
- package com.wl.webservice.test;
-
- import javax.xml.namespace.QName;
-
- import org.apache.axis.client.Call;
- import org.apache.axis.client.Service;
-
- public class HelloWorldWsddClient {
-
- public static void main(String[]args){
-
- try {
- String uri="http://localhost:8080/axis/services/HelloWorldWsdd";
- Service service=new Service();
- Call call=(Call)service.createCall();
- call.setTargetEndpointAddress(uri);
- call.setOperationName(new QName(uri,"hello"));
- String result=(String)call.invoke(new Object[]{"wanglei and zhangsan"});
- System.out.println("result="+result);
- } catch (Exception e) {
-
- e.printStackTrace();
- }
- }
- }
执行客户端代码结果以下:
3.取消发布一个WebService
取消一个已经发布的WebService很简单,在发布的时候有个deploy.wsdd文件,那在取消发布的时候须要一个undeploy.wsdd文件便可。
- <undeployment xmlns="http://xml.apache.org/axis/wsdd/">
- <service name="HelloWorldWsdd" />
- </undeployment>
将这个文件拷贝到%Tomcat_HOME%\webapps\axis\WEB-INF目录下,而后再控制台输入命令:
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient undeploy.wsdd 运行结果: