Webservice服务开发之XFire+Spring整合(使用DispatcherServlet方式)

时间 2019-11-11

标签 webservice 服务开发 xfire+spring xfire spring 整合使用 dispatcherservlet 方式栏目 WebService 繁體版

原文原文链接

1、XFire概述java

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

2、开发环境及工具spring

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

3、整合案例源码浏览器

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

一、所使用的Jar包app

二、提供webservice服务的接口类框架

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

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

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 "测试信息已收到！";
    }
}

四、web.xml文件配置ide

<?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>

五、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>

六、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>

4、案例测试

一、在浏览器中直接输入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>

二、使用SoapUI进行测试

　　关于SoapUI的下载地址及用法本文不作介绍，感兴趣的能够百度查找相关教程，或者本身写个Webservice客户端进行验证。

　　上图用红框标记的内容是须要进行核对的内容，若是结果差很少则证实发布的Webservice服务是能够调通且能正常返回的。