基于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服务。