利用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进去就可以

  <servlet>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>
        org.apache.axis.transport.http.AxisServlet
    </servlet-class>
  </servlet>
  <servlet>
    <servlet-name>AdminServlet</servlet-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>
    <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>

3.创建一个webservice类，就是一个普通的类包含一个普通方法

public class SayHello {

	public String hello(String name){
		return "Hello "+name;
	}
	
	public void in(String name){
		System.out.println(name + "come");
		Log4j.getLogger().info(name + "come");
	}
}

4.配置server-config.wsdd，server-config.wsdd的路径在WEB-INF下面，参考第一张图。

<?xml version="1.0" encoding="UTF-8"?>
<deployment name="defaultClientConfig"
            xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"
            xmlns:handler="http://xml.apache.org/axis/wsdd/providers/handler">

 <globalConfiguration>
   <parameter name="disablePrettyXML" 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>
     <!-- uncomment this if you want the SOAP monitor -->
     <!--
     <handler type="java:org.apache.axis.handlers.SOAPMonitorHandler"/>
     -->
   </requestFlow>
   <!-- uncomment this if you want the SOAP monitor -->
   <!--
   <responseFlow>
     <handler type="java:org.apache.axis.handlers.SOAPMonitorHandler"/>
   </responseFlow>
   -->
 </globalConfiguration>

 <handler type="java:org.apache.axis.handlers.http.URLMapper" name="URLMapper"/>
 <handler type="java:org.apache.axis.transport.local.LocalResponder" name="LocalResponder"/>
 <handler type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" name="Authenticate"/>

 <service name="AdminService" provider="java:MSG">
  <namespace>http://xml.apache.org/axis/wsdd/</namespace>
  <parameter name="allowedMethods" value="AdminService"/>
  <parameter name="enableRemoteAdmin" value="false"/>
  <parameter name="className" value="org.apache.axis.utils.Admin"/>
 </service>

 <service name="Version" provider="java:RPC">
  <parameter name="allowedMethods" value="getVersion"/>
  <parameter name="className" value="org.apache.axis.Version"/>
 </service>
 
 <!--  ======================以上内容一般不需要修改===========================-->
 
 
 <!--  ======================================================================
  Services:Demo,此段包含Sevice配置实例
 =======================-->
  <!-- 
  	示例1:	简单 Service
  	情境:	包含下例代码中基本属性.所有参数传递均为元数据,即int、float、double、String、boolean等非对象数据；
			可以访问此Service中所有的方法
  	引用：	在C#中借助于IDE引用。
  -->
  <service name="WSTest1" provider="java:RPC">	<!-- name: 此WebService的名称；provider:工作模式 -->>
	  <parameter name="className" value="org.tp.SayHello"/><!-- 此Service对应的实现类 -->
	  <parameter name="allowedMethods" value="*"/><!-- 可以访问这个Service中所有的方法 -->
  </service>
 
 <!--  ======================以下内容一般不需要修改===========================-->
 <transport name="http">
  <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:wsdl" 
               value="org.apache.axis.transport.http.QSWSDLHandler"/>
  <requestFlow>
   <handler type="URLMapper"/>
   <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler">
   </handler>
  </requestFlow>
 </transport>

 <transport name="local">
  <responseFlow>
   <handler type="LocalResponder"/>
  </responseFlow>
 </transport>

</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。

欢迎交流！