利用Apache AXIS 1 發佈WebService

最近在論壇遇到不少朋友問AXIS發佈webService的問題，這個問題已經回答了不少次了，如今特別發佈一文章，說明AXIS 1的基本用法。

 //很慶幸，CSDN的發文編輯器已經改版本，不那麼難編輯了。

首先，AXIS 是apache的做品。

1.到apache去下載相關的包，包括axis.jar、axis-ant.jar、commons-discovery-0.2.jar等。將jar包放到WEB-INF/lib下面

2.在WEB.XML中按以下配置，直接copy進去就能夠

[html] view plain copy

1. <servlet>  
2.   <servlet-name>AxisServlet</servlet-name>  
3.   <servlet-class>  
4.       org.apache.axis.transport.http.AxisServlet  
5.   </servlet-class>  
6. </servlet>  
7. <servlet>  
8.   <servlet-name>AdminServlet</servlet-name>  
9.   <servlet-class>  
10.       org.apache.axis.transport.http.AdminServlet  
11.   </servlet-class>  
12.   <load-on-startup>100</load-on-startup>  
13. </servlet>  
14. <servlet>  
15.   <servlet-name>SOAPMonitorService</servlet-name>  
16.   <servlet-class>  
17.       org.apache.axis.monitor.SOAPMonitorService  
18.   </servlet-class>  
19.   <init-param>  
20.     <param-name>SOAPMonitorPort</param-name>  
21.     <param-value>5001</param-value>  
22.   </init-param>  
23.   <load-on-startup>100</load-on-startup>  
24. </servlet>  
25. <servlet-mapping>  
26.   <servlet-name>AxisServlet</servlet-name>  
27.   <url-pattern>/servlet/AxisServlet</url-pattern>  
28. </servlet-mapping>  
29. <servlet-mapping>  
30.   <servlet-name>AxisServlet</servlet-name>  
31.   <url-pattern>*.jws</url-pattern>  
32. </servlet-mapping>  
33. <servlet-mapping>  
34.   <servlet-name>AxisServlet</servlet-name>  
35.   <url-pattern>/services/*</url-pattern>  
36. </servlet-mapping>  
37. <servlet-mapping>  
38.   <servlet-name>SOAPMonitorService</servlet-name>  
39.   <url-pattern>/SOAPMonitor</url-pattern>  
40. </servlet-mapping>  

3.建立一個webservice類，就是一個普通的類包含一個普通方法

[java] view plain copy

1. public class SayHello {  
2.   
3.     public String hello(String name){  
4.         return "Hello "+name;  
5.     }  
6.       
7.     public void in(String name){  
8.         System.out.println(name + "come");  
9.         Log4j.getLogger().info(name + "come");  
10.     }  
11. }  

4.配置server-config.wsdd，server-config.wsdd的路徑在WEB-INF下面，參考第一張圖。

[html] view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <deployment name="defaultClientConfig"  
3.             xmlns="http://xml.apache.org/axis/wsdd/"  
4.             xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"  
5.             xmlns:handler="http://xml.apache.org/axis/wsdd/providers/handler">  
6.   
7.  <globalConfiguration>  
8.    <parameter name="disablePrettyXML" value="true"/>  
9.    <parameter name="dotNetSoapEncFix" value="true"/>  
10.    <parameter name="enableNamespacePrefixOptimization" value="false"/>  
11.    <requestFlow>  
12.      <handler type="java:org.apache.axis.handlers.JWSHandler">  
13.         <parameter name="scope" value="session"/>  
14.      </handler>  
15.      <handler type="java:org.apache.axis.handlers.JWSHandler">  
16.         <parameter name="scope" value="request"/>  
17.         <parameter name="extension" value=".jwr"/>  
18.      </handler>  
19.      <!-- uncomment this if you want the SOAP monitor -->  
20.      <!-- 
21.      <handler type="java:org.apache.axis.handlers.SOAPMonitorHandler"/> 
22.      -->  
23.    </requestFlow>  
24.    <!-- uncomment this if you want the SOAP monitor -->  
25.    <!--  
26.    <responseFlow>  
27.      <handler type="java:org.apache.axis.handlers.SOAPMonitorHandler"/>  
28.    </responseFlow>  
29.    -->  
30.  </globalConfiguration>  
31.   
32.  <handler type="java:org.apache.axis.handlers.http.URLMapper" name="URLMapper"/>  
33.  <handler type="java:org.apache.axis.transport.local.LocalResponder" name="LocalResponder"/>  
34.  <handler type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" name="Authenticate"/>  
35.   
36.  <service name="AdminService" provider="java:MSG">  
37.   <namespace>http://xml.apache.org/axis/wsdd/</namespace>  
38.   <parameter name="allowedMethods" value="AdminService"/>  
39.   <parameter name="enableRemoteAdmin" value="false"/>  
40.   <parameter name="className" value="org.apache.axis.utils.Admin"/>  
41.  </service>  
42.   
43.  <service name="Version" provider="java:RPC">  
44.   <parameter name="allowedMethods" value="getVersion"/>  
45.   <parameter name="className" value="org.apache.axis.Version"/>  
46.  </service>  
47.    
48.  <!--  ======================以上內容通常不須要修改===========================-->  
49.    
50.    
51.  <!--  ======================================================================  
52.   Services:Demo,此段包含Sevice配置實例  
53.  =======================-->  
54.   <!--   
55.     <span style="color:#ff0000;">示例1:   簡單 Service</span>  
56.     情境: 包含下例代碼中基本屬性.全部參數傳遞均爲元數據,即int、float、double、String、boolean等非對象數據；  
57.             能夠訪問此Service中全部的方法  
58.     引用： 在C#中藉助於IDE引用。  
59.   -->  
60.   <service name="WSTest1" provider="java:RPC">    <!-- name: 此WebService的名稱；provider:工做模式 -->>  
61.       <parameter name="className" value="<span style="color:#ff0000;">org.tp.SayHello</span>"/><!-- 此Service對應的實現類 -->  
62.       <parameter name="allowedMethods" value="*"/><!-- 能夠訪問這個Service中全部的方法 -->  
63.   </service>  
64.    
65.  <!--  ======================如下內容通常不須要修改===========================-->  
66.  <transport name="http">  
67.   <parameter name="qs:list"   
68.                value="org.apache.axis.transport.http.QSListHandler"/>  
69.   <parameter name="qs:method"   
70.                value="org.apache.axis.transport.http.QSMethodHandler"/>  
71.   <parameter name="qs:wsdl"   
72.                value="org.apache.axis.transport.http.QSWSDLHandler"/>  
73.   <requestFlow>  
74.    <handler type="URLMapper"/>  
75.    <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler">  
76.    </handler>  
77.   </requestFlow>  
78.  </transport>  
79.   
80.  <transport name="local">  
81.   <responseFlow>  
82.    <handler type="LocalResponder"/>  
83.   </responseFlow>  
84.  </transport>  
85.   
86. </deployment>  

配置文件中有的東西不固定，在文件註釋中描述得很清楚。針對第二步中的類，咱們只看配置中的示例1，其中紅色標記部分是實現類的路徑，注意校訂就OK。

5.這樣一個最基本的webservice就布好了，運行服務器（本例中是tomcat 6）。在地址欄中輸入

http://127.0.0.1:8080/appName/services

注意校訂URL，services是固定的。

運行後會列出本應用服務器上發佈的webservice

點咱們剛纔那個 WSTest1，會出現

當別人引用webservice時，通常是用http://localhost:8080/DemoLanZhou/services/WSTest1?wsdl這個地址來引用的

6.開着服務器，等着別人來引用。

也能夠在瀏覽器測試一下http://localhost:8080/DemoLanZhou/services/WSTest1?method=hello&args=tp

注意校訂地址，參數中method=hello表示調用hello方法，args=tp是傳給hello方法的參數。hello方法就是SayHello.hello();最上面定義的那個類。

上圖中選中部分爲方法返回的值。

至此完成一個基本的webservice。

歡迎交流！