java与webservice

前面发过一篇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已经配置成功。

至此所有配置都已经完成，如有不足请指出，会尽快完善。