《[精选]MiXFire服务部署手册》由会员分享,可在线阅读,更多相关《[精选]MiXFire服务部署手册(8页珍藏版)》请在金锄头文库上搜索。
1、XFire服务部署手册2008-05-15 11:36 阅读22评论0 字号:大中 小小 一、准备工作:工程目录结构 工程的目录结构如下图所示:ldaxfire是工程的根目录。/WEB-INF/classes/META-INF/xfire目录用于存放service.xml文件。将下的包(用到的)copy到/WEB-INF/lib目录下。 XFireServlet XFire Servlet org.codehaus.xfire.transport.http.XFireConfigurableServlet XFireServlet /services/* 这样在工程中发布的所有服务都可以在工程
2、URL的services子目录下访问。三、类结构调整 XFire对于要发布的服务没有多余的要求,它可以自动的将指定服务类的公共方法发布出去。但是POJOs的调用要求传入的参数类型必须是接口;同时由于XFire生成的桩使用了不支持的JSR181注释类型,所以在这里最好是遵从POJOs的要求,为每一个要发布的服务类生成一个接口,以便于低版本的客户端使用POJOs方式进行访问。四、类型影射 XFire支持的数据类型包括基础类型、数组、集合、字符串、Date(java.util.Date、java.util.Calendar、java.sql.Timestamp、java.sql.Date、java.
3、sql.Time)、XML类型(Document、Element、XMLStreamReader、Source)及以上类型组成的复合类型。基础类型、数组、String、Date类型不用进行类型影射,除此之外的数据类型如List、Map等集合对象或是其它的复合类型,必须要写对应的类型影射。XFire的类型影射在ServiceClassName.aegis.xml(ServiceClassName为服务类/接口的名字)文件中声明。在这里尽量要求发布服务的参数和返回值不要超出基础类型、数组、String的泛围,因此类型影射在此不作详细说明。在XFire工程中service.xml必须位于/WEB-I
4、NF/classes/META-INF/xfire/目录下。其基本格式如下 document|rpc|message|wrapped literal|encoded request|session|application true|false 1、name:必须的。ServiceRegisty就是通过这个名字进行服务注册的,服务部署完成后也是用它来调用服务。3、serviceClass:必须的。要部署到服务中的类,可以是接口。4、implementationClass:可选的。服务被调用时使用的实现类。如果serviceClass的值是一个接口,那么这个值就必须配置,且必须为serviceCl
5、ass指定接口的实现类。5、serviceFactory:可选的。ServiceFactory控制服务创建和配置。6、bindingProvider:设置bindingProvider,提供绑定相关的信息。如端口等。7、style:可选的。参数样式。默认值为wrapped。可取值为wrapped、message、document 及rpc。8、use:可选的。指定编码类型。取值可以是encoding或litaral,目前的XFire支持literal格式,即无编码。9、scope:可选的。指定服务的生存周期。默认值为application,即在所以访问期间只创建一个服务,不用时可以会被持久化。
6、可以是application、session或request。invoker:可选的。设置调用转接器。如果当服务实现类不是一个无格式java bean时invoker可以指定其调用方式。excutor:可选值。可以为服务指定一个默认值以外的执行策略。handlers:可以使用inHandlers、outHandlers或faulterHandlers为服务指定输入、输出和出错时的调用的处理。每个handler自身是一个XML解析的处理句柄。createDefaultBinding:可选。默认为true,即创建默认的SOAP1.1 HTTP绑定。如果不想创建默认的绑定,可将其值设为false。绑
7、定配置:每一个绑定都要指定的一个transport ID。下面是对应的Transport与ID的对应表。使用endpoint选项可以覆盖掉默认的端口地址。JMS urn:xfire:transport:jms Local urn:xfire:transport:local ServiceName com.yourcompany.yourpath.ServiceInterface com.yourcompany.yourpath.ServiceImplClass 用自己实际的路径和类名取代上面的配置就是一个典型的XFire service配置。六、客户端调用 客户端调用采用POJOs方式。在这种
8、方式下要用到在服务端定义的服务接口。具体代码如下: Service serviceModel = new ObjectServiceFactory().create( XFireProxyFactory serviceFactory = new XFireProxyFactory(); ServiceInterface service = (ServiceInterface) serviceFactory.create( serviceModel, serviceURL); Client client = Client.getInstance(service); client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT, 0); data = service.serviceMethod();注:其中的ServiceInterface在实际工程中要以实际的接口类型替代,serviceMethod以具体的方法名替代。在XFire1.2以后支持SOAP消息的GZip压缩传输,在合适的地方启动GZip压缩可以减少网络传输的数据量,加快速度。在XFire中启动GZip压缩要用到一个开源的Filter:PJL Compressing Filter。这个Fil