axis在项目中配置
?
?
axis 1.4在项目中的配置(以下所有路径和代码都是以本人电脑上的为示例)
?
Axis支持三种web service的部署和开发,分别为:
?
1、Dynamic Invocation Interface —II)
?
2、Dynamic Proxy方式
?
3、Stubs方式
?
1 下载资源 axis1.4 jdk tomcat?
axis的下载地址:http://mirror.vmmatrix.net/apache/ws/axis/1_4/axis-bin-1_4.zip
? ?如果找不到,去http://ws.apache.org/axis/仔细找找。
? ?jdk和tomcat的地址就不说了。
?
2 新建两个Dynamic Web project项目 axisServer(服务提供方) 和 axisClient(接口适用方)
axisServer项目空间:D:\新的开始\workspace\workspace1
axisClient项目空间:D:\新的开始\workspace\workspace2
?
3 在项目中搭建axis环境 axisServer和axisClient都需要配置
?
a:添加需要的架包(以下架包可能有些事不需要的,暂时还没整理)
1 解压axis-bin-1_4.zip 拷贝lib下jar包到项目WEB-INF/lib下
2 查找 javax.jms.jar
3 查找 mailapi.jar?
4 查找 xmlsec-1.5.1.jar?
5 查找以上三个架包,并添加到项目WEB-INF/lib下
b:配置web.xml文件
1 在web.xml中添加以下配置 axisServer和axisClient都需要配置
<servlet> ??
? ?<servlet-name>AxisServlet</servlet-name> ??
? ? ?
? ?<servlet-class> ??
? ? ? ?org.apache.axis.transport.http.AxisServlet ??
? ?</servlet-class> ??
</servlet> ??
<servlet-mapping> ??
? ?<servlet-name>AxisServlet</servlet-name> ??
? ?<url-pattern>/servlet/AxisServlet</url-pattern> ??
</servlet-mapping> ??
?
<servlet-mapping> ??
? ?<servlet-name>AxisServlet</servlet-name> ??
? ?<url-pattern>*.jws</url-pattern> ??
</servlet-mapping> ??
?
<servlet-mapping> ??
? ?<servlet-name>AxisServlet</servlet-name> ??
? ?<url-pattern>/services/*</url-pattern> ??
</servlet-mapping>
4 axisServer发布服务
?
a 编写服务类结构如下
//domain对象
package com.server.domain;
public class Man {
private String name ;
private String age;
private int height;
public Man()
{
name = "sky";
age = "18";
height = 100;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAge() {
return age;
}
public void setAge(String age) {
this.age = age;
}
public int getHeight() {
return height;
}
public void setHeight(int height) {
this.height = height;
}
}
?
//service对象
package com.server.service;
import com.server.domain.Man;
public class LoveService {
public Man grow(Man man)
{
man.setHeight(man.getHeight()+1);
return man;
}
}
b 编写wsdd文件 deploy.wsdd 个人设定路径:WEB-INF/deploy.wsdd
<!-- 发布文件 -->
<deployment
? ?xmlns="http://xml.apache.org/axis/wsdd/"
? ?xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
? ?<service name="loveService" provider="java:RPC">
? ? ? ?
? ? ? ? ?<parameter ?name="className" value="com.server.service.LoveService"/>
? ? ? ? ?<parameter ?name="allowedMethods" value="*" />
? ? ? ? ?<beanMapping qname="myNS:Man" xmlns:myNS="urn:LoveService"
? ? ? ? ? ? ? languageSpecificType="java:com.server.domain.Man"/>
? ? ? ?
? ?</service>
?
</deployment>
c 编写发布.bat文件 deploy.bat 个人设定路径:WEB-INF/deploy.bat
set Axis_Lib=D:\新的开始\workspace\workspace1\axisServer\WebContent\WEB-INF\lib ?
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%?
set Axis_Servlet=http://localhost:8080/axisServer/servlet/AxisServlet?
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd?
说明: Axis_Lib:项目中axis架包的路径
Java_Cmd:java驱动
Axis_Servlet:发布服务的访问路径?
其中 /servlet/AxisServlet ,就是web.xml中配置的路径
<servlet-mapping> ??
? ?<servlet-name>AxisServlet</servlet-name> ??
? ?<url-pattern>/servlet/AxisServlet</url-pattern> ??
</servlet-mapping>
两者路径要一致。
deploy.wsdd:发布服务的wsdd文件
?
d 发布服务
执行deploy.bat文件
deploy.bat文件,如果想看到结果,可以通过cmd来执行
发布服务时,项目必须启动,不然会报connection refused
5 查看服务
在浏览器中输入:http://localhost:8080/axisServer/servlet/AxisServlet
如果看到以下显示,则说明服务发布成功:
And now... Some Services
?
loveService (wsdl)
grow
AdminService (wsdl)
AdminService
Version (wsdl)
getVersion
点击 wsdl可以查看服务的wsdl文件,根据wsdl文件可以生成客户端代码
?6 客户端访问
?a 根据wsdl文件生成客户端代码
?访问服务器接口地址:http://localhost:8080/axisServer/servlet/AxisServlet?
?点击页面wsdl链接进入服务wsdl页面 右击/另存为/wsdl.xml
?
?b 编写生成客户端代码.bat WEB-INF/WSDL2Java.bat
?set Axis_Lib=D:\新的开始\workspace\workspace1\axisServer\WebContent\WEB-INF\lib?
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%?
set Output_Path=D:\新的开始\学习笔记\axis学习
set Package=com.client
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% wsdl.xml
说明:
Axis_Lib :axis架包路径
Java_Cmd : Java驱动
Output_Path :客户端代码生成路径
Package : 包路径
wsdl.xml : 服务wsdl文件
c 执行 WSDL2Java.bat文件,生成客户端代码
d 把客户端代码考到客户端项目中,也可以直接生成到客户端项目中,只要看Output_Path的路径。
e 客户端代码访问
客户端接口代码包 com.client
具体的代码就不写了,axis自动生成的没啥好写的
客户端service代码,如下
//////////////////////////////Dynamic Proxy方式
package com.service;
import java.net.MalformedURLException;
import java.net.URL;
import java.rmi.RemoteException;
import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.ServiceException;
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 com.client.Man;
public class LoveClientService {
public static void main(String[] args)
{
try?
{
/*service 服务地址*/ ? ? ??
String serverUrl="http://localhost:8080/axisServer/services/loveService";?
Man man = new Man();
man.setHeight(100);
Service service=new Service();
Call call=(Call)service.createCall();
QName qn=new QName("urn:loveService","Man");
call.registerTypeMapping(Man.class,qn,new BeanSerializerFactory(Man.class,qn),new BeanDeserializerFactory(Man.class,qn));
call.setTargetEndpointAddress(new URL(serverUrl));
call.setOperationName(new QName("loveService","grow"));
call.addParameter("arg1",qn,ParameterMode.IN);
call.setReturnClass(Man.class);
Man resultBean=(Man)call.invoke(new Object[]{man});
System.out.println(resultBean.getHeight());
} catch (RemoteException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (ServiceException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (MalformedURLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
//////////////////////////////Stub方式
package com.service;
?
import java.rmi.RemoteException;
import javax.xml.rpc.ServiceException;
import com.client.LoveService;
import com.client.LoveServiceServiceLocator;
import com.client.Man;
public class LoveClientServiceStub {
哌
/**
* @param args
* @throws RemoteException?
*/
public static void main(String[] args){
// TODO Auto-generated method stub
try {
Man man = new Man();
man.setHeight(100);
LoveServiceServiceLocator locator = new LoveServiceServiceLocator();
LoveService service = locator.getloveService();
Man resultBean = (Man)service.grow(man);
System.out.println(resultBean.getHeight());
} catch (ServiceException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (RemoteException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
执行LoveClientService类main方法,可以看到控制台输出了101
即客户端生成了一个Man对象,设置体重 100
客户端调用服务端接口,服务端接受Man对象,并执行grow方法 ,Man体重增长了1
服务端返回Man对象
?
6 使用Handler
J2EE Web 服务中的Handler技术特点非常像Servlet技术中的Filter。说白了,就是监听器。
?
在Servlet中,当一个HTTP到达服务端时,往往要经过多个Filter对请求进行过滤,然后才到达提供服务的Servlet,
这些Filter的功能往往是对请求进行统一编码,对用户进行认证,把用户的访问写入系统日志等。
?
相应的,Web服务中的Handler通常也提供一下的功能:
对客户端进行认证、授权;
把用户的访问写入系统日志;
对请求的SOAP消息进行加密,解密;
为Web Services对象做缓存。
?
SOAP消息Handler能够访问代表RPC请求或者响应的SOAP消息。在JAX-RPC技术中,SOAP消息Handler可以部署在服务端,
也可以在客户端使用。?
?
实现Handler,可以实现org.apache.axis.Handle接口。也可以继承org.apache.axis.handlers. BasicHandler。
?
BasicHandler中的(MessageContext msgContext)方法是Handler实现类必须实现的方法,
它通过MessageContext来获得请求或者响应的SOAPMessage对象,然后对SOAPMessage进行处理。
//日志handler
a 编写handler对象?
包com.service.handler.LogHandler,主要功能:监听web服务被调用的次数。
package com.service.handler;
import org.apache.axis.AxisFault;
import org.apache.axis.Handler;
import org.apache.axis.MessageContext;
import org.apache.axis.handlers.BasicHandler;
/**
*?
* @author Administrator
*
*/
public class LogHandler extends BasicHandler{
/**
*?
*/
private static final long serialVersionUID = -2496628092698981957L;
@Override
public void invoke(MessageContext msgContext) throws AxisFault {
// TODO Auto-generated method stub
try {
String para = (String)getOption("para");
Handler handler = msgContext.getService();
Integer counts = (Integer)handler.getOption("counts");
if(counts == null)
{
counts = 0;
}
counts = counts + 1;
handler.setOption("counts", counts);
StringBuffer result = new StringBuffer(16);
result.append("web服务").append(msgContext.getTargetService());
result.append("共执行了").append(counts).append("次");
result.append("!系统参数para=").append(para);
System.out.println(result.toString());
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
throw AxisFault.makeFault(e);
}
}
}
b 编写服务wsdd deploy.wsdd 服务添加日志Handler?
<!-- 发布文件 -->
<deployment
? ?xmlns="http://xml.apache.org/axis/wsdd/"
? ?xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
? ?<service name="loveService" provider="java:RPC">
? ? ? ?
? ? ? ? ?<parameter ?name="className" value="com.server.service.LoveService"/>
? ? ? ? ?<parameter ?name="allowedMethods" value="*" />
? ? ? ? ?<beanMapping qname="myNS:Man" xmlns:myNS="urn:LoveService"
? ? ? ? ? ? ? languageSpecificType="java:com.server.domain.Man"/>
? ? ? ? ?<!--添加Handler -->
? ? ? ? ?<requestFlow>
? ? ? ? ?<handler name="logHandler" type="java:com.service.handler.LogHandler">
? ? ? ? ?<parameter name="para" value="sky" />
? ? ? ? ?</handler>
? ? ? ? ?</requestFlow>
? ? ? ?
? ?</service>
?
</deployment>
c 调用deploy.bat重新发布服务?
d 客户端检测,客户端每次调用web 接口,服务端控制台都会打印出如下信息:
web服务loveService共执行了1次!系统参数para=sky
web服务loveService共执行了2次!系统参数para=sky
//认证Handler 主要是axis自带的权限认证,估计没人用,因为测试了,所以带上吧
a 编写handler对象
包com.service.handler.AuthenticationHandler,主要功能:接口访问权限认证。
package com.service.handler;
?
import org.apache.axis.AxisFault;
import org.apache.axis.MessageContext;
import org.apache.axis.handlers.BasicHandler;
import org.apache.axis.security.AuthenticatedUser;
import org.apache.axis.security.SecurityProvider;
import org.apache.axis.security.simple.SimpleSecurityProvider;
/**
* 认证Handler
* @author Administrator
*
*/
public class AuthenticationHandler extends BasicHandler {
/**
*?
*/
private static final long serialVersionUID = 1L;
String securityProvider = "securityProvider";
String unauthenticated = "unauthenticated";
String authenticatedUser = "authenticatedUser";
? ?String cantAuth = "cantAuth";
@Override
public void invoke(MessageContext msgContext) throws AxisFault {
// TODO Auto-generated method stub
SecurityProvider provider = (SecurityProvider)msgContext.getProperty(securityProvider);
if (provider == null)
{
provider = new SimpleSecurityProvider();
msgContext.setProperty("securityProvider", provider);
}
if (provider != null)
{
String userId = msgContext.getUsername();
String pass = msgContext.getPassword();
AuthenticatedUser authUser = provider.authenticate(msgContext);
if (authUser == null)
{
throw new AxisFault(unauthenticated,"error", null, null);
}
//用户通过认证,把用户的设置成认证了的用户。
? ? ? ? ? ?msgContext.setProperty(authenticatedUser, authUser);
}
}
}
b 编写服务wsdd deploy.wsdd 服务添加权限认证Handler?
<!-- 发布文件 -->
<deployment
? ?xmlns="http://xml.apache.org/axis/wsdd/"
? ?xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
? ?<service name="loveService" provider="java:RPC">
? ? ? ?
? ? ? ? ?<parameter ?name="className" value="com.server.service.LoveService"/>
? ? ? ? ?<parameter ?name="allowedMethods" value="*" />
? ? ? ? ?<beanMapping qname="myNS:Man" xmlns:myNS="urn:LoveService"
? ? ? ? ? ? ? languageSpecificType="java:com.server.domain.Man"/>
? ? ? ? ?<!--添加Handler -->
? ? ? ? ?<requestFlow>
? ? ? ? ? ?<!-- 权限认证 -->
? ? ? ? <handler name="authen" type="java:com.service.handler.AuthenticationHandler"/> ?
? ? ? ? <!-- 日志 --> ? ? ??
? ? ? ? ?<handler name="logHandler" type="java:com.service.handler.LogHandler">
? ? ? ? ?<parameter name="para" value="sky" />
? ? ? ? ?</handler>
? ? ? ? ?</requestFlow>
? ? ? ?
? ?</service>
?
</deployment>
c?
WSDD文件配置详解:
<!-- 发布文件 -->
<deployment
? ?xmlns="http://xml.apache.org/axis/wsdd/"
? ?xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
? ?<service name="loveService" provider="java:RPC">
? ? ? ?
? ? ? ? ?<parameter ?name="className" value="com.server.service.LoveService"/>
? ? ? ? ?<parameter ?name="allowedMethods" value="*" />
? ? ? ? ?<beanMapping qname="myNS:Man" xmlns:myNS="urn:LoveService"
? ? ? ? ? ? ? languageSpecificType="java:com.server.domain.Man"/>
? ? ? ? ?<!--添加Handler -->
? ? ? ? ?<requestFlow>
? ? ? ? <handler name="authen" type="java:com.service.handler.AuthenticationHandler"/> ? ? ? ??
? ? ? ? ?<handler name="logHandler" type="java:com.service.handler.LogHandler">
? ? ? ? ?<parameter name="para" value="sky" />
? ? ? ? ?</handler>
? ? ? ? ?</requestFlow>
? ? ? ?
? ?</service>
?
</deployment>
<deployment>
告诉Axis Engine 这是一个部署描述文件。一个部署描述文件可以表示一个
完整的engine配置或者将要部署到一个活动active的一部分组件。
<GlobalConfiguration>
用于控制engine范围的配置。可以包含如下子元素:
<parameter>:用来设置axis的各种属性,可以配置任意数量的参数元素。
<role> : 设置一个SOAP actor/role URI,engine可以对它进行识别。这允许指向这个role的SOAP?
headers成功的被engine处理。任意数量.
<requestFlow> : 全局的请求Handlers。在调用实际的服务之前调用.
<responseFlow> : 全局响应Handlers,在调用完实际的服务后,还没有返回到客户端之前调用.
<requestFlow [name="name"] [type="type"] >
可以放置任意多个<handler> or <chain>在<requestFlow>中,但是可能只有一个<requestFlow>.
<responseFlow [name="name"] [type="type"] >
This is used to configure handlers in response flow.
?You may put any number of <handler> or <chain> elements (see below) inside the <responseFlow>,
?but there may only be one <responseFlow>.
?
<undeployment>
部署文档的根元素,用于指示Axis这是个卸载描述文件
<handler [name="name"] type="type">
位于顶层元素<deployment> or <undeployment>, or inside a <chain>, <requestFlow>, or <responseFlow>.
用于定义Handler,并定义handler的类型。"Type" 可以是已经定义的Handler或者是"java:class.name"形式的QName。
可选的"name"属性允许将这个Handler的定义在其他部署描述部分中引用。
可以包含任意数量的<parameter name="name" value="value">元素.
<handler name="logHandler" type="java:com.service.handler.LogHandler">
<parameter name="para" value="sky" />
</handler>
?
补充:
?
?
////生成服务端代码
?
set Axis_Lib=D:\新的开始\workspace\workspace1\axisServer\WebContent\WEB-INF\lib?
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%?
set Output_Path=D:\新的开始\学习笔记\axis学习
set Package=com.server
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% --server-side --skeletonDeploy true server.wsdl
?
////根据接口class文件生成wsdl文件
?
set Axis_Lib=D:\新的开始\workspace\workspace1\axisServer\WebContent\WEB-INF\lib?
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%?
?
%Java_Cmd% org.apache.axis.wsdl.Java2WSDL -o server.wsdl -l"http://localhost:8080/axisServer/servlet/AxisServlet" -n "urn:LoveService" -p"com.server.service" "urn:service" com.server.service.LoveService
?
//服务端调用service处理
?d) 完成服务端代码
??将服务端代码写到*impl.java 文件中
??SyncNotifySPSoapBindingImpl.java
??注意: 在一个基于B/S 的web 应用当中,为了完成业务代码,很多时候都会用到服务层代码。
??也就是说我们写接口的时候很少会孤立的去写一个服务端程序,既然要用到服务层代码,那么
??我们的问题就是如何在web应用获取一个单例的service层对象。
??首先声明一下,本应用采用的是基于spring的业务层架构。所以问题转换为如何在一个普通的java类
??中获取单例的bean.所谓普通的java类指没有与任何的servlet api 相耦合,但是它的加载需要web容器
??的支持。
??有几种解决方法:
??①实现接口ApplicationContextAware : 在spring初始化时,自动将application进行注入
???实现setApplicationContext(ApplicationContext applicationContext);
???例如:
???public class WebApplicationUtil implements ApplicationContextAware{
????private static ApplicationContext application;
????
????public void setApplicationContext(ApplicationContext applicationContext)
????throws BeansException {
?????application = applicationContext;
????}
????public static Object getBean(String beanName){
?????return application.getBean(beanName);
?????
????}
???}
??②继承自抽象类ApplicationObjectSupport
???不需要实现任何方法,直接通过getApplicationContext();即可获取
??③继承自抽象类WebApplicationObjectSupport
???类似②
??
??注意:>该工具类需要在spring配置文件中进行配置.<bean id="WebApplicationUtil" class="com.xjgs.util.WebApplicationUtil"></bean>
??????? >上述工具类使用的场景是在一个web 应用中,由web容器支持的普通java类中.?
???????? 而且该类的加载器必须是org.apache.catalina.loader.WebappClassLoader.
?
?
?
?
?