XFire 入门

约定不等于承诺〃 2021-09-10 05:32 342阅读 0赞

<table style="TABLE-LAYOUT: fixed"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <p><font><strong>转:http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#h1</strong></font></p> 
     <p> </p> 
     <table> 
      <tbody> 
       <tr> 
        <td> <h1>XFire 入门</h1> <p>轻松将 POJO 发布成 Web 服务</p> <img height="6" src="http://www.ibm.com/i/c.gif" width="1" alt=""></td> 
        <td><img height="18" alt="developerWorks" src="http://www.ibm.com/developerworks/i/dw.gif" width="192"></td> 
       </tr> 
      </tbody> 
     </table> 
     <table> 
      <tbody> 
       <tr> 
        <td><img height="1" src="http://www.ibm.com/i/c.gif" width="10" alt=""></td> 
        <td> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/c.gif" width="10" alt=""></td> 
            <td> 
             <table> 
              <tbody> 
               <tr> 
                <td>文档选项</td> 
               </tr> 
              </tbody> 
             </table> 
             <table> 
              <tbody> 
               <tr> 
                <td> 
                 <table> 
                  <tbody> 
                   <tr> 
                    <td><img height="1" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
                    <td><img height="16" alt="将此页作为电子邮件发送" src="http://www.ibm.com/i/v14/icons/em.gif" width="16"></td> 
                    <td> <p><a rel="nofollow"><strong><font>将此页作为电子邮件发送</font></strong></a></p> </td> 
                   </tr> 
                  </tbody> 
                 </table> </td> 
               </tr> 
              </tbody> 
             </table> <br><br></td> 
           </tr> 
          </tbody> 
         </table> <p>级别： 初级</p> <p><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#author" rel="nofollow"><font>肖 菁</font></a>, 自由撰稿人<br></p> <p>2007 年 5 月 16 日</p> 
         <blockquote>
           Java 社区一直试图将 POJO 的作用发挥到极致，降低 Java 应用实现的难度，最近的尝试是将 EJB3.0 建立在 POJO 之上；另一方面，SOA 是目前 Java 社区炙手可热的名词，非常多的企业都在努力应用和实施 SOA；XFire 为这两方面的需求提供了一种魔术般的解决方式，我们很快能够发现使用 XFire 创建和发布 Web 服务可以直接基于 POJO，将烦人的继承关系和一大堆其他可能的约束丢在一边。 
         </blockquote> <p><a rel="nofollow"><span><font>POJO、SOA 概述</font></span></a></p> <p><a rel="nofollow"><span><strong><font>被重新审视的 POJO</font></strong></span></a></p> <p>POJO（Plain Old Java Object，简单 Java 对象）是 Java 社区中最早的成员（回想您学习 Java 时第一个兴奋的时刻，那个简单的 "Hello World！" 例子），也是最简单、最容易实现的方式。</p> <p>然而现实中 Java 的发展已经远远超越了 POJO 的范围，成为面向对象技术应用中最成功的编程语言，尤其是继承、多态的应用为我们造就了一大批开发框架（如 Struts）和标准（如 EJB），随之而来的就是实现的复杂化，我们必须面对一大堆继承关系的限制。比如说：要开发一个基于 Struts 的应用，我们必须了解 Struts 特定的继承关系如 ActionForm、ValidateActionForm；要开发一个 EJB 应用，我们必须继承 EJBObject、SessionEJB 等。</p> <p>为了抛开这些限制，降低 Java 应用实现的难度，Java 社区开始重新审视 POJO 的价值，试图将 POJO 的作用发挥到极致，最新的努力是 EJB3.0。Java 社区将 EJB3.0 设计为基于 POJO，而不是为他准备更多的继承关系等限制。</p> <p><a rel="nofollow"><span><strong><font>让人爱恨交加的 SOA</font></strong></span></a></p> <p>SOA 已经成为了目前 Java 社区中炙手可热的名词，几乎所有的软件厂商都在讨论它，为他提供解决方案和产品支持，大部分的企业也已经在企业内部实施或者正在考虑实施 SOA。</p> <p>然而 SOA 在企业内的实施却不是一项简单的任务，即使抛开新建系统直接基于 SOA 架构实施的因素，要把企业已有系统纳入 SOA 框架也不是一件容易的事情。企业必须在对当前架构深入了解的基础上，对已有系统进行大规模的改造才能满足新的要求。如何经济的从原有技术架构切换到 SOA 架构成为很多企业的难题。</p> <br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>XFire 概述</font></span></a></p> <p>XFire 是 codeHaus 组织提供的一个开源框架，它构建了 POJO 和 SOA 之间的桥梁，主要特性就是支持将 POJO 通过非常简单的方式发布成 Web 服务，这种处理方式不仅充分发挥了 POJO 的作用，简化了 Java 应用转化为 Web 服务的步骤和过程，也直接降低了 SOA 的实现难度，为企业转向 SOA 架构提供了一种简单可行的方式。</p> <p>XFire 目前最新的版本是 1.2.2，目前支持的特性主要包括：</p> 
         <ul> 
          <li>支持将 Web 服务绑定到 POJO、XMLBeans、JAXB1.1、JAXB2.0 和 Castor； </li> 
          <li>支持基于 HTTP、JMS、XMPP 等多种协议访问 Web 服务； </li> 
          <li>支持多种 Web 服务业界重要标准如 SOAP、WSDL、Web 服务寻址（WS-Addressing）、Web 服务安全（WS-Security）等； </li> 
          <li>支持 JSR181，可以通过 JDK5 配置 Web 服务； </li> 
          <li>高性能的 SOAP 实现； </li> 
          <li>服务器端、客户端代码辅助生成； </li> 
          <li>对 Spring、Pico、Plexus 等项目的支持等。 </li> 
         </ul> <br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>XFire 安装包</font></span></a></p> <p>XFire 框架目前的最新版本是 1.2.6，可以访问 xfire.codehaus.org 下载 XFire 框架的安装包，下载时请选择“全部二进制发布包（Binary Distribution in zip package）”，而不仅仅是“XFire jar 文件（Jar of all XFire modules）”。</p> <p>下载完成后，我们可以将下载的 .zip 文件解压缩到任意的文件夹中（后面的章节中使用 % XFIRE_HOME % 表示 XFire 框架的安装目录），解压缩后形成的文件目录结构如下：</p> 
         <ul> 
          <li><strong>api（目录）</strong> <p>api 目录中是 XFire 框架中所有类（class）对应的 API 文档，为开发者使用 XFire 完成应用开发提供帮助。</p> </li> 
          <li><strong>examples（目录）</strong> <p>examples 目录中包含了所有随 XFire 二进制包发布的实例，包括这些实例的源代码和相关 Web 应用配置内容。</p> </li> 
          <li><strong>lib（目录）</strong> <p>lib 目录中包含 XFire 运行所需要的外部支持类包（.jar文件），可以根据不同项目所需的 XFire 特性选择所需要的支持类包。保守的方法是在 Web 项目中包含所有的外部支持类包（.jar文件）。</p> </li> 
          <li><strong>manual（目录）</strong> <p>manual 目录中包含有 XFire 框架的帮助文档，开发者可以从这些帮助文档中学习更多运用 XFire 框架实现 SOA 的知识和技巧。</p> </li> 
          <li><strong>modules（目录）</strong> <p>modules 目录中包含了 XFire 框架根据不同特性分别编译的二进制包文件。发布基于 XFire 框架的 Web 项目时，可以选择使用该目录下的所有 .jar 文件，也可以选择 XFire-all-1.2.6.jar 文件。</p> </li> 
          <li><strong>XFire-all-1.2.6.jar</strong> <p>XFire 框架的二进制包文件，包含了全部的模块（modules）。</p> </li> 
          <li><strong>LICENSE.txt</strong> <p>LICENSE.txt 文件中包含了 XFire 框架的授权协议。</p> </li> 
          <li><strong>NOTICE.txt</strong> </li> 
          <li><strong>README.txt</strong> <p>这两个文件中包含了 XFire 发布时的一些有用的信息。</p> </li> 
         </ul> <br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>XFire 框架支撑环境</font></span></a></p> <p>XFire框架是一种基于Servlet技术的SOA应用开发框架，要正常运行基于XFire应用框架开发的企业应用，除了XFire框架本身之外，还需要JDK和Servlet容器的支持。</p> <p><a rel="nofollow"><span><strong><font>1．JDK 版本选择、下载和安装</font></strong></span></a></p> <p>XFire 支持非常多的特性，其中不同的特性对 JDK 版本的要求有所不同，比如如果项目中选择基于 JSR181 标准发布 Web 服务，我们就需要选择 JDK5 或者以上版本，如果仅仅选择将 Web 服务绑定到最简单的 POJO，我们只需要选择 JDK1.4 版本即可。</p> <p>JDK 各版本均可以在 <a href="http://java.sun.com/" rel="nofollow"><font>java.sun.com</font></a> 网站上下载，如何安装 JDK 请参考 SUN 公司的相关技术文档和 JDK 的帮助文档。</p> <p><a rel="nofollow"><span><strong><font>2．Servlet 容器下载和安装</font></strong></span></a></p> <p>XFire 是一种基于 Servlet 技术的 SOA 应用开发框架，需要 Servlet 容器的支持。XFire 支持在多种 Servlet 容器中运行，包括 Websphere、Weblogic、TOMCAT 等。为了说明的简单，我们选择使用 TOMCAT（版本5.0.30）作为 XFire 的运行容器，所有配置过程和发布步骤的说明也均是针对 TOMCAT，如果读者使用 TOMCAT 之外的其它 Servlet 容器或者选择了 TOMCAT 的其它版本，下面的配置过程和步骤可能需要做出调整，请读者根据实际 Servlet 容器的帮助文档进行相应调整。</p> <p>TOMCAT 各版本均可以在 <a href="http://tomcat.apache.org/" rel="nofollow"><font>tomcat.apache.org</font></a> 网站上下载，如何正确安装 TOMCAT 服务器请参考 TOMCAT 服务器的帮助文档。</p> <p><a rel="nofollow"><span><strong><font>3．xalan</font></strong></span></a></p> <p>XFire 需要 xalan 项目的支持，然而 1.2.6 版本中并没有带有相应的 jar 文件，因此请访问 <a href="http://xml.apache.org/" rel="nofollow"><font>xml.apache.org</font></a>，下载 xalan 项目的二进制包。</p> <br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>XFire 应用配置</font></span></a></p> <p>前面的章节中我们下载和安装了 XFire 安装包和所需要的支持环境，现在我们开始学习如何从零开始创建 XFire 应用开发环境。下面的所有配置过程和发布步骤均针对 TOMCAT（版本5.0.30）服务器，如果选择其它的 Servlet 容器，下面的配置过程和步骤可能需要做出调整，请读者根据实际 Servlet 容器的帮助文档进行相应调整。</p> <p><a rel="nofollow"><span><strong><font>1、创建 Web 应用目录和基本元素</font></strong></span></a></p> 
         <ol> 
          <li>在 %TOMCAT_HOME%/webapps 目录下创建新的 Web 应用目录 “XFire” <p><em>[注] 其中的 %TOMCAT_HOME% 指向 TOMCAT 的安装目录。</em> </p> </li> 
          <li>在 ”XFire”目录下创建 ”WEB-INF”目录、 </li> 
          <li>在 ” WEB-INF”目录下创建 ”lib”目录和 ”classes”目录 </li> 
          <li>在 ” WEB-INF”目录下创建 Web 应用描述文件 ”web.xml”， ”web.xml”文件的内容见 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#code11" rel="nofollow"><font>清单 1-1</font></a>。 </li> 
         </ol> <br><a rel="nofollow"><strong><font>清单 1-1 WEB-INF/web.xml</font></strong></a><br> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
