xfire 使用及常见问题

XFire 开发小结
http://www.springside.org.cn/docs/reference/XFire.htm
http://www.blogjava.net/josson/archive/2007/07/20/112292.html


xfire的servlet（看api）：
public class XFireServlet extends HttpServlet
public class XFireConfigurableServlet extends XFireServlet
public class XFireSpringServlet extends XFireServlet

主要类介绍：
通过XFire导出器XFireExporter来讲普通的业务类导出为web services 服务；


关于使用纯Xfire（不集成spring）的NoClassDefFoundError问题：

2009-8-13 17:29:21 org.apache.catalina.core.StandardContext loadOnStartup
严重: Servlet /xfiretest threw load() exception
java.lang.ClassNotFoundException: org.springframework.web.context.support.GenericWebApplicationContext

并没有使用spring，只是个纯的xfire测试配置，为什么会抛spring类找不到的异常那？原来是因为xfire的lib有对spring的依赖。需要添加以下两个jar包到lib：
spring-1.2.6.jar
xbean-spring-2.8.jar
具体参见：
http://www.wozaishuo.com.cn/article.asp?id=276


XFire与Spring结合的几种方式
http://blog.csdn.net/daryl715/archive/2007/07/23/1703403.aspx
总结：
两种方式的区别：
1 通过org.codehaus.xfire.spring.XFireSpringServlet与org.codehaus.xfire.spring.ServiceBean配web services服务：

2 通过 org.springframework.web.servlet.DispatcherServlet；org.springframework.web.servlet.handler.SimpleUrlHandlerMapping；org.codehaus.xfire.spring.remoting.XFireExporter来配web services服务：




使用XFire+Spring构建Web Service（一）——helloWorld篇
http://www.blogjava.net/amigoxie/archive/2007/09/26/148207.html
使用XFire+Spring构建Web Service（二）
http://www.blogjava.net/amigoxie/archive/2009/07/15/149074.html

在spring中集成xfire(使用DispatcherServlet)

XFire可以很好的集成到Spring中，Spring的代码已经做了这方面的集成。
首先，我们先创建我们的Web服务，采用接口和实现类的方式：

接口MathService.java：

package test;
public interface MathService {
    public long add(int p1, int p2);
}

实现类：

package test;

public class MathServiceImpl implements MathService {
    public long add(int p1, int p2)
    {
        return p1 + p2;
    }
}

META-INF/xfire/service.xml文件可以省略了，因为web服务的定义在xfire-servlet.xml中可以找到。
下面要做的工具就是配置了。
在WEB-INF文件夹下创建applicationContext.xml文件，这是Spring的配置文件，如果你使用其他的Spring配置文件，可以将下面的bean添加到那个配置文件中：

<?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="mathBean" class="test.MathServiceImpl"/>
</beans>

定义了mathBean，这个Bean就是我们的实现类，当然你也可以在这个文件中定义其他的需要Spring管理的bean。

WEB-INF文件夹下创建xfire-servlet.xml文件，根据Spring规范，这个文件名起做xfire-servlet.xml,其中xfire是web.xml配置的DispatcherServlet的名称:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
    <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="urlMap">
            <map>
                <entry key="/MathService">
                    <ref bean="math"/>
                </entry>
            </map>
        </property>
    </bean>
   
    <bean id="math" class="org.codehaus.xfire.spring.remoting.XFireExporter">
        <property name="serviceFactory">
            <ref bean="xfire.serviceFactory"/>
        </property>
        <property name="xfire">
            <ref bean="xfire"/>
        </property>
        <property name="serviceBean">
            <ref bean="mathBean"/>
        </property>
        <property name="serviceClass">
            <value>test.MathService</value>
        </property>
    </bean>
</beans>

这个文件的上半部分将MathService这个URL和math这个bean联系在一起。下半部分定义了Web服务的bean和服务接口。其中mathBean是我们在applicationContext.xml中配置的那个Bean。

最后一步就是修改web.xml文件：

<?xml version="1.0" encoding="ISO-8859-1"?>
 
<!DOCTYPE web-app
    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
    "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml
        classpath:org/codehaus/xfire/spring/xfire.xml</param-value>
    </context-param>
 
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>/WEB-INF/log4j.properties</param-value>
    </context-param>
 
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>
 
    <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>
    </servlet>
 
    <servlet-mapping>
        <servlet-name>xfire</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>

需要注意这个文件的三个部分：
1．      在定义contextConfigLocation参数时一定要加上classpath:org/codehaus/xfire/spring/xfire.xml。
2．      定义listener: org.springframework.web.context.ContextLoaderListener
3．      定义DispatcherServlet: xfire

这样，你就可以访问http://localhost:8080/xfire/MathService来调用这个Web服务，也可以通过网址http://localhost:8080/xfire/MathService?wsdl来查看wsdl文档。