这段时间重构一下原来的代码,把东西整理一下。这个为AXIS的整理
webService 是一种基于http协议的组件
webService 开发框架:AXIS(Apache eXtensible Interaction System),xFire,
WSDD就是WEB服务分布描述(Web Service Deployment Descriptor), 它定义了WEB服务的接口,如服务名、提供的方法、方法的参数等信息。
AXIS 发布的两种方式
一,即时发布 jws java web service 只要把.java 文件改成.jws文件,发布就可以了,但是不支持带包类
二,定制发布 wsdd web service Deployment Descriptor 这个发布需要配置文件server-config.wsdd文件
针对AXIS集成到Spring 的项目中。
一个简单的AXIS应用
1, 需要的jar 包
activation.jar
axis.jar
axis-ant.jar
commons-discovery.jar
commons-logging.jar
jaxrpc.jar
log4j-1.2.15.jar
mail.jar
wsdl4j.jar
spring.jar
.......
这里其他包就省略了
我用的框架是struts2+spring +.....
2, web.xml配置
<!-- axis webservice配置 start--> <servlet> <servlet-name>AdminServlet</servlet-name> <!-- <display-name>Axis Admin Servlet</display-name> --> <servlet-class> org.apache.axis.transport.http.AdminServlet </servlet-class> </servlet> <servlet> <servlet-name>AxisServlet</servlet-name> <!-- <display-name>Apache-Axis Servlet</display-name> --> <servlet-class> org.apache.axis.transport.http.AxisServlet </servlet-class> </servlet> <servlet> <servlet-name> SOAPMonitorService </servlet-name> <!-- <display-name>SOAP Monitor Service</display-name> --> <servlet-class> org.apache.axis.monitor.SOAPMonitorService </servlet-class> <init-param> <param-name>SOAPMonitorPort</param-name> <param-value>5001</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>*.jws</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>SOAPMonitorService</servlet-name> <url-pattern>/SOAPMonitor</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AdminServlet</servlet-name> <url-pattern>/servlet/AdminServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/servlet/AxisServlet</url-pattern> </servlet-mapping> <!-- axis webservice配置 end-->
3,定制webservice 服务端接口
(1) 接口类
package com.ot.test.service; import java.util.HashMap; import java.util.List; /** * 统一对外服务接口 * */ public interface ITest { public String test() throws Exception; }
(2)接口实现类
package com.ot.test.service; import java.util.HashMap; import java.util.List; /** * 统一对外服务接口 * */ public class TestImpl implements ITest { //todo private ITestDAO testDao; public String test() throws Exception { //todo 调用DAO testDao.test(); } }
这里针对DAO 就不在描述了,这个服务只是一个业务接口。
(3)定义一个针对Webservice 服务的接口实现
在 Spring 中对 Web Service 进行封装很简单,仅仅需要继承
org.springframework.remoting.jaxrpc.ServletEndpointSupport 类,实现里面的一些方法,包装一次,将其发布出来就可以。
package com.ot.test.service; import java.util.HashMap; import java.util.List; /** * 统一对外服务接口 * */ public class TestImplAdaptor extends ServletEndpointSupport implements ITest { //todo private ITest test; public String test() throws Exception { //todo 调用test test.test(); } }
以上已经定义好了服务端接口,下面需要对AXIS WEBSERVICE进行部署
(4)下面的部署我采用了ant 来部署的 ,其中一个重要的包axis-ant.jar现在需要了。
<?xml version="1.0" encoding="UTF-8" ?> <project name="testclient" default="tojar" basedir="../wsdl"> <property name="wsdl" value="test.wsdl" /> <path id="classpath"> <fileset dir="../WEB-INF/lib" includes="*.jar,*.zip" /> <fileset dir="D:\tomcat6.0\lib" includes="*.jar,*.zip" /> </path> <target name="copy" > <copy todir="${basedir}/test/src"> <fileset dir="../../src"> <include name="**\*.java" /> </fileset> </copy> </target> <!-- **********************************编译********************************** --> <target name="compile" description="Compile Java sources" depends="copy"> <javac srcdir="${basedir}/test/src" destdir="${basedir}/test/classes" optimize="yes" encoding="utf-8"> <classpath refid="classpath" /> <compilerarg value="-Xlint:none" /> </javac> </target> <target name="axis" depends="compile"> <taskdef resource="axis-tasks.properties" classpathref="classpath" /> <axis-java2wsdl classname="com.ot.service.ITest" location="http://localhost:8080/services/testService" namespace="http://service.ot.com" output="${wsdl}" style="RPC"> <classpath> <pathelement path="${basedir}/opf/classes" /> </classpath> </axis-java2wsdl> <axis-wsdl2java all="true" url="${wsdl}" deployscope="Request" output="${basedir}/client" serverside="true" skeletondeploy="false" testcase="true" noimports="false" typemappingversion="1.3"> </axis-wsdl2java> <delete file="${basedir}/client/service/ITestServiceLocator.java" /> <delete file="${basedir}/client/service/undeploy.wsdd" /> <delete file="${basedir}/client/service/deploy.wsdd" /> </target> <target name="tojar" depends="axis"> <javac destdir="${basedir}/classes" debug="on" optimize="on" classpathref="classpath"> <src path="${basedir}/client" /> </javac> <jar jarfile="../clientdate/testclient.jar"> <fileset dir="${basedir}/classes"> <include name="**/*.class" /> <exclude name="**/*Locator.class" /> </fileset> </jar> <delete dir="${basedir}/opf" /> </target> </project>
针对上面的ant build.xml文件要说明一下啊,整个过程就是把webservice中需要用到的实体对象,复制出来编译一下,提供给客户端使用webservice的用户。再webservice中复杂的对象,不是java基本类型的,wsdl无法直接转换,需要序列化。
这就是为什么要生成这个客户端,其中下面部分要重点说明一下,这也是这个部署的核心。通过axis-java2wsdl 是将webservice 接口生成相应的描述文件和客户端调用代码。执行后会多生成几个类,
ITest.java,ITestService.java,ITestServiceLocator.java,ITestSoapBindingStub.java ,以及undeploy.wsdd 和deploy.wsdd 以及test.wsdl 三个配置文件 但是我会把ITestServiceLocator.java 会删除了,原因是我在服务端自己定义了一个这样的类,目的是我可以自己修改服务单的地址,这样对于开发而言服务端地址改变不需要重新生成客户端代码。 undeploy.wsdd 和deploy.wsdd 两个文件是部署和取消部署的文件,这里我也不他们删除,我要手动定义这个文件
<target name="axis" depends="compile">
<taskdef resource="axis-tasks.properties" classpathref="classpath" />
<axis-java2wsdl classname="com.ot.service.ITest" location="http://localhost:8080/services/testService" namespace="http://service.ot.com" output="${wsdl}" style="RPC">
<classpath>
<pathelement path="${basedir}/opf/classes" />
</classpath>
</axis-java2wsdl>
<axis-wsdl2java all="true" url="${wsdl}" deployscope="Request" output="${basedir}/client" serverside="true" skeletondeploy="false" testcase="true" noimports="false" typemappingversion="1.3">
</axis-wsdl2java>
<delete file="${basedir}/client/service/ITestServiceLocator.java" />
<delete file="${basedir}/client/service/undeploy.wsdd" />
<delete file="${basedir}/client/service/deploy.wsdd" />
</target>
(5)服务器部署配置文件server-config.wsdd
<?xml version="1.0" encoding="UTF-8"?> <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <globalConfiguration> <parameter name="adminPassword" value="admin" /> <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl" /> <parameter name="disablePrettyXML" value="true" /> <parameter name="sendXsiTypes" value="true" /> <parameter name="sendMultiRefs" value="true" /> <parameter name="sendXMLDeclaration" value="true" /> <parameter name="axis.sendMinimizedElements" value="true" /> <parameter name="dotNetSoapEncFix" value="true" /> <parameter name="enableNamespacePrefixOptimization" value="false" /> <requestFlow> <handler type="java:org.apache.axis.handlers.JWSHandler"> <parameter name="scope" value="session" /> </handler> <handler type="java:org.apache.axis.handlers.JWSHandler"> <parameter name="scope" value="request" /> <parameter name="extension" value=".jwr" /> </handler> </requestFlow> </globalConfiguration> <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder" /> <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper" /> <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" /> <service name="AdminService" provider="java:MSG"> <parameter name="allowedMethods" value="AdminService" /> <parameter name="enableRemoteAdmin" value="false" /> <parameter name="className" value="org.apache.axis.utils.Admin" /> <namespace>http://xml.apache.org/axis/wsdd/</namespace> </service> <service name="Version" provider="java:RPC"> <parameter name="allowedMethods" value="getVersion" /> <parameter name="className" value="org.apache.axis.Version" /> </service> <service name="test" provider="java:RPC" style="rpc" use="encoded"> <parameter name="allowedMethods" value="*" /> <parameter name="scope" value="Request" /> <parameter name="className" value="com.ot.service.impl.TestImplAdaptor " /> <typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" qname="ns1:Object" serializer="org.apache.axis.encoding.ser.BeanSerializerFactory" type="java:java.lang.Object" xmlns:ns1="http://lang.java" /> <typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" qname="ns2:List" serializer="org.apache.axis.encoding.ser.BeanSerializerFactory" type="java:java.util.ArrayList" xmlns:ns2="http://util.java" /> <typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" qname="ns3:TestVO" serializer="org.apache.axis.encoding.ser.BeanSerializerFactory" type="java:com.ot.model.TestVO" xmlns:ns3="http://model.ot.com" /> </service> <transport name="http"> <requestFlow> <handler type="URLMapper" /> <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler" /> </requestFlow> </transport> <transport name="local"> <responseFlow> <handler type="LocalResponder" /> </responseFlow> </transport> </deployment>
指定好部署文件服务端已经全部构建好了,下面我们来构建客户端
(6)客户端有两种方式
(6-1) 客户端直接调用Webservice,就不需要刚才生成的***Locator.java 和 ***SoapBindingStub.java....等
import java.net.MalformedURLException;
import javax.xml.rpc.ServiceException;
import javax.xml.namespace.QName;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
public class WSTestServiceClient{
public static void main(String []args){
Service service = new Service();
try {
Call call = (Call) service.createCall();
String url = http://localhost:8080/services/testService?wsdl;
QName qname = new QName(url,"test");
call.setOperationName(qname);
call.setTargetEndpointAddress(new java.net.URL(url));
String result = (String) call.invoke(new Object[]{});
System.out.println("===="+result);
} catch (Exception e) {
e.printStackTrace();
}
}
}
(6-2) 就是通过刚才客户端定义的***Locator.java 和 ***SoapBindingStub.java....等方法来调用
客户端同样也增加了一个使用WEB SERVICE的接口,这样的目的是代码结构更完整。具体接口不再说明。。
主要是相应的spring 配置。看如何调用相应的web service
<!-- 调用服务配置 -->
<bean id="testAdaptor" class="org.springframework.aop.framework.ProxyFactoryBean"> <property name="targetSource" ref="axistestPoolTargetSource" /> <!--<property name="interceptorNames"> <list> <value>methodCachePointCut</value> <value>methodCachePointCutAdvice</value> </list> </property> --> </bean> <bean id="axistestPoolTargetSource" class="org.springframework.aop.target.CommonsPoolTargetSource"> <property name="targetBeanName" value="axistestServiceImpl" /> <property name="maxSize" value="30" /> </bean> <bean id="axistestServiceImpl" class="com.ot.client.impl.TestServcieAdaptor" singleton="false"> <property name="testService"> <bean class="org.springframework.beans.factory.config.MethodInvokingFactoryBean" > <property name="singleton"> <value>false</value> </property> <property name="targetObject"> <bean class="com.ot.client.ITestServiceLocator"> </bean> </property> <property name="targetMethod"> <value>getTestService</value> </property> </bean> </property> </bean>