近期项目需要发布一个对外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