手工打包CXF服务发布到Tomcat

刚开始学习CXF时，服务端、客户端代码都是eclipse的STP插件自动生成的，直接运行***_Client或是***_Server类就可以运行相应服务的客户端或是发布相应的服务端，但一直都不知道怎么发布到 Tomcat里，由Tomcat统一管理，于是就想到了随CXF一起发布的示例代码。从控制台定位到其中一个实例wsdl_first中，运行ant war命令，自动生成了打包好的war文件（可以直接发布到Tomcat中）。解压后发现，只要稍微修改一下，就可以打包出我自己的服务发布包。

 

实验环境：JDK1.6.0_07，eclipse 3.4+STP插件，Tomcat6，Fedora9

 

实验步骤：

1.编写wsdl文件，其中我的service节点如下：

<wsdl:service name="bookticket">
		<wsdl:port binding="tns:bookticketSOAP" name="bookticketSOAP">
			<soap:address location="http://localhost:8080/stitp/services/book_ticket" />
		</wsdl:port>
</wsdl:service>

 

2.使用eclipse的插件 根据写好的wsdl文件， 新建一个wsdl first工程并生成服务端代码。修改自动生成的代码，加入我自己的功能。

 

3.接下来就是打包的过程了。解开示例程序的war包，取出lib文件夹（里面是服务端依赖的库包，如果自己的功能有依赖，也加进来）。新建两个文件夹：META-INF,WEB-INF，将刚才修改过的lib文件夹和我们工程下的classes文件夹（eclipse自动生成）放到WEB-INF文件夹下。

 

4.修改示例程序war里的web.xml和cxf-servlet.xml如下

<?xml version="1.0" encoding="UTF-8"?>
<!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>
    <display-name>cxf</display-name>
    <description>cxf</description>
    <servlet>
        <servlet-name>cxf</servlet-name>
        <display-name>cxf</display-name>
        <description>Apache CXF Endpoint</description>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>cxf</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>
    <session-config>
        <session-timeout>60</session-timeout>
    </session-config>
</web-app>

 

<?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:jaxws="http://cxf.apache.org/jaxws"
      xmlns:soap="http://cxf.apache.org/bindings/soap"
      xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/bindings/soap http://cxf.apache.org/schemas/configuration/soap.xsd
http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">

    <jaxws:endpoint
        id="bookticket"
        implementor="localhost._8080.bookticket.BookticketImpl"
        wsdlLocation="WEB-INF/classes/bookticket.wsdl"
        address="/book_ticket">
                <jaxws:features>
 		    <bean class="org.apache.cxf.feature.LoggingFeature"/>
                </jaxws:features>
    </jaxws:endpoint>
</beans>

 并将它们都放到WEB-INF文件夹下面

 

5.接着将 META-INF和WEB-INF 两个文件夹打包成一个war文件，例如stitp.war。

 

6.启动Tomcat，发布我们这个war包，提示OK的话，如果在浏览器中输入：http://localhost:8080/stitp/services/book_ticket?wsdl能可看到我们的wsdl文件则说明我们的服务发布成功了！

 

7. 再用eclipse插件 新建一个客户端工程，依旧是wsdlfirst类型的工程，这次在选择wsdl文件的位置时，可以输入我们实际在浏览器里能访问的地址：http://localhost:8080/stitp/services/book_ticket?wsdl，点击connect可以检测一下能否获取到文件。接下来的工作就和开发访问独立发布的服务的过程一样了，运行经验一下你的服务吧！

 

后记：至于这样发布服务的原理还在研究中，感觉应该是通过spring框架实现的。等理解了再奉上报告。

其实发布的原理很简单, 关键在于"org.apache.cxf.transport.servlet.CXFServlet"的配置。
CXFServlet 负责实现HTTP transport 部分的配置， 其他有关WebServices endpoint的配置通过Spring 加载beans.xml 获得。

写过Servlet程序的人都知道最后的业务逻辑都会交给 doGet， doPost 这些方法来之下。 CXFServlet就是把这些调用转发到CXF的interceptor chain中，完成对SOAP消息的处理，并将处理结果放置到response中。

恩，是的，谢谢前辈了。我也正是在看CXFServlet的代码，跟着它的方法跳来跳去，正云里雾里的……