使用SOAP开发WebService 服务--Axis解决方案

?

使用SOAP开发WebService?服务--Axis解决方案

?

本文是通过Axis方案开发WebService服务，并由Java调用WebService，IDE（IBM WebSppere）。

?

本文的预定读者首先要对j2ee有所了解，熟悉xml，tomcat等基本内容，本文主要是简单介绍一下web服务的基本内容，怎样在java web开发中构建SOAP服务：

?

?一、SOAP（Simple Object Access Protocol）简单对象访问协议，要了解SOAP，首先就需要了解分布式计算的由来，随着下一代的分布式计算体系web服务的出现，SOAP成为了创建和调用通过网络发布的应用程序的实际通信标准。SOAP类似传统的二进制协议IIOP（CORBA）和JRMP（RMI），但它不采用二进制数据表示法，而是采用使用XML的，基于文本的数据表示法。

?

以下用实际例子来演示，包括（WebService服务端）和（调用WebService的客户端）两个项目。

?

WebService服务器项目：

1）下载Axis的相关包（http://ws.apache.org/axis/）；

2）建立一个实例程序（遵守j2ee的web程序规范），(本文工程为WebServiceTest）；

3) 把axis中lib文件夹的内容拷到你的WebServiceTest/WEB-INF/lib下；

4) 修改应用程序WebServiceTest/WEB-INF中的web.xml文件：

?? 有些代码是可要可不要的，在这里我就不删减了。

????<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems,Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>Apache-Axis</display-name> <distributable /> <listener> <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class> </listener> <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>AdminServlet</servlet-name> <display-name>Axis Admin Servlet</display-name> <servlet-class> org.apache.axis.transport.http.AdminServlet </servlet-class> <load-on-startup>100</load-on-startup> </servlet> <servlet> <servlet-name>SOAPMonitorService</servlet-name> <display-name>SOAPMonitorService</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> <load-on-startup>100</load-on-startup> </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> <servlet-mapping> <servlet-name>SOAPMonitorService</servlet-name> <url-pattern>/SOAPMonitor</url-pattern> </servlet-mapping> <!-- uncomment this if you want the admin servlet --> <!-- <servlet-mapping> <servlet-name>AdminServlet</servlet-name> <url-pattern>/servlet/AdminServlet</url-pattern> </servlet-mapping> --> <session-config> <!-- Default to 5 minute session timeouts --> <session-timeout>5</session-timeout> </session-config> <!-- currently the W3C havent settled on a media type for WSDL; http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft for now we go with the basic 'it's XML' response --> <mime-mapping> <extension>wsdl</extension> <mime-type>text/xml</mime-type> </mime-mapping> <mime-mapping> <extension>xsd</extension> <mime-type>text/xml</mime-type> </mime-mapping> <welcome-file-list id="WelcomeFileList"> <welcome-file>index.jsp</welcome-file> <welcome-file>index.html</welcome-file> <welcome-file>index.jws</welcome-file> </welcome-file-list> </web-app>

?

?你现在可以在网址里输入http://localhost:9080/WebServiceTest/services?

系统会显示默认的Services服务，看到了吗？

Axis是使用axis.jar包里的org.apache.axis.transport.http.AxisServlet对应用程序进行处理的。

?

5)至此，我们就可以编写我们的逻辑程序了。简单如：

/* * 创建日期 2009-12-5 * * 更改所生成文件模板为 * 窗口 > 首选项 > Java > 代码生成 > 代码和注释 */ package com.cwx.webservice; /** * @author Administrator * * 更改所生成类型注释的模板为 * 窗口 > 首选项 > Java > 代码生成 > 代码和注释 */ public class WebService { public String getName(String sName){ return "You Name is "+sName+"."; } }??

?

6) 部署服务，编写server-config.wsdd 配置文件，放在应用程序WebServiceTest/WEB-INF/下,

? 具体内容如下：同样有些代码是可要可不要的，在这里我就不删减了。

?

<?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="sendMultiRefs" value="true"/> <parameter name="disablePrettyXML" value="true"/> <parameter name="adminPassword" value="admin"/> <parameter name="attachments.Directory" value=""/> <parameter name="dotNetSoapEncFix" value="true"/> <parameter name="enableNamespacePrefixOptimization" value="true"/> <parameter name="sendXMLDeclaration" value="true"/> <parameter name="sendXsiTypes" value="true"/> <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/> <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="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/> <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/> <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/> <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="OnlineReport" provider="java:RPC"> <parameter name="allowedMethods" value="doAction doHelloWorld"/> <parameter name="className" value="com.cwx.webservice.WebService"/> </service> <service name="CwxWebService" provider="java:RPC"> <parameter name="allowedMethods" value="getName"/> <parameter name="className" value="com.cwx.webservice.WebService"/> </service> <transport name="http"> <requestFlow> <handler type="URLMapper"/> <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/> </requestFlow> <parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/> <parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/> <parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/> <parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/> <parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/> <parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/> </transport> <transport name="local"> <responseFlow> <handler type="LocalResponder"/> </responseFlow> </transport> </deployment>

?

别看代码太多，主要配置以下代码：

?

<service name="CwxWebService" provider="java:RPC"> <parameter name="allowedMethods" value="getName"/> <parameter name="className" value="com.cwx.webservice.WebService"/> </service>

?

说明：其中className参数是你的想部署的类名（全名），allowedMethods是调用的服务的方法，

如果有多个方法的话可以用空格分开（如：<parameter name="allowedMethods" value="getName? getMoney"/>),

当用*的时候表示全部。

?

7）OK，至此，我们已经部署好一个WebService服务了，现在我们来测试一下，

打开浏览器，输入http://localhost:9080/WebServiceTest/services地址，

看里面是否多了一个CwxWebService服务？

?

?

WebService 客户端调用测试：

1）建立一个实例程序（遵守j2ee的web程序规范），(本文工程为ClientWebService）；

2）编写调用逻辑类，代码如下：

/* * 创建日期 2009-12-5 * * 更改所生成文件模板为 * 窗口 > 首选项 > Java > 代码生成 > 代码和注释 */ package com.cwx.webservice; import javax.xml.namespace.QName; import org.apache.axis.client.Service; import org.apache.axis.client.Call; /** * @author Administrator * * 更改所生成类型注释的模板为 * 窗口 > 首选项 > Java > 代码生成 > 代码和注释 */ public class CallWebService { private void callWebService(String sParameter){ String sAddress="http://localhost:9080/WebServiceTest/services"; System.err.println("---------连接的地址："+sAddress); try{ System.err.println("---------正在连接WebService---------"); Service service=new Service(); Call call=new Call(service); call.setTargetEndpointAddress(sAddress); call.setOperationName(new QName("CwxWebService","getName")); Object webServiceResult=(String)call.invoke(new Object[]{sParameter}); System.err.println("---------WebService返回："+webServiceResult); }catch(Exception ex){ ex.printStackTrace(); System.err.println("---------调用WebService发生异常---------"); } } public static void main(String[] args) { new CallWebService().callWebService("HeTing"); } }

?

?

好了，关于SOAP开发WebService服务就说到这里了，以上代码是由本人整理并测试通过的，

如果有什么问题请留言给我，希望这篇文章能对大家有所帮助。