基于xfire的web service搭建

 标题：基于xfire的web service搭建
出处：小强的家
时间：Sun, 12 Apr 2009 12:30:29 +0000
作者：xiaojiit
地址：www.sharejava.cn/blog/read.php/12.htm

内容：
    这里，用的xfire1.2.6和Spring 2.0，开发工具用的MyEclispe，虽然MyEclipse自带了开发xfire的插件，但为了不依赖开发工具，所以以下为手动创建。
Xfire 可以很好的和Spring 集成，下面分两部分介绍
纯Xfire 的web service
1.1、先建一个web 项目，打开下载到的xfire包，将lib下的所有 Jar包和modules目录下的所有Jar包拷到web 项目的WEB-INF/lib目录下。
1.2、修改web.xml文件，添加如下内容，以支持xfire：


<servlet>
  <servlet-name>XFireServlet</servlet-name>  
  <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet
  </servlet-class>
  <load-on-startup>0</load-on-startup>
 </servlet>
 <servlet-mapping>
  <servlet-name>XFireServlet</servlet-name>
  <url-pattern>/services/*</url-pattern>
 </servlet-mapping>


这样，便可以通过http://localhost:8080/projectName/services/ 路径来访问所有发布的web services了。
1.3、在项目下的WEB-INF目录下建立META-INF/xfire/这个目录，在此目录下建立services.xml文件，这个文件用来添写我的要发布的web services。文件内容如下所示：

<beans>
 <service  xmlns="http://xfire.codehaus.org/config/1.0">
  <name>HelloService</name>  
  <serviceClass>com.services.HelloService</serviceClass>  <implementationClass>com.services.HelloServiceImpl</implementationClass>
 </service>
</beans>
文件的内容如下：
：发布一个web service；
：发布web service的名称；
：提供服务的接口类；
：实现服务接口类的具体类。

注：这里用的Spring 2.0，如果是用xfire 自带的Spring1.2.6，应该将  xmlns="http://xfire.codehaus.org/config/1.0" 放到里去定义。
1.4、下面，将这个web 项目，发布到tomcat下，便可以使用
http://localhost:8080/xfire/services/HelloService?wsdl
来调用这个web service了。
 于Spring 集成的Xfire 开发web services，这里用的是spring 2.0，如果是spring2.5，需要将spring-webmvc.jar添加进来。

下面说与Spring 集成的Xfire开发步骤
Spring 与xfire 有三种结合方式，下面以直接与spring集成的方法说明。
（通过Spring的org.springframework.web.servlet.DispatcherServlet）。
2.1、将xfire与spring的JAR包放到web 项目的classPath
2.2、修改web.xml，使其支持Spring 与xfire，添加如下内容：
 
<context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>
   /WEB-INF/conf/applicationContext.xml
   classpath:org/codehaus/xfire/spring/xfire.xml
  </param-value>
 </context-param>
 <listener>
  <listener-class>
   org.springframework.web.context.ContextLoaderListener
  </listener-class>
 </listener>
 <servlet>
  <servlet-name>xfire</servlet-name>
  <servlet-class>
   org.springframework.web.servlet.DispatcherServlet
  </servlet-class>
  <load-on-startup>0</load-on-startup>
 </servlet>
 <servlet-mapping>
  <servlet-name>xfire</servlet-name>
  <url-pattern>/service/*</url-pattern>
 </servlet-mapping>


2.3、根据web.xml的内容，创建Spring的配置文件：applicationContext.xml
在本例中，将此文件放在WEB-INF/conf目录下。内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
   <bean id="helloBean" class="com.service.HelloServiceImpl" />
</beans>


这里，定义了一个bean,这里用的是web services接口的实现类。
  2.4、在WEB-INF下创建xfire-servlet.xml文件，这里的xfire是org.springframework.web.servlet.DispatcherServlet这个servlet的名称，应该根据自己的进行修改
内容如下：


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
 <!-- 在这写上这名，这样就可以用applicationContext.xml里定义的Bean -->
 <import resource="classpath:org/codehaus/xfire/spring/xfire.xml" />
 
 <!-- 这是定义URL映射 -->
 <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
  <property name="urlMap">
   <map>
    <!-- 在这写每一个Web Service的URL映射 -->
    <entry key="/HelloService"> //URL，访问地址
     <ref bean="hello" />
    </entry>    
   </map>
  </property>
 </bean>
 
 <!-- 定义一个基础Service,以下的Service引用它 -->
 <bean id="baseWebService"
  class="org.codehaus.xfire.spring.remoting.XFireExporter"
  lazy-init="false" abstract="true">
  <!-- 引用xfire.xml中定义的工厂 -->
  <property name="serviceFactory" ref="xfire.serviceFactory" />
  <!-- 引用xfire.xml中的xfire实例 xfire是web.xml配置的DispatcherServlet的名称-->
  <property name="xfire" ref="xfire" />
 </bean>

 <!-- 定义一个Hello　的WebService，这里的serviceClass是接口 -->
 <bean id="hello" parent="baseWebService">
  <property name="serviceBean">
   <ref bean="helloBean" />
  </property>
  <property name="serviceClass">
   <value>com.service.HelloService</value>
  </property>
 </bean>
</beans>


这样便生成一个web Service，可以通过域名来访问，并编写客户端代码了。

另一种方式，使用xfire自带的org.codehaus.xfire.spring.XFireSpringServlet这个类进行设置。
方法如下：
修改web.xml，添加如下内容：
 
<context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>/WEB-INF/applicationContext.xml</param-value>
 </context-param>
 <listener>
  <listener-class>
   org.springframework.web.context.ContextLoaderListener
  </listener-class>
 </listener>

 <!--XFire 配置  -->
 <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>

这样，便不必使用xfire-servlet.xml文件，直接在applicationContext.xml里添加Web Service的Bean就可以了。applicationContext.xml代码如下：


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>

 <!-- web service 配置 -->
 <import resource="classpath:org/codehaus/xfire/spring/xfire.xml" />


 <bean id="HelloServiceImpl"
  class="com.service.impl.HelloServiceImpl" />

 <bean id="HelloService"
  class="org.codehaus.xfire.spring.remoting.XFireExporter">
  <property name="xfire" ref="xfire" />
  <property name="serviceBean" ref="HelloServiceImpl" />
  <!-- WebService的实现类bean -->
  <property name="serviceClass"
   value="com.service.service.HelloService" />
 </bean>
</beans>

但个Web Service是没有任何安全性可言的，任何拿到WSDL的人都可以轻松地构造客户端程序访问我们的Web Service服务。