本文主要记录Axis开发webservice简单实例的详细过程和步骤：
Axis官方网站：http://ws.apache.org/axis/
可以在官网下载最新1.4的包：axis-bin-1_4.zip
将解压后的axis-1_4\webapps\下的axis目录考到%TOMCAT_HOME%/Webapps/目录下
启动tomcat后在浏览器里输入http://localhost:8080/axis
点击上图中的Validataion链接,页面上会提示已经有的包和缺少的包的信息,根据提示将必须的包下载全，将这些类包复制到%tomcathome%/webapps/axis/WEB-INF/lib/目录下重新启动tomcat,直到Validation页面中看不到有Error与Warning的提示信息。
如果提示缺少xmlsec.jar可以到http://santuario.apache.org/dist/java-library/下载.
Axis支持三种web service的客户端访问方式，分别为：
- Dynamic Invocation Interface ( DII)
- Dynamic Proxy方式
- Stubs方式
一、JWS
JWS（Java Web Service）是最简单的一种方式。Axis允许把普通Java类的源文件的扩展名改为.jws，然后把它简单的copy到AXIS_HOME下。这样，Axis 会自动编译.jws文件，并把它自动加入到Java Web Servie的服务中。具体过程如下
1. 用Eclipse或者文本编辑器编写一个java类SayHello.java(此类不含包名)
public class SayHello{
public String sayMsg(String name){
return "Hello,"+name;
}
}
2. 将上面的类(SayHello.java)copy到%tomcat_home%/webapps/axis/目录下,只需要把类的源文件(不是class)到这个目录下,重命名为:SayHello.jws
3. 打开浏览器输入:http://localhost:8082/axis/SayHello.jws 会看到
点击上图Click to see the WSDL 的链接，就可以看到生成的wsdl。
4.客户端Dynamic Invocation Interface ( DII)方式实现如下：
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
/**
* axis client
* @author Michael sun
*/
public class TestClient {
/**
* @param args
* @throws Exception
*/
public static void main(String[] args) throws Exception {
String wsdlUrl = "http://localhost:8082/axis/SayHello.jws";
// String wsdlUrl=”http://localhost:8080/axis/SayHello.jws?wsdl”
Service s = new Service();
Call call = (Call) s.createCall();
call.setOperationName("sayMsg");// 这里是要调用的方法名
call.setTargetEndpointAddress(wsdlUrl);// 设置调用的wsdl
String val = (String) call.invoke(new Object[] { "My Michael Sun" });
System.out.println("这是webservice服务器返回的信息:" + val);
}
}
5.客户端Dynamic Proxy方式 实现如下：
二、WSDD(Web Service Deployment Descriptor）文件发布Web Service
1.自定义参数bean和server的代码如下：
package wsaxis.bean;
public class UserBean {
private String userName;
private Integer age;
public String getUserName() {
return userName;
}
public Integer getAge() { return age;
}
public void setUserName(String pUserName) {
userName = pUserName;
}
public void setAge(Integer pAge) {
age = pAge;
}
}
--------------------------------------------------------------------------------------------
package wsaxis;
import wsaxis.bean.UserBean;
/**
* axis server
* @author Michael sun
*/
public class MessageService {
/**
* getBeanStr
* @param bean
* @return String
*/
public String getBeanStr(UserBean bean) {
return "You Name:" + bean.getUserName() + " , You Age:" + bean.getAge();
}
/**
* checkUser
* @param bean
* @return String
*/
public String checkUser(UserBean bean) {
if ("Michael".equals(bean.getUserName())) {
return "Michael welcome to axis ";
} else {
return bean.getUserName() + " can't access this ws";
}
}
}
2.deploy.wsdd和undeploy.wsdd文件的编写如下：
WSDD文件描述可参见： http://www.oio.de/axis-wsdd/
<deployment name="test" xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="MessageService" provider="java:RPC" style="rpc" use="encoded">
<parameter name="className" value="wsaxis.MessageService"/>
<parameter name="allowedMethods" value="*"/>
<typeMapping xmlns:ns1="http://wsaxis.michael.com" qname="ns1:userBean"
type="java:wsaxis.bean.UserBean"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
/>
</service>
</deployment>
<undeployment
xmlns="http://xml.apache.org/axis/wsdd/">
<!-- Services from MessageService WSDL service -->
<service name="MessageService"/>
</undeployment>
3.将上面写好的两个类的class文件复制到%tomcat_home%/axis/WEB-INF/class/目录下,完整的目录结构复制过来,然后在把两个wsdd文件复制到%tomcat_home%/axis/WEB-INF/目录下,打开控制台进入%tomcat_home%/axis/WEB-INF/目录下：
>java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -p 8082 deploy.wsdd
-s参数指定了AxisServlet所在的应用程序路径
>java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -p 8082 -s /axis/servlet/AxisServlet deploy.wsdd
-l参数指定目标应用的URL
>java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient –lhttp://localhost:8082/axis/services/MessageService deploy.wsdd
这个命令就是发布这个服务,发布成功后在控制台下会有提示:
Processing file deploy.wsdd
<Admin>Done processing</Admin>
同时发布后会在%tomcat_home%/axis/目录下,多了一个server-config.wsdd文件.
在浏览器输入：http://localhost:8082/axis/services/MessageService
5.client的生成方法：
打开控制台进入 %tomcat_home%/axis/WEB-INF/目录下：
>java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java -p client http://localhost:8082/axis/services/MessageService?wsdl
会在当前的目录下生成client文件夹，这个目录里文件就是客户端源码。
6.通过WSDD文件卸载发布的webservice：
打开控制台进入 %tomcat_home%/axis/WEB-INF/目录下：
>java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient undeploy.wsdd
如果不是默认8080端口需要加上参数-p：
>java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -p 8082 undeploy.wsdd
PS:java -Djava.ext.dirs=lib 也可以用java -cp "lib\*"
7. 客户端Stub实现方式
import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.ser.BeanDeserializerFactory;
import org.apache.axis.encoding.ser.BeanSerializerFactory;
import stubclient.UserBean;
/**
* test stub client
* @author Michael sun
*/
public class TestStubClient {
/**
* @param args
* @throws Exception
*/
public static void main(String[] args) throws Exception {
QName qname = new QName("http://wsaxis.michael.com", "user");
Service s = new Service();
Call call = (Call) s.createCall();
// 注册这个bean为可序列化的.传递参数
call.registerTypeMapping(UserBean.class, qname,
new BeanSerializerFactory(UserBean.class, qname),
new BeanDeserializerFactory(UserBean.class, qname));
// 设置一下调用方法名.
call.setOperationName("getBeanStr");
// 设置一下这个服务的绝对路径.
call.setTargetEndpointAddress(new URL(
"http://localhost:8082/axis/services/MessageService?wsdl"));
// 实例化一个UserBean,这个UserBean是生成client的UserBean
UserBean u = new UserBean();
u.setAge(28);
u.setUserName("Michael");
// 通知方法,并返回结果
String str = (String) call.invoke(new Object[] { u });
System.out.println("web service 返回信息：" + str);
}
}
扫一扫
410
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
