我在这里提供两种用AXIS2发布WebService的方法。
一种是打aar包放在指定位置(不方便调试),一种是不打aar包(方便调试),着重介绍后者。
说明:Eclipse版本3.4.2、tomcat版本5.5.12、AXIS2版本1.5.1、EclipseTomcatPlugin3.2.1
准备工作:
下载WAR (Web Archive) Distribution
“This will be the web application of Axis2 which can be deployed in most of the servlet containers.”
http://labs.xiaonei.com/apache-mirror/ws/axis2/1_5_1/axis2-1.5.1-war.zip
下载完后解压至tomcat安装目录下的webapps文件夹下,启动tomcat后,在webapps目录下会生成axis2文件夹。
访问http://localhost:8080/axis2/能看到以下页面表示axis2运行成功。
点击Service会进入Service列表页面,当前只有一个Version服务。
打包发布:
在Eclipse下建立Java Project,工程名HelloFriend。
建包com.dm.service,包下建类HelloFriend。代码如下:
- package com.dm.service;
- public class HelloFriend {
- private String friendName = "wangwei";
- public String sayHello(String name) {return "Hello, " + name + "."; }
- public String saySorry(String name) {return "Sorry, " + name + "."; }
- public String getName() {return friendName; }
- }
在工程下新文件夹services/HelloFriend,HelloFriend下按类HelloFriend.java包路径建文件路径com/dm/service最后将编译后的HelloFriend.class我呢间拷入com/dm/service下。HelloFriend文件夹下在新建文件夹META-INF,META-INF下新建services.xml。最后在Windows命令行下进到services/HelloWord目录下运行:jar cvf HelloFriend.aar . (最后有个点号)会在HelloFriend目录下生成HelloFriend.aar包。
services.xml内容如下:
- <service name="HelloFriend">
- <description>Hello Friend Example</description>
- <parameter name="ServiceClass">com.dm.service.HelloFriend</parameter>
- <operation name="sayHello">
- <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- </operation>
- <operation name="saySorry">
- <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- </operation>
- <operation name="getName">
- <messageReceiver
- class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
- </operation>
- </service>
最后的工程目录如下:
把HelloFriend.aar拷入tomcat安装目录下的webapps/axis2/WEB-INF/services下,再进入http://localhost:8080/axis2/进入Services就会看到HelloFriend了。
打aar包发布的方式不便于调试,下面介绍不打包发布的方式。
不打包发布:
在Eclipse下新建Tomcat Project,工程名:HelloWorld。新建包com.cm.service,新建类HelloWorld,代码如下:
- package com.dm.service;
- public class HelloWorld {
- public String sayHello(String name) {return "Hello, " + name + "."; }
- public String saySorry(String name) {return "Hello, " + name + "."; }
- public String getWorld() {return "Hello, world!";}
- }
在WEB-INF目录下新建web.xml文件,内容如下:
- <?xml version="1.0" encoding="UTF-8"?>
- <web-app id="wmf" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
- <servlet>
- <servlet-name>AxisServlet</servlet-name>
- <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
- <load-on-startup>1</load-on-startup>
- </servlet>
- <servlet-mapping>
- <servlet-name>AxisServlet</servlet-name>
- <url-pattern>/services/*</url-pattern>
- </servlet-mapping>
- </web-app>
把tomcat安装目录下的webapps/axis2/WEB-INF下的modules、service和conf文件件拷至HelloWorld下的WEB-INF目录下。把lib下的如下jar包夜拷过去,以下jar包已经是最精简的了。
然后再services下新建HelloWorld/META-INF路径,META-INF下新建services.xml,内容如下:
- <service name="HelloWorld">
- <description>
- HelloWorld Service Example
- </description>
- <parameter name="ServiceClass">
- com.dm.service.HelloWorld
- </parameter>
- <operation name="sayHello">
- <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- </operation>
- <operation name="saySorry">
- <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- </operation>
- <operation name="getWorld">
- <messageReceiver class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
- </operation>
- </service>
启动tomcat后访问http://localhost:8080/HelloWorld/services/HelloWorld?wsdl能看到服务信息了。
总结:
以上两种方法还是很相似的。
1. 第一种方法不用打aar包,把整个文件夹拷过去也是可以的。
2. 第二种方式只是相当于是在AXIS2工程上再开发。(得引入AXIS2的包,web.xml里要加AxisServlet)。同样需要services.xml。
3. 此文只是告诉大家怎么把AXIS2加到已有工程里来,至于servicex.xml格式怎么样,这里没有分析。