前面发过一篇java调用webservice的文章,那个写的有些简单和潦草,而且只有客户端调用的例子,这里写一篇搭建服务端webservice的文章吧。
众所周知java搭建webservice服务端有很多种框架选择,例如:axis2,xfire,restful,jax-ws等等很多,在这里我主要介绍用的较多的axis2和xfir。
[XFire]
xfire 官网:http://xfire.codehaus.org/
在这里你可以下载到最新的源码和工程(当然这个项目已经很多年没有更新了,Latest Release: 1.2.6 - May 3, 2007)
下载完所需jar包后,打开目录:
挑几个用的着的
下面开始配置:
1. 配置web.xml 文件
添加xfire的servlet:
<servlet>
<servlet-name>xfireServlet</servlet-name>
<servlet-class>org.codehaus.xfire.spring.XFireSpringServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>xfireServlet</servlet-name>
<url-pattern>/service/*</url-pattern>
</servlet-mapping>
与spring结合使用,则再添加spring的配置:
<!-- 设置项目路径 -->
<context-param>
<param-name>webAppRootKey</param-name>
<param-value>xfire.root</param-value>
</context-param>
<!-- spring 配置文件 -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext-*.xml</param-value>
</context-param>
<!-- spring 配置文件监听器 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 字符码filter配置 -->
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<!-- 字节码filter映射 -->
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- webservice配置 -->
<servlet>
<servlet-name>xfire</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>xfire</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
2. 配置Xfire文件
在WEB-INF下新建一个xfire-servlet.xml配置文件,这个配置文件中配置了被调用的webservice接口
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<import resource="classpath:org/codehaus/xfire/spring/xfire.xml" />
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="urlMap">
<map>
<!-- 暴露的调用名称, http://path/TestService?wsdl-->
<entry key="/TestService">
<ref bean="testServiceXf" />
</entry>
</map>
</property>
</bean>
<!-- 默认xfire工厂,不能删除 -->
<bean id="baseWebService" class="org.codehaus.xfire.spring.remoting.XFireExporter"
lazy-init="false" abstract="true">
<property name="serviceFactory">
<ref bean="xfire.serviceFactory" />
</property>
<property name="xfire">
<ref bean="xfire" />
</property>
</bean>
<!-- 测试service -->
<bean id="testServiceXf" parent="baseWebService">
<property name="serviceBean">
<ref bean="connectionTestService" />
</property>
<property name="serviceClass">
<!-- 这里就是你的service了 -->
<value>com.test.testService</value>
</property>
</bean>
</beans>
配置文件中得map可以配置多个调用接口
3. 验证
打开浏览器输入http://path/TestService?wsdl 看是否出现了一个很长的xml配置信息,如果有则说明xfire已经配置成功。
4. 因为webservice时以xml形势传递数据的,虽然xfire会自动转型,但像List这样的复杂对象往往有些情况就会出现各种各样的错误,这时就需要帮助xfire来转换类型。
在你的service接口包内建一个与接口同名的配置文件,例如接口为TestService,则建一个TestService.aegis.xml配置文件,文件内容:
<?xml version="1.0" encoding="UTF-8"?>
<mappings>
<mapping>
<!-- 加载通讯录组方法,返回一个group对象 -->
<method name="loadContactsGroup">
<return-type componentType="com.test.Group" />
</method>
<!-- 加载通讯录组列表方法,返回对象是List -->
<method name="loadContactsGroupList">
<!-- 此处的#returnList对应下面的name值 -->
<return-type componentType="#returnList" />
</method>
<!-- 返回值是List<Group>,当然你也可以配置其他的类型 -->
<component name ="returnList" class ="java.util.List" componentType ="com.test.Group" />
</mapping>
</mappings>
[axis2]
现在较为流行的是使用axis2来搭建webservice服务端,axis2功能也非常强大,我也只是管中窥豹略知一二。
Axis2的官网:http://axis.apache.org/
这里就跟xfire截然不同了,axis有很多版本,而且支持很多语言,当然作为apache的项目,活跃性也是比较高的,不必担心很久都不会有人更新的尴尬局面。
1.下载下来相应的版本,挑选里面的jar包:
当然有你不需要的或者没加进来的自己酌情删减。
2. 配置web.xml
Axis2的配置就跟xfire类似了,都是添加一个相应的servlet:
<!-- axis配置 -->
<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>
3.创建axis2配置文件
在WEB-INF下创建一个services文件夹,在此文件夹下放你需要的配置的services.xml配置文件,目录结构如下:
Test
|--META-INF
|--services.xml
4.servieces.xml配置
<?xml version="1.0" encoding="UTF-8"?>
<serviceGroup>
<service name="TestService">
<description>通讯录webservice</description>
<!-- ServiceObjectSupplier为装载spring bean的类,必须有-->
<parameter name="ServiceObjectSupplier">org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier</parameter>
<!-- SpringBeanName不可变,userServer为spring中对应的bean -->
<parameter name="SpringBeanName">contactsService</parameter>
<operation name="axisTest">
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
</service>
</serviceGroup>
5. 验证:
打开浏览器输入http://path/TestService?wsdl 看是否出现了一个很长的xml配置信息,如果有则说明axis2已经配置成功。
至此所有配置都已经完成,如有不足请指出,会尽快完善。