在这里提供两种用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内容如下:
Xml代码 <embed width="14" height="15" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" allowscriptaccess="always" quality="high" flashvars="clipboard=%3Cservice%20name%3D%22HelloFriend%22%3E%0A%09%3Cdescription%3EHello%20Friend%20Example%3C%2Fdescription%3E%0A%09%3Cparameter%20name%3D%22ServiceClass%22%3Ecom.dm.service.HelloFriend%3C%2Fparameter%3E%0A%09%3Coperation%20name%3D%22sayHello%22%3E%0A%09%09%3CmessageReceiver%20class%3D%22org.apache.axis2.rpc.receivers.RPCMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%09%3Coperation%20name%3D%22saySorry%22%3E%0A%09%09%3CmessageReceiver%20class%3D%22org.apache.axis2.rpc.receivers.RPCMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%09%3Coperation%20name%3D%22getName%22%3E%0A%09%09%3CmessageReceiver%0A%09%09%09class%3D%22org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%3C%2Fservice%3E" src="http://mtvwang.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf">
- <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代码 <embed width="14" height="15" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" allowscriptaccess="always" quality="high" flashvars="clipboard=%3C%3Fxml%20version%3D%221.0%22%20encoding%3D%22UTF-8%22%3F%3E%0A%3Cweb-app%20id%3D%22wmf%22%20version%3D%222.4%22%20xmlns%3D%22http%3A%2F%2Fjava.sun.com%2Fxml%2Fns%2Fj2ee%22%0A%09xmlns%3Axsi%3D%22http%3A%2F%2Fwww.w3.org%2F2001%2FXMLSchema-instance%22%0A%09xsi%3AschemaLocation%3D%22http%3A%2F%2Fjava.sun.com%2Fxml%2Fns%2Fj2ee%20http%3A%2F%2Fjava.sun.com%2Fxml%2Fns%2Fj2ee%2Fweb-app_2_4.xsd%22%3E%0A%09%3Cservlet%3E%0A%09%09%3Cservlet-name%3EAxisServlet%3C%2Fservlet-name%3E%0A%09%09%3Cservlet-class%3Eorg.apache.axis2.transport.http.AxisServlet%3C%2Fservlet-class%3E%0A%09%09%3Cload-on-startup%3E1%3C%2Fload-on-startup%3E%0A%09%3C%2Fservlet%3E%0A%09%3Cservlet-mapping%3E%0A%09%09%3Cservlet-name%3EAxisServlet%3C%2Fservlet-name%3E%0A%09%09%3Curl-pattern%3E%2Fservices%2F*%3C%2Furl-pattern%3E%0A%09%3C%2Fservlet-mapping%3E%0A%3C%2Fweb-app%3E%0A" src="http://mtvwang.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf">
- <?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,内容如下:
Xml代码 <embed width="14" height="15" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" allowscriptaccess="always" quality="high" flashvars="clipboard=%3Cservice%20name%3D%22HelloWorld%22%3E%0A%09%3Cdescription%3E%0A%09%09HelloWorld%20Service%20Example%0A%20%20%20%20%3C%2Fdescription%3E%0A%09%3Cparameter%20name%3D%22ServiceClass%22%3E%0A%09%09com.dm.service.HelloWorld%20%20%0A%20%20%20%20%3C%2Fparameter%3E%0A%09%3Coperation%20name%3D%22sayHello%22%3E%0A%09%09%3CmessageReceiver%20class%3D%22org.apache.axis2.rpc.receivers.RPCMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%09%3Coperation%20name%3D%22saySorry%22%3E%0A%09%09%3CmessageReceiver%20class%3D%22org.apache.axis2.rpc.receivers.RPCMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%09%3Coperation%20name%3D%22getWorld%22%3E%0A%09%09%3CmessageReceiver%20class%3D%22org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver%22%20%2F%3E%0A%09%3C%2Foperation%3E%0A%3C%2Fservice%3E" src="http://mtvwang.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf">
- <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格式怎么样,这里没有分析。