xfire 使用及常见问题

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


xfire的servlet（看api）：
[b]public class XFireServlet extends HttpServlet
public class XFireConfigurableServlet extends XFireServlet
public class XFireSpringServlet extends XFireServlet[/b]

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


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

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
具体参见：
[url]http://www.wozaishuo.com.cn/article.asp?id=276[/url]


[b]XFire与Spring结合的几种方式
[url]http://blog.csdn.net/daryl715/archive/2007/07/23/1703403.aspx[/url][/b]
总结：
两种方式的区别：
[color=red]1 通过org.codehaus.xfire.spring.XFireSpringServlet与org.codehaus.xfire.spring.ServiceBean配web services服务：[/color]
[img]http://www.iteye.com/upload/attachment/135885/6f8f4529-3929-341e-97d3-b06dffdb2ed7.png[/img]
[color=red]2 通过 org.springframework.web.servlet.DispatcherServlet；org.springframework.web.servlet.handler.SimpleUrlHandlerMapping；org.codehaus.xfire.spring.remoting.XFireExporter来配web services服务：[/color]
[img]http://www.iteye.com/upload/attachment/135891/91cecd9c-6773-301b-a8cd-a00a6450a332.png[/img]


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


[size=large][color=red][b][align=center]在spring中集成xfire(使用DispatcherServlet)[/align][/b][/color][/size]
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文件，[color=red][b]根据Spring规范，这个文件名起做xfire-servlet.xml,其中xfire是web.xml配置的DispatcherServlet的名称[/b][/color]:

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

[color=red][b]这个文件的上半部分将MathService这个URL和math这个bean联系在一起。下半部分定义了Web服务的bean和服务接口[/b][/color]。其中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

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