1、 &lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
2、 &lt;web-app xmlns="http://java.sun.com/xml/ns/j2ee"
3、 &nbsp;&nbsp;&nbsp;&nbsp; xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4、 &nbsp;&nbsp;&nbsp;&nbsp; xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee&nbsp;&nbsp;&nbsp; 
   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
5、 &nbsp;&nbsp;&nbsp;&nbsp; version="2.4"&gt;
6、 
7、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;display-name&gt;XFire实例&lt;/display-name&gt;
8、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;description&gt;
9、 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 基于XFire框架发布Web服务的例子
10、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;/description&gt;
11、 
12、 &lt;/web-app&gt;
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br> <p><a rel="nofollow"><span><strong><font>2、拷贝 XFire 所需的支持类包文件</font></strong></span></a></p> <p>拷贝 %XFIRE_HOME%/lib 目录下所有文件到 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#h1" rel="nofollow"><font>“1、创建 Web 应用目录和基本元素”</font></a> 中所创建的 ”lib”目录下，将 %XFIRE_HOME%/XFire-all-1.2.6.jar 文件也拷贝到 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#h1" rel="nofollow"><font>“1、创建 Web 应用目录和基本元素”</font></a> 中所创建的 ”lib”目录下。将 xalan 安装包中的所有 jar 文件和所需要的支持 jar 文件拷贝到相同的 ”lib”目录下。</p> <p><strong>[注] </strong>为了减少拷贝的 jar 文件的数目，开发者可以根据项目的需要选择需要拷贝的 jar 文件，而不是全部拷贝，如何根据需要选择拷贝合适的类包文件请访问 <a href="http://xfire.codehaus.org/Dependency+Guide" rel="nofollow"><font>XFire 站点</font></a>。 </p> <p><a rel="nofollow"><span><strong><font>3、配置 XFire 框架运行所需的 Servlet</font></strong></span></a></p> <p>修改 web.xml 文件，在其中增加如下 Servlet 定义内容。</p> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>1、 &lt;servlet&gt;
2、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;servlet-name&gt;XFireServlet&lt;/servlet-name&gt;
3、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;display-name&gt;XFire Servlet&lt;/display-name&gt;
4、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;servlet-class&gt;
5、 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; org.codehaus.xfire.transport.http.XFireConfigurableServlet
6、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;/servlet-class&gt;
7、 &nbsp;&nbsp; &lt;/servlet&gt;
8、 
9、 &nbsp;&nbsp; &lt;servlet-mapping&gt;
10、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;servlet-name&gt;XFireServlet&lt;/servlet-name&gt;
11、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;url-pattern&gt;/servlet/XFireServlet/*&lt;/url-pattern&gt;
12、 &nbsp;&nbsp; &lt;/servlet-mapping&gt;
13、 
14、 &nbsp;&nbsp; &lt;servlet-mapping&gt;
15、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;servlet-name&gt;XFireServlet&lt;/servlet-name&gt;
16、 &nbsp;&nbsp;&nbsp;&nbsp; &lt;url-pattern&gt;/services/*&lt;/url-pattern&gt;
17、 &lt;/servlet-mapping&gt;
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br> <p><a rel="nofollow"><span><strong><font>4、创建 XFire 框架的服务发布文件 services.xml</font></strong></span></a></p> 
         <ol> 
          <li>在 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#h1" rel="nofollow"><font>“1、创建 Web 应用目录和基本元素”</font></a> 中创建的 classes 目录下新建目录 ”META-INF/xfire”； </li> 
          <li>在步骤 a) 中新建的 ”xfire”文件目录下创建新文件 services.xml，文件的默认内容如 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#code12" rel="nofollow"><font>清单1-2</font></a> 。 </li> 
         </ol> <br><a rel="nofollow"><strong><font>清单 1-2 WEB-INF/classes/META-INF/xfire/services.xml</font></strong></a><br> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
1、 &lt;beans xmlns="http://XFire.codehaus.org/config/1.0"&gt;
2、 &lt;/beans&gt;
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>将 POJO 发布成 Web 服务</font></span></a></p> <p>XFire 框架中，我们有两种方式将 POJO 发布成 Web 服务：</p> 
         <ul> 
          <li>一种方式是直接使用 Web 服务接口和 Web 服务实现类（POJO）来发布； </li> 
          <li>另一种方式是基于 JSR181 标准和注释技术将被注释的 POJO 发布成 Web 服务； </li> 
         </ul> <p>下面的章节中我们将学习使用第一种方式来完成 POJO 的 Web 服务发布。我们将使用经典的 ”Hello World!”例子来演示将 POJO 发布成 Web 服务所需要的步骤，不过我们不再是简单的访问一个 Java 方法来输出 ”Hello World!”字符串，而是转为在 SOA 环境下实现：Web 服务客户端通过访问服务器端发布成 Web 服务的 POJO 获得返回的 ”Hello World!”字符串后输出到客户端的控制台上。</p> <p>将 POJO 发布成 Web 服务的基本步骤如下：</p> 
         <ol> 
          <li>创建 Web 服务接口，声明该 Web 服务对外暴露的接口； </li> 
          <li>创建 Web 服务实现类，为 Web 服务接口提供实现； </li> 
          <li>修改 XFire 框架的服务发布文件 ---- services.xml，将 POJO 发布成 Web 服务。 </li> 
         </ol> <p>下面我们通过创建 ”Hello World!”例子来具体说明如何实现这三个步骤。</p> <p><a rel="nofollow"><span><strong><font>1．创建 Web 服务接口 ---- HelloWorldService</font></strong></span></a></p> <p>要将 POJO 发布成 Web 服务，首先需要创建 Web 服务接口，在接口中声明该 Web 服务需要对外暴露的接口。</p> <p>我们根据需要创建 Web 服务接口 ” HelloWorldService”，在其中声明一个 ”sayHello”方法，该方法返回 ”String ”类型的内容。” HelloWorldService”接口对应的 Java 文件代码如 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#code13" rel="nofollow"><font>清单 1-3</font></a>。</p> <br><a rel="nofollow"><strong><font>清单 1-3 WEB-INF/classes/org/vivianj/xfire/pojo/HelloWorldService.java</font></strong></a><br> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
1．package org.vivianj.xfire.pojo;
2．
3． /**
4． * HelloWorldService 中声明需要发布成 Web 服务的所有 Java 方法 
5． * HelloWorldService 作为Web服务接口
6． */
7． public interface HelloWorldService {
8． /**
9． &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; * sayHello 方法声明了 Web 服务对外暴露的接口
10．  * 
11．  * @return 返回给客户端的字符串
12．  */
13． public String sayHello();
14．}
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br> <p><a rel="nofollow"><span><strong><font>2．创建 Web 服务实现类 ”HelloWorldServiceImpl”</font></strong></span></a></p> <p>创建 Web 服务实现类 ”HelloWorldServiceImpl”，它继承 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#h1" rel="nofollow"><font>”1、创建Web服务接口 ---- HelloWorldService”</font></a> 中创建的 HelloWorldService 接口，并且为它声明的 ”sayHello”方法提供具体实现： 返回字符串”Hello World!”。 ”HelloWorldServiceImpl”类对应的 Java 文件代码如 <a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#code14" rel="nofollow"><font>清单 1-4</font></a>。</p> <br><a rel="nofollow"><strong><font>清单 1-4 WEB-INF/classes/org/vivianj/xfire/pojo/HelloWorldServiceImpl.java</font></strong></a><br> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
1．package org.vivianj.xfire.pojo;
2．
3．/**
4． * HelloWorldServiceImpl 中为 Web 服务接口中声明的所有 Java 方法提供具体实现 
5． * HelloWorldServiceImpl 作为 Web 服务的实现类
6． */
7．public class HelloWorldServiceImpl implements HelloWorldService {
8．
9． /*
10．  * sayHello 方法为 HelloWorldService 服务接口定义的 sayHello 方法提供具体实现
11．  *&nbsp;&nbsp; 
12．  * @see org.vivianj.XFire.pojo.HelloWorldService#sayHelloToXFire()
13．  */
14． public String sayHello() {
15．  return "Hello World!";
16． }
17．
18．}
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br> <p><a rel="nofollow"><span><strong><font>3．修改 services.xml，将 POJO 发布成 Web 服务</font></strong></span></a></p> <p>我们可以在 WEB-INF/classes/META-INF/XFire/services.xml 文件中的 &lt;beans …&gt; 和 &lt;/beans&gt; 元素中间加入如下的 xml 内容将上面创建的 HelloWorldService 发布成 Web 服务。</p> 
         <table> 
          <tbody> 
           <tr> 
            <td> <pre>1．&lt;service&gt;
