最近在论坛遇到很多朋友问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。
欢迎交流!