一、XFire概述

  XFire是codeHaus组织提供的一个开源的Web Service框架,它构建了普通Java对象和服务架构之间的桥梁,支持将普通Java对象通过非常简单的方式发布成Web服务,这种处理方式大大简化了Java应用转化为Web服务的步骤和过程,也直接降低了服务架构的实现难度。虽然XFire在2007年后已停止更新(目前XFire框架最后一个版本为1.2.6),但由于它可以很轻易地与Spring集成,使得其在Java企业级开发中仍有着一席之地。本文将简单地介绍使用Spring框架中自带的DispatcherServlet来整合XFire开发Webservice服务。

二、开发环境及工具

  Eclipse+Tomcat 7+JDK 1.7+SoapUI(Webservice测试工具)

三、整合案例源码

  该整合案例是入门级别的,并未使用到数据库,提供webservice的服务接口类也仅是简单的几句话而已。通过简化代码来突出主题是本人的一贯宗旨,望谅解。

1、所使用的Jar包

java如何集成spring spring集成xfire_java

2、提供webservice服务的接口类

package com.tiger.xfire.service;
/**
 * xfire服务端测试接口
 */
public interface XfireTestService {
    public String getRespStr(String reqstr);
}

3、提供webservice服务的接口实现类

package com.tiger.xfire.service.impl;

import com.tiger.xfire.service.XfireTestService;
/**
 * xfire服务端接口对应的实现类
 */
public class XfireTestServiceImpl implements XfireTestService{
    
    @Override
    public String getRespStr(String reqStr) {
        return "测试信息已收到!";
    }
}

4、web.xml文件配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
  <display-name>xfire-demo</display-name>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  
  <!-- 引入 spring配置文件和xfire自带spring集成文件xfire.xml-->
  <context-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:applicationContext.xml,classpath:org/codehaus/xfire/spring/xfire.xml</param-value>
  </context-param>
 
  <!-- 注册spring监听 -->
  <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  
  <!-- 防止内存泄漏(spring框架自带监听) -->
  <listener>
    <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
  </listener>
  
  <!-- 使用DispatcherServlet方式集成xfire-->
  <servlet>
      <!-- 此处的servlet-name的值与xfire-servlet.xml中的xfire对应 -->
    <servlet-name>xfire</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>xfire</servlet-name>
    <url-pattern>/services/*</url-pattern>
  </servlet-mapping>
</web-app>

5、applicationContext.xml配置(本案例中该文件放在src目录下)

<?xml version="1.0" encoding="UTF-8"?>
<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-2.5.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-2.5.xsd">
    <!-- 数据源、事务、切面等配置此处忽略 -->
    
    <!-- 将提供ws的接口交给spring容器管理 -->
    <bean id="xfireTestService" class="com.tiger.xfire.service.impl.XfireTestServiceImpl" autowire="byType"/>
</beans>

6、xfire-servlet.xml配置(放在WEB-INF目录下)

<?xml version="1.0" encoding="UTF-8"?>
<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-2.5.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-2.5.xsd">

    <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="urlMap">
            <map>
                <!-- 配置访问ws服务的地址-->
                <entry key="/xfiretest">
                    <!-- 指定需要调用的服务 -->
                    <ref bean="xfiretest" />
                </entry>
            </map>
        </property>
    </bean>
    
    <!-- 配置ws服务需要用到的公共bean信息 -->
    <bean id="webService" class="org.codehaus.xfire.spring.remoting.XFireExporter" abstract="true">
        <!-- 配置ws服务使用的工厂 -->
        <property name="serviceFactory">
            <!-- 引用xfire框架中org/codehaus/xfire/spring/xfire.xml文件的默认工厂配置-->
            <ref bean="xfire.serviceFactory" />
        </property>
        <property name="xfire">
            <ref bean="xfire" />
        </property>
    </bean>
    
    <!-- 配置ws服务 -->
    <bean id="xfiretest" parent="webService" class="org.codehaus.xfire.spring.remoting.XFireExporter">
        <!-- 指定提供ws服务的实现类(对应spring配置文件中配置的bean)-->
        <property name="serviceBean">
            <ref bean="xfireTestService" />
        </property>
        <!-- 指定提供ws服务的接口 -->
        <property name="serviceClass">
            <value>com.tiger.xfire.service.XfireTestService</value>
        </property>
        <!-- 指定返回报文的命名空间 -->
        <property name="namespace">
            <value>http://com.tiger.service</value>
        </property>
    </bean>
    
</beans>

四、案例测试

1、在浏览器中直接输入http://localhost:8080/xfire-demo/services/xfiretest?wsdl进行访问,若出现如下内容则代表Webservice服务成功发布:

<wsdl:definitions xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:tns="http://com.tiger.service" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding"
    targetNamespace="http://com.tiger.service">
    <wsdl:types>
        <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            attributeFormDefault="qualified" elementFormDefault="qualified"
            targetNamespace="http://com.tiger.service">
            <xsd:element name="getRespStr">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element maxOccurs="1" minOccurs="1" name="in0"
                            nillable="true" type="xsd:string" />
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
            <xsd:element name="getRespStrResponse">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element maxOccurs="1" minOccurs="1" name="out"
                            nillable="true" type="xsd:string" />
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:schema>
    </wsdl:types>
    <wsdl:message name="getRespStrResponse">
        <wsdl:part name="parameters" element="tns:getRespStrResponse"></wsdl:part>
    </wsdl:message>
    <wsdl:message name="getRespStrRequest">
        <wsdl:part name="parameters" element="tns:getRespStr"></wsdl:part>
    </wsdl:message>
    <wsdl:portType name="XfireTestServicePortType">
        <wsdl:operation name="getRespStr">
            <wsdl:input name="getRespStrRequest" message="tns:getRespStrRequest"></wsdl:input>
            <wsdl:output name="getRespStrResponse" message="tns:getRespStrResponse"></wsdl:output>
        </wsdl:operation>
    </wsdl:portType>
    <wsdl:binding name="XfireTestServiceHttpBinding" type="tns:XfireTestServicePortType">
        <wsdlsoap:binding style="document"
            transport="http://schemas.xmlsoap.org/soap/http" />
        <wsdl:operation name="getRespStr">
            <wsdlsoap:operation soapAction="" />
            <wsdl:input name="getRespStrRequest">
                <wsdlsoap:body use="literal" />
            </wsdl:input>
            <wsdl:output name="getRespStrResponse">
                <wsdlsoap:body use="literal" />
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:service name="XfireTestService">
        <wsdl:port name="XfireTestServiceHttpPort" binding="tns:XfireTestServiceHttpBinding">
            <wsdlsoap:address
                location="http://localhost:8080/xfire-demo/services/xfiretest" />
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

2、使用SoapUI进行测试

  关于SoapUI的下载地址及用法本文不做介绍,感兴趣的可以百度查找相关教程,或者自己写个Webservice客户端进行验证。

java如何集成spring spring集成xfire_spring_02

  上图用红框标记的内容是需要进行核对的内容,如果结果差不多则证明发布的Webservice服务是可以调通且能正常返回的。