用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){

???????????????????? ex.printStackTrace();

????????????? }

?????? }

}

这样，我们就完成了webservice的全部工作。大功告成了