2． &lt;name&gt;HelloWorldService&lt;/name&gt;
3． &lt;namespace&gt;http://vivianj.org/HelloWorldService&lt;/namespace&gt;
4． &lt;serviceClass&gt;
5．  org.vivianj.xfire.pojo.HelloWorldService
6． &lt;/serviceClass&gt;
7． &lt;implementationClass&gt;
8．  org.vivianj.xfire.pojo.HelloWorldServiceImpl
9． &lt;/implementationClass&gt;
10．&lt;/service&gt;
</pre> </td> 
           </tr> 
          </tbody> 
         </table> <br> <p>其中各元素的功能如下：</p> 
         <ul> 
          <li><strong>service</strong> <p>service 标签和它所包含的 xml 内容为发布成 Web 服务的 POJO 提供完整的描述。</p> </li> 
          <li><strong>name</strong> <p>Web 服务被发布时所采用的唯一名称。</p> </li> 
          <li><strong>namespace</strong> <p>Web 服务发布时所使用的命名空间。</p> </li> 
          <li><strong>serviceClass</strong> <p>Web 服务接口类的全名，包括包名和类名。</p> </li> 
          <li><strong>implemetationClass</strong> <p>Web 服务实现类的全名，包括包名和类名。</p> </li> 
         </ul> <p>更多 service 元素的子元素和它们的用法请参考 <a href="http://xfire.codehaus.org/services.xml+Reference" rel="nofollow"><font>XFire 站点</font></a>。</p> <p>通过上面的三个步骤，我们已经将新创建的HelloWorldService发布成了Web服务，我们可以使用下面的步骤测试一下创建的Web服务是否能够正常运行：</p> 
         <ol> 
          <li>编译上面的步骤中创建的 Java 接口和类； </li> 
          <li>启动 TOMCAT 服务器。 </li> 
          <li>等 TOMCAT 服务器完全启动后，打开浏览器，在地址栏中输入 http://localhost:8080/XFire/services/HelloWorldService?wsdl。 </li> 
         </ol> <p>其中 HelloWorldServcie 是配置文件中 service/name 元素所定义的内容，”wsdl”参数表示查看该 Web 服务的 WSDL（Web服务描述语言）文件。</p> <p>如果浏览器中出现如下图所示类似的内容，表示 Web 服务发布成功，我们可以编写客户端访问该 Web 服务从服务器获取返回字符串，本文下载资源中提供的下载文件中包含有可供参考的客户端类 org.vivianj.xfire.pojo.client.HelloWorldServiceClient。</p> <br><a rel="nofollow"><strong><font>图：浏览器中访问效果</font></strong></a><br><img src="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/fig001.jpg" alt=""> <br> <p>如果浏览器中出现错误提示，请按照上面的步骤和说明检查已经完成的开发、配置过程是否完全正确。</p> <br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>结束语</font></span></a></p> <p>本文中作者首先讲解了 XFire 框架的主要特性，XFire 框架的运行环境以及基于 XFire 框架开发 SOA 应用的基本步骤，并且借助于 SOA 环境下的 ”Hello World!”例子，详细的讲解和演示了如何基于 XFire 框架、经过简单的开发、配置步骤就将一个 POJO 类中包含的方法发布成Web服务。从 ”Hello World!”例子实现的过程中，我们可以发现 XFire 框架最大化的发挥了 POJO 的作用，减少了 SOA 实施时对框架本身的依赖，降低了 SOA 实施的难度，企业实施 SOA 时并不需要增加太多的投入就可以实现目标。</p> <br><br> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="1" src="http://www.ibm.com/i/v14/rules/blue_rule.gif" width="100%" alt=""><br><img height="6" src="http://www.ibm.com/i/c.gif" width="8" alt=""></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td><img height="4" src="http://www.ibm.com/i/c.gif" width="100%" alt=""><br> 
             <table> 
              <tbody> 
               <tr> 
                <td><img height="16" src="http://www.ibm.com/i/v14/icons/u_bold.gif" width="16" alt=""><br></td> 
                <td align="right"><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/#main" rel="nofollow"><strong><font>回页首</font></strong></a></td> 
               </tr> 
              </tbody> 
             </table> </td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><span><a rel="nofollow"><font>下载</font></a></span></p> 
         <table> 
          <tbody> 
           <tr> 
            <th>名字</th> 
            <th align="right">大小</th> 
            <th>下载方法</th> 
           </tr> 
           <tr> 
            <td>xfire.war</td> 
            <td align="right">6 KB</td> 
            <td><a href="http://www.ibm.com/developerworks/cn/java/j-lo-xfire/xfire.war" rel="nofollow"><strong><font>HTTP</font></strong></a></td> 
           </tr> 
          </tbody> 
         </table> 
         <table> 
          <tbody> 
           <tr> 
            <td colspan="5"><font><img height="12" src="http://www.ibm.com/i/c.gif" width="12" alt=""></font></td> 
           </tr> 
           <tr> 
            <td><font><img height="16" src="http://www.ibm.com/i/v14/icons/fw.gif" width="16" alt=""></font></td> 
            <td><a href="http://www.ibm.com/developerworks/cn/whichmethod.html" rel="nofollow"><font>关于下载方法的信息</font></a></td> 
            <td><font><img height="1" src="http://www.ibm.com/i/c.gif" width="50" alt=""></font></td> 
           </tr> 
          </tbody> 
         </table> <br><br> <p><a rel="nofollow"><span><font>参考资料 </font></span></a></p> <strong>学习</strong><br> 
         <ul> 
          <li>访问 <a href="http://xfire.codehaus.org/User%20s+Guide" rel="nofollow"><font>XFire 框架用户指南</font></a> 可以获得更多关于 XFire 的使用帮助。<br><br></li> 
          <li>访问 <a href="http://xfire.codehaus.org/Eclipse+Plugin" rel="nofollow"><font>XFire 的 Eclipse 插件</font></a> 可以获得关于 XFire 提供的 Eclipse 插件的更多信息。<br><br></li> 
         </ul> <br><strong>获得产品和技术</strong><br> 
         <ul> 
          <li>访问 <a href="http://java.sun.com/" rel="nofollow"><font>java.sun.com</font></a> 获得 JDK 各种版本二进制安装包。<br><br></li> 
          <li>访问 <a href="http://tomcat.apache.org/" rel="nofollow"><font>tomcat.apache.org</font></a> 获得 TOMCAT 服务器各种版本二进制安装包。<br><br></li> 
          <li>访问 <a href="http://xml.apache.org/" rel="nofollow"><font>xml.apache.org</font></a> 获得 xalan 框架各种版本二进制安装包。<br><br></li> 
          <li>访问 <a href="http://http://xfire.codehaus.org/" rel="nofollow"><font>XFire.codehaus.org</font></a> 获得 XFire 框架的二进制安装包。 </li> 
         </ul> <br><br> <p><a rel="nofollow"><span><font>关于作者</font></span></a></p> 
         <table> 
          <tbody> 
           <tr> 
            <td colspan="3"><img height="5" src="http://www.ibm.com/i/c.gif" width="100%" alt=""></td> 
           </tr> 
           <tr> 
            <td> <p>&nbsp;</p> </td> 
            <td><img height="5" src="http://www.ibm.com/i/c.gif" width="4" alt=""></td> 
            <td> <p>肖菁是自由撰稿人，致力于研究和推广 JavaEE、Open Source、SOA 技术，发起了开源项目BuildFileDesigner（buildfiledesign.sourceforge.net）和 V-Security（v-security.sourceforge.net）。可以通过电子邮件 <a href="mailto:cto4u.cn@gmail.com?cc=zoucl@cn.ibm.com" rel="nofollow"><font>cto4u.cn@gmail.com</font></a> 和他取得联系。</p> </td> 
           </tr> 
          </tbody> 
         </table> </td> 
       </tr> 
      </tbody> 
     </table> 
     <p></p> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>