2022年XFire入门教程 .pdf

Web Service 实践之 开始 XFire 一、Axis 与 XFire 的比较XFire 是与 Axis2 并列的新一代WebService 平台。之所以并称为新一代，因为它：1、支持一系列Web Service 的新标准-JSR181、WSDL2.0、JAXB2、WS-Security 等；2、使用 Stax 解释 XML,性能有了质的提高。XFire 采用 Woodstox 作 Stax 实现；3、容易上手，可以方便快速地从pojo 发布服务；4、Spring 的结合；5、灵活的 Binding 机制，包括默认的Acegis,xmlbeans,jaxb2,castor。XFire 与 Axis1 性能的比较1、XFire 比 Axis1.3 快 2-6 倍2、XFire 的响应时间是Axis1.3 的 1/2 到 1/5 XFire 与 Axis2 的比较虽然 XFire 与 Axis2 都是新一代的WebService 平台，但是Axis2 的开发者太急于推出1.0 版本，所以 1.0还不是一个稳定的版本，它的开发者宣称1.1 版本即将推出，希望1.1 版本会是个稳定的版本。在 XFire 捐献给 apache 后有人认为Axis2 将会灭亡。其实在很多人眼里，Axis2 并不是 pojo 形式，现在也好象XFire比 Axis 更有市场，也有很多人开始从Axis 转向 XFire。据说，XFire 确实比 Axis2 简单很多AXIS VS CXF 在 SOA 领域，我们认为Web Service 是 SOA 体系的构建单元（building block）。对于作过WebService 的开发人员来说，AXIS 和 CXF一定都不会陌生。这两个产品都是Apache 孵化器下面的Web Service 开源开发工具。Axis2 的最新版本是1.3，CXF现在已经到了2.0 版本。这两个框架都是从已有的开源项目发展起来的。Axis2 是从 Axis1.x 系列发展而来。CXF 则是 XFire 和 Celtix项目的结合产品。Axis2 是从底层全部重新实现，使用了新的扩展性更好模块架构。CXF也重新的深化了XFire 和 Celtix 这两个开发工具。新产品的退出导致了几个问题。是不是现有的使用Axis 1.x，XFire 和 Celix 的应用需要迁移的新的版本上。如果一个开发人员确定要迁移它的应用到新的框架上，那么他应该选择哪一个呢？相反的，如果一个开发者决定从头开发一个新的Web Service，他应该使用哪个呢？这两个框架哪一个更好一些呢？对于系统迁移来说，也许迁移到新的框架并不难。Axis 和 CXF都提供了迁移的指导。能够给开发者一些迁移的技巧和经验。但是对于这样迁移，这两个开源项目都没有提供迁移的工具。对于这样的迁移工作，尽管很值得去寻找所有的可行方案。Axis2 和 CXF都有各自不同的WebService 开发方法，每个方法都有相当数量拥护者。通过一个比较矩阵来比较Axis2 和 CXF 变得有现实的意义。这两个项目都开发不够成熟，但是最主要的区别在以下几个方面：1.CXF 支持 WS-Addressing，WS-Policy，WS-RM，WS-Security 和 WS-I Basic Profile。Axis2 不支持WS-Policy，但是承诺在下面的版本支持。2.CXF 可以很好支持Spring。Axis2 不能3.AXIS2 支持更广泛的数据并对，如XMLBeans，JiBX，JaxMe 和 JaxBRI 和它自定义的数据绑定ADB。注意 JaxME 和 JaxBRI 都还是试验性的。CXF 只支持 JAXB和 Aegis。在 CXF2.1 4.Axis2 支持多语言-除了 Java,他还支持 C/C+版本。比较这两个框架的Web Service 开发方法与比较它们的特性同样重要。从开发者的角度，两个框架的特性相当的不同。Axis2 的开发方式类似一个小型的应用服务器，Axis2 的开发包要以WAR 的形式部署到Servlet容器中，比如Tomcat，通过这些容器可以对工作中的Web Service 进行很好的监控和管理。Axis2 的 Web 名师资料总结-精品资料欢迎下载-名师精心整理-第 1 页，共 7 页 -administrion模块可以让我们动态的配置Axis2.一个新的服务可以上载，激活，使之失效，修改web 服务的参数。管理 UI 也可以管理一个或者多个处于运行状态的服务。这种界面化管理方式的一个弊端是所有在运行时修改的参数没有办法保存，因为在重启动之后，你所做的修改就会全部失效。Axis2 允许自己作为独立的应用来发布Web Service，并提供了大量的功能和一个很好的模型，这个模型可以通过它本身的架构（modular architecture）不断添加新的功能。有些开发人员认为这种方式对于他们的需求太过于繁琐。这些开发人员会更喜欢CXF。CXF更注重开发人员的工效（ergonomics）和嵌入能力（embeddability）。大多数配置都可以API 来完成，替代了比较繁琐的XML配置文件，Spring 的集成性经常的被提及，CXF支持 Spring2.0 和 CXFs API和 Spring的配置文件可以非常好的对应。CXF强调代码优先的设计方式（code-first design)，使用了简单的API 使得从现有的应用开发服务变得方便。不过你选择 Axis2 还是 CXF，你都可以从开源社区得到大量的帮助。这两个框架都有商业公司提供服务，WSO2 提供 AXIS2 的支持，Iona 提供 CXF的支持。这两公司都有很活跃的开发者社区。Axis2 出现的时间较早，CXF的追赶速度快。我的建议是：如果你需要多语言的支持，你应该选择AXIS2。如果你需要把你的实现侧重 JAVA 并希望和 Spring 集成，CXF就是更好的选择，特别是把你的Web Service 嵌入其他的程序中。如果你觉得这两个框架的新特性对于你并没有太大的用处，你会觉得Axis1 也是不错的选择，你应该继续使用它知道你有充分的理由去更换它。二、开始 XFire 的生火之旅：1、配置 XFire 运行环境：在 Tomcat 下新建一个Web Applications，命名为 stove，然后在其WEB-INF 目录下新建一个web.xml 文件，文件中输入：Xml 代码1.2.5.6.7.8.9.XFireServlet10.XFire Servlet11.org.codehaus.xfire.transport.http.XFireConfigurableServlet 12.13.14.15.XFireServlet16./servlet/XFireServlet/*17.18.19.20.XFireServlet21./services/*名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页，共 7 页 -22.23.24.其中主要就是引入了XFireServlet，用以处理Web Service 请求，并且负责提供Web Service 的 WSDL，如果你发布了一个名为BookService 的 WebService，则可以通过网址：http:/:端口/services/BookService 来访问这个 WebService，并且通过地址：http:/:端口/services/BookService?WSDL 来得到这个WebService 的 WSDL 信息。2、开发最简单的WebService 在 WEB-INF 目录下新建 src 文件夹，然后再建一个package:.pansky.webservice.xfire.study，在这个包下面新建一个接口：Java 代码1.package .pansky.webservice.xfire.study;2.3.publicinterface SayHiService 4.public String sayHi(String name);5.这个接口是告诉服务器你的WebService 哪些方法可以被用户调用的。下面我们再来写一个SayHiService的实现类，以完成业务逻辑：Java 代码1.package .pansky.webservice.xfire.study;2.3.publicclass SayHiServiceImpl implements SayHiService 4.public String sayHi(String name)5.if(name=null)6.return 连名字也不肯告诉我吗？;7.8.return name+,你吃了吗？没吃回家吃去吧。;9.10.11.public String 不告诉你()12.return 我的名字不告诉你！;13.14.这个类实现了sayHi 方法，该方法是可以通过WebService 调用访问到的。另外还实现了一个方法“不告诉你”，该方法因为没有在接口SayHiService 中定义，所以不能被WebService 调用到。这个例子足够简单吧，就跟我们刚学Java 时写的 Hello world没什么两样。到这里为止，我们做的跟平时的Java 开发没啥区别，该如何来发布WebService 呢？3、把 JAVA 类发布为 WebService：在 WEB-INF/classes 目录下新建文件夹：META-INF/xfire，然后在该文件夹下新建一个XML 文件：services.xml，文件内容如下：名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页，共 7 页 -Xml 代码1.2.3.SayHiService4.http:/.pansky/SayHiS.pansky.webservice.xfire.study.SayHiS.pansky.webservice.xfire.study.SayHiServiceImpl 7.8.这个文件定义一个WebService:SayHiService，并同时定义了接口和实现类。好了，该建的文件基本建完了，现在想办法把src 下的 java 文件编译成class，并复制到WEB-INF/classes目录下4、启动 Tomcat，测试 WebService 如果 Tomcat 还没配置好，抽两分钟再配一下。再把Tomcat 启动起来。再打开浏览器，输入：http:/localhost/stove/services，服务器返回的结果如下：Available Services:*SayHiService wsdl Generated by XFire(http:/xfire.codehaus.org)我们看到我们的WebService 已经布署成功了，我们再看看它的WSDL 信息：Xml 代码1.2.3.4.5.6.7.8.9.10.11.名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页，共 7 页 -12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.44.45.46.47.48.49.50.名师资料总结-精品资料欢迎下载-名师精心整理-第 5 页，共 7 页 -51.52.53.54.这个文件跟我们用Axis 生成的基本是一样的。5、享受美味的时刻WebService 这道大餐算是烹制好了，现在是享用美餐的时候了。我们写一个客户端吃掉这道大餐：Java 代码1.package .pansky.webservice.xfire.study;2.3.import .MalformedURLException;4.import java.util.Map;5.6.import org.codehaus.xfire.client.Client;7.import org.codehaus.xfire.client.XFireProxyFactory;8.import org.codehaus.xfire.service.Service;9.import org.codehaus.xfire.service.binding.ObjectServiceFactory;10.import org.codehaus.xfire.transport.http.CommonsHttpMessageSender;11.12.publicclass SayHiClient 13.publicstaticvoid main(String args)14.String serviceURL=http:/localhost/stove/services/SayHiService;15.Service serviceModel=new ObjectServiceFactory().create(SayHiService.class,null,http:/.pansky/SayHiService,null);16.17.XFireProxyFactory serviceFactory=new XFireProxyFactory();18.19.try 20.SayHiService service=(SayHiService)serviceFactory.create(serviceModel,serviceURL);21.Client client=Client.getInstance(service);22./client.addOutHandler(new OutHeaderHandler();23.24./disable timeout25.client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT,1);26.27.String hello=service.sayHi(张山疯 );28.System.out.println(服务器对 张山疯 的回答是：+hello);29.30.hello=service.sayHi(null);31.System.out.println(服务器胡言乱语说：+hello);32.名师资料总结-精品资料欢迎下载-名师精心整理-第 6 页，共 7 页 -33.catch (MalformedURLException e)34.e.printStackTrace();35.36.37.编译这个类，再执行一下，服务器服务的结果是：2008-5-22 17:39:17 mons.httpclient.HttpMethodBase writeRequest 信息:100(continue)read timeout.Resume sending the request 2008-5-22 17:39:17 mons.httpclient.HttpMethodBase readResponse 信息:Discarding unexpected response:HTTP/1.1 100 Continue 服务器对 张山疯 的回答是：张山疯,你吃了吗？没吃回家吃去吧。2008-5-22 17:39:20 mons.httpclient.HttpMethodBase writeRequest 信息:100(continue)read timeout.Resume sending the request 2008-5-22 17:39:20 mons.httpclient.HttpMethodBase readResponse 信息:Discarding unexpected response:HTTP/1.1 100 Continue 服务器胡言乱语说：连名字也不肯告诉我吗？好了，WebService 布署成功。下课！名师资料总结-精品资料欢迎下载-名师精心整理-第 7 页，共 7 页 -