xfire入门（三）

XFire 应用配置

    前面的章节中我们下载和安装了 XFire 安装包和所需要的支持环境，现在我们开始学习如何从零开始创建 XFire 应用开发环境。下面的所有配置过程和发布步骤均针对 TOMCAT（版本5.0.30）服务器，如果选择其它的 Servlet 容器，下面的配置过程和步骤可能需要做出调整，请读者根据实际 Servlet 容器的帮助文档进行相应调整。

1、创建 Web 应用目录和基本元素

在 %TOMCAT_HOME%/webapps 目录下创建新的 Web 应用目录 “XFire”
[注] 其中的 %TOMCAT_HOME% 指向 TOMCAT 的安装目录。

在 ”XFire”目录下创建 ”WEB-INF”目录、
在 ” WEB-INF”目录下创建 ”lib”目录和 ”classes”目录
在 ” WEB-INF”目录下创建 Web 应用描述文件 ”web.xml”， ”web.xml”文件的内容见 清单 1-1。

清单 1-1 WEB-INF\web.xml
               
1、 <?xml version="1.0" encoding="ISO-8859-1"?>
2、 <web-app xmlns="http://java.sun.com/xml/ns/j2ee"
3、     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4、     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee  
   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
5、     version="2.4">
6、
7、     <display-name>XFire实例</display-name>
8、     <description>
9、          基于XFire框架发布Web服务的例子
10、     </description>
11、
12、 </web-app>



2、拷贝 XFire 所需的支持类包文件

拷贝 %XFIRE_HOME%/lib 目录下所有文件到 “1、创建 Web 应用目录和基本元素” 中所创建的 ”lib”目录下，将 %XFIRE_HOME%/XFire-all-1.2.6.jar 文件也拷贝到 “1、创建 Web 应用目录和基本元素” 中所创建的 ”lib”目录下。将 xalan 安装包中的所有 jar 文件和所需要的支持 jar 文件拷贝到相同的 ”lib”目录下。

[注] 为了减少拷贝的 jar 文件的数目，开发者可以根据项目的需要选择需要拷贝的 jar 文件，而不是全部拷贝，如何根据需要选择拷贝合适的类包文件请访问 XFire 站点。

3、配置 XFire 框架运行所需的 Servlet

修改 web.xml 文件，在其中增加如下 Servlet 定义内容。

1、 <servlet>
2、     <servlet-name>XFireServlet</servlet-name>
3、     <display-name>XFire Servlet</display-name>
4、     <servlet-class>
5、         org.codehaus.xfire.transport.http.XFireConfigurableServlet
6、     </servlet-class>
7、   </servlet>
8、
9、   <servlet-mapping>
10、     <servlet-name>XFireServlet</servlet-name>
11、     <url-pattern>/servlet/XFireServlet/*</url-pattern>
12、   </servlet-mapping>
13、
14、   <servlet-mapping>
15、     <servlet-name>XFireServlet</servlet-name>
16、     <url-pattern>/services/*</url-pattern>
17、 </servlet-mapping>



4、创建 XFire 框架的服务发布文件 services.xml

在 “1、创建 Web 应用目录和基本元素” 中创建的 classes 目录下新建目录 ”META-INF\xfire”；
在步骤 a) 中新建的 ”xfire”文件目录下创建新文件 services.xml，文件的默认内容如 清单1-2 。

清单 1-2 WEB-INF\classes\META-INF\xfire\services.xml
               
1、 <beans xmlns="http://XFire.codehaus.org/config/1.0">
2、 </beans>