用axis开发webservice实践
用axis开发webservice实践
李俊杰
什么是SOAP？
SOAP是一个基于XML的用于应用程序之间通信数据编码的传输协议。最初由微软和Userland Software提出，随着不断地完善和改进，SOAP很快被业界广泛应用。
什么是Axis?
Axis本质上就是一个SOAP引擎，提供创建服务器端、客户端和网关SOAP操作的基本框架。Axis目前版本是为Java编写的，不过为C++的版本正在开发中。
配置webservice具体步骤：
1. 安装weblogic。
2. 配置一个web应用，如“\\lijunjie\e$\software\bea\user_projects\domains\lijjdomain\applications\ cntapws “。
3. 从apache网站上下载axis-bin-1_2_1.tar.gz，解压后copy到cntapws下面。
4. 打开“http://localhost:7001/console“，配置cntapws 的web应用。
5. axis1.2和weblogic8.1有冲突，原因是weblogic 本身携带的webservice.jar使用的旧的javax.xml.soap.*,而不是像axis使用J2EE1.4新的版本。解决方案是在WEB-INF/weblogic.xml文件中如下的配置：
<weblogic-web-app>
<container-descriptor>
<prefer-web-inf-classes>true</prefer-web-inf-classes>
</container-descriptor>
</weblogic-web-app>
6. 按 http://localhost:8080/axis/happyaxis.jsp地址，可以显示你发布的webservice是否配置成功，如果显示必须的包缺失，则你的webservice不能正常运行。
开发webservice流程
1. 写普通的java类，该类中有你要发布到webservice上的有关方法。
2. 配置server-comfig.xml, 把你要发布的方法写入该文件。具体内容如下：
<?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.Directory" value="C:\eclipse\workspace\bookstore\WEB-INF\attachments"/>
<parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<parameter name="sendXsiTypes" value="true"/>
<parameter name="sendMultiRefs" value="true"/>
<parameter name="sendXMLDeclaration" value="true"/>
<parameter name="axis.sendMinimizedElements" value="true"/>
<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="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
<handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
<service name="Version" provider="java:RPC">
<parameter name="allowedMethods" value="getVersion"/>
<parameter name="className" value="org.apache.axis.Version"/>
</service>
<！--要配置的内容start，注意每一个要发布成webservice的类都要配置成一个service如下à
<service name="webserviceproxy" provider="java:RPC">
<parameter name="className" value="com.copia.webservice.server.proxy.WebServiceProxy"/>
<parameter name="allowedMethods" value="*"/>
<!—具体某个方法说明-->
<operation name="login" returnType="ns:LoginOutServiceBean">
<parameter name="branchNo" type="xsd:string"/>
<parameter name="userId" type="xsd:string"/>
<parameter name="password" type="xsd:string"/>
<parameter name="certificateNo" type="xsd:string"/>
</operation>
<!—如果该方法的参数有基本类型和对象类型，则不要声明，webservice能够找到相关的类及方法-->
<!—声明涉及到的所有类及其父类，引用类，还有它们的相关类，类似与对象树遍历，某个类声明缺失也会导致运行失败-->
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:LoginOutServiceBean"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.module.security.login.LoginOutServiceBean" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:User"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.client.User" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:GetBatchListInServiceBean"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.module.batch.service.GetBatchListInServiceBean" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:GetBatchListOutServiceBean"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.module.batch.service.GetBatchListOutServiceBean" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:BatchJobDefBean"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.module.batch.service.BatchJobDefBean" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:ValueObjectPage"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.voa.ValueObjectPage" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:ValueObjectColInfo"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.voa.ValueObjectColInfo" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:ValueObjectList"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.voa.ValueObjectList" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:PageInfo"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.voa.PageInfo" xmlns:ns="webserviceproxy"/>
<typeMapping deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns:ValueObjectMetaData"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:com.copia.core.voa.ValueObjectMetaData" xmlns:ns="webserviceproxy"/>
</service>
<！--要配置的内容endà
<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>
<transport name="local">
<responseFlow>
<handler type="LocalResponder"/>
</responseFlow>
</transport>
<transport name="http">
<requestFlow>
<handler type="URLMapper"/>
<handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
</requestFlow>
</transport>
</deployment>
3. 在地址栏输入http://localhost:7001/cntapws/services/webserviceproxy?wsdl，如没有什么错误，则表示你的webservice发布成功了。
Java webservice客户端编程
1. 启动你配置好的weblobic。
2. 进入dos界面，在你的临时目录（任意目录）下根据wsdl产生客户文件，如下指令：
E:\kk>java -Djava.ext.dirs=E:\software\bea\user_projects\domains\lijjdomain\appl
ications\axis\WEB-INF\axislib org.apache.axis.wsdl.WSDL2Java http://localhost:7001/cntapws/services/webserviceproxy?wsdl即可在kk目录下产生有关文件。
3. 把产生的文件copy到你的工程中，再写一个webservice调用测试类，如下：
public class TestWs {
public static void main(String[] args) {
WebServiceProxyService service = new WebServiceProxyServiceLocator();
try {
WebServiceProxy serviceProxy = service.getwebserviceproxy();
User user = new User();
user.setBranchNo("000001");
user.setClerkNo("1004");
GetBatchListInServiceBean in = new GetBatchListInServiceBean();
in.setCurPageNo(1);
String serviceName = "GetBatchListService";
GetBatchListOutServiceBean out = (GetBatchListOutServiceBean)serviceProxy.getBatchListService(user, in, serviceName);
BatchJobDefBean[] defBeans = out.getBatchJobDefBeans();
for(int i = 0 ; i < defBeans.length ; i++){
System.out.println(defBeans[i].getBatchName());
}
}catch(Exception ex){