近期项目需要发布一个对外webservice接口,因为之前没弄过,所以在网上找了很多资料,最终找到了一个适合自已的。
目标:发布一个对外webservice接口(整合myeclipse6.5+axis2)
开发环境:myeclipse6.5+tomcat6
所用插件:axis2的1.3版本
一、安装axis2
1、下载 axis2插件及jar包,我用的版本是1.3,大家直接从下面的附件中下载就好了。
2、下载完后,直接解压成Axis2_Codegen_Wizard_1.3.0、Axis2_Service_Archiver_1.3.0文件夹,放入myeclipse6.5安装目录的plugins目录下,然后重启myeclipse6.5就好了。
3、查看是否成功:打开File->New->Other,会看见如下弹出框:
二、发布webService准备
1、web.xml中添加配置
<servlet> <servlet-name>AxisServlet</servlet-name> <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping>
2、在项目的WEB-INF目录添加文件server-config.wsdd,代码如下:
<?xml version="1.0" encoding="UTF-8"?> <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <globalConfiguration> <parameter name="adminPassword" value="admin"/> <parameter name="attachments.Directory" value="./attachments"/> <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/> <parameter name="sendXsiTypes" value="true"/> <parameter name="sendMultiRefs" value="true"/> <parameter name="sendXMLDeclaration" value="true"/> <parameter name="axis.sendMinimizedElements" value="true"/> <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> </requestFlow> </globalConfiguration> <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/> <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/> <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/> <service name="AdminService" provider="java:MSG"> <parameter name="allowedMethods" value="AdminService"/> <parameter name="enableRemoteAdmin" value="false"/> <parameter name="className" value="org.apache.axis.utils.Admin"/> <namespace>http://xml.apache.org/axis/wsdd/</namespace> </service> <service name="Version" provider="java:RPC"> <parameter name="allowedMethods" value="getVersion"/> <parameter name="className" value="org.apache.axis.Version"/> </service> <!-- 新添加的service接口: name表示接口名称 --> <service name="MyMethod" provider="java:RPC"> <!-- value中添加对外可以调用的方法 --> <parameter name="allowedMethods" value="method1,method2"/> <!-- value中添加类在包中所在位置 --> <parameter name="className" value="com.test.Method"/> </service> <transport name="http"> <requestFlow> <handler type="URLMapper"/> <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/> </requestFlow> </transport> <transport name="local"> <responseFlow> <handler type="LocalResponder"/> </responseFlow> </transport> </deployment>
3、在WEB-INF中建立目录services,此目录用于存放axis2生成的.aar格式的文件
4、完成以上工作,则准备工作完成。
三、发布webservice
1、假设我们要把项目中com.test.Method类中的method1和method2发布出去,作为对外调用的接口。
2、生成wsdl文件,打开File->New->Other->Axis2 Wizards->Axis2 Code Generator如下图:
选择此接口类的编译文件位置:
定义项目的工作区及服务名(可默认,不必改动):
将文件输出到项目的src目录下:
成功:
3、生成.aar文件到WEB-INF的services目录中,打开File->New->Other->Axis2 Wizards->Axis2 server archiver如下图,选择class文件所在目录:
选择已生成好的wsdl文件:
继续下一步:
继续下一步:
填写方法接口名称及类所在的路径:
将文件输出到services中及定义文件名:
然后提交,则会提示文件已生成成功!
4、重要:将发布的service添加到server-config.wsdd中(文件中加注释的内容即为添加的接口)
5、启动项目,访问:http://127.0.0.1:8080/test/services,即可看见发布的接口
四、调用接口
import org.apache.axis.client.Call; import org.apache.axis.client.Service; public class TestClient { public static void main(String[] args) throws Exception { // 指出service所在URL String endpoint = "http://127.0.0.1:8080/test/services/MyMethod"; // 创建一个服务(service)调用(call) Service service = new Service(); Call call = (Call) service.createCall();// 通过service创建call对象 // 设置service所在URL call.setTargetEndpointAddress(new java.net.URL(endpoint)); // 方法名(processService)与MyService.java方法名保持一致 call.setOperationName("method2"); // Object 数组封装了参数,参数为"This is Test!",调用processService(String arg) String ret = (String) call.invoke(new Object[] { "123", "456" }); System.out.println(ret); } }
本文参考:http://yangjizhong.iteye.com/blog/579511