目录
服务端搭建:
第一步:创建maven工程
需要对pom.xml配置spring的相关依赖。对web.xml进行进行简单的配置ok。
这篇文章主要讲axis2的配置,所以就不会详细说这些。
第二步:完成axis2相关配置
-
添加axis2的jar包
首先要在官网下载axis2
官网:http://axis.apache.org/axis2/java/core/download.cgi -
配置services.xml
services.xml的目录结构如下图所示:
在services.xml中,我们要配置发布的webservice的服务。 - 关于服务类的配置可以分全类名和指定Spring Bean ID的方式
- 指定spring bean ID
<?xml version="1.0" encoding="UTF-8"?> <service name="UserInfoService"> <!-- 指定服务名,随便定义 --> <description>测试axis2webservices</description><!-- 服务的作用说明,可写可不写 --> <parameter name="SpringBeanName">userinfo</parameter> <parameter name="ServiceObjectSupplier"> org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier </parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> </messageReceivers> </service>
指定spring bean ID 需要使用org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier获取对应bean id的类路径。
- 全类名
<?xml version="1.0" encoding="UTF-8"?> <service name="UserInfoService"> <!-- 指定服务名,随便定义 --> <description>测试axis2webservices</description><!-- 服务的作用说明,可写可不写 --> <!-- 指定要发布的类路径 --> <parameter name="ServiceClass">com.axis2.UserInfo</parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> </messageReceivers> </service>
- 指定spring bean ID
- 关于发布的方法配置可以不指定发布方法或者指定发布方法。
- 不指定发布的方法:
<?xml version="1.0" encoding="UTF-8"?> <service name="UserInfoService"> <!-- 指定服务名,随便定义 --> <description>测试axis2webservices</description><!-- 服务的作用说明,可写可不写 --> <parameter name="SpringBeanName">userinfo</parameter> <parameter name="ServiceObjectSupplier"> org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier </parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> </messageReceivers> </service>
- 指定发布方法:
<?xml version="1.0" encoding="UTF-8"?> <service name="UserInfoService"> <!-- 指定服务名,随便定义 --> <description>测试axis2webservices</description><!-- 服务的作用说明,可写可不写 --> <parameter name="SpringBeanName">userinfo</parameter> <parameter name="ServiceObjectSupplier"> org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier </parameter> <operation name="getUserName"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> </operation> <operation name="addUserHobby"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> </operation> <operation name="setUserScore"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> </operation> <operation name="print"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> </operation> </service>
- 不指定发布的方法:
-
配置applicationContext.xml
这里注入的bean就是你要发布的服务类。当services.xml使用了SpringBeanName才需要进行的配置。<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.1.xsd"> <bean id="userinfo" class="com.axis2.UserInfo"/> </beans>
-
配置web.xml
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app> <display-name>Archetype Created Web Application</display-name> <!-- 加载spring的配置文件 --> <context-param> <param-name>contextConfigLocation</param-name> <!-- 使用spring bean的方式需要加载注入 --> <param-value>classpath:applicationContext.xml</param-value> </context-param> <!-- 增加spring监听器 --> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <servlet> <servlet-name>AxisServlet</servlet-name> <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class> <load-on-startup>2</load-on-startup> </servlet> <!-- 设置dispatchservlet的匹配模式,通过把dispatchservlet映射到/,默认servlet会处理所有的请求,包括静态资源 --> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> </web-app>
第三步:写个服务类
随便写,也不需要什么注解。注意是否与services.xml中的全类名,方法名对应。applicationContext.xml中是否注入。
package com.axis2;
public class UserInfo {
public String getUserName() {
return "zhangxu";
}
public String addUserHobby(String like) {
return "add hobby "+like;
}
public void setUserScore(double score) {
System.out.println(score);
}
public void print() {
System.out.println("啥都没有");
}
}
第四步:Tomcat启动工程
将工程放入Tomcat,启动。在浏览器中输入:
http://localhost:8080/SpringDemo/services/UserInfoService?wsdl
如果能显示xml报文,那么我们的webservice便成功发布了!!!
这里的命名规则是:http://【ip】:【端口】/【工程名】/services/【service名】?wsdl
客户端测试:
package com.axis2;
import javax.xml.namespace.QName;
import org.apache.axiom.om.OMElement;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
public class Test {
public static void main(String[] args) {
try {
String url = "http://localhost:8080/SpringDemo/services/UserInfoService?wsdl";
EndpointReference endpointReference = new EndpointReference(url);
RPCServiceClient client = new RPCServiceClient();
client.setTargetEPR(endpointReference );
Options options = client.getOptions();
options.setTo(endpointReference);
QName qname = new QName("http://axis2.com", "getUserName");
Object[] param = new Object[]{}; //输入参数比如:"aaa",没有输入,就不写。
Class<?>[] types = new Class[]{String.class}; //需要返回类型就是*.class
Object[] obj = client.invokeBlocking(qname, param, types);
System.out.println(obj[0]);
} catch (AxisFault e) {
e.printStackTrace();
}
}
}
这里需要注意两个地方:
String url = "http://localhost:8080/SpringDemo/services/UserInfoService?wsdl";这个就是我们之前输入,并访问到xml的那个地址。
QName中的第一个参数是xs:schema标签的targetNamespace="http://axis2.com",第二个参数对应下面的xs:element 的name,也就是我们发布的方法。
当控制台成功打印,便测试成功。
参考:
Services.xml的讲解 哈根达斯、 http://yangyangcom.iteye.com/blog/2233557
WebService - Axis2与Spring整合并发布多个service(同样使用services.xml) https://blog.csdn.net/J080624/article/details/78444986
官方文档 http://axis.apache.org/axis2/java/core/docs/spring.html
两种服务的发布方式 https://blog.csdn.net/chjttony/article/details/6211478