日期:2014-05-16  浏览次数:20952 次

设计美好的服务器(7)--Apache CXF笔记

OverView

  • Apache CXF?
  • Web Services Using Apache CXF(JDJ)?
  • Dan Diephouse?XFire作者的Blog,现工作于MuleSource。
  • 余昌?、Willem Jiang??两位IONA北京员工的Blog。?

架构笔记

CXF的架构看多了有点熟悉而无聊,核心模块更是经典得没法更经典了。

???? 一、核心处理模块:

  • Bus -- CXF容器,基于Spring的Container与Configuration。
  • ServiceModel -- 服务元数据,其中ServiceInfo类似WSDL,而其他部分描述了DataBinding,Interceptors等CXF属性。
  • Message -- 在框架内流动的通用信息单元。
  • Interceptor?-- 在管道内处理信息的功能单元,由Interceptor Chain控制,分属不同的阶段(Phase)。

????? 二、扩展模块:

  • FrontEnd -- 用户编程API(如jax-ws,simple,javascript),被隔离于核心模块。
  • Trainsport -- 抽象、可扩展的传输层(如servlet,jetty,jms,local),Destinations与Conduits代表接收与发送者。
  • Binding -- 抽象、可扩展的协议解释层(如soap,http,xml,object),实现createMessage()初始信息,然后通过预设置的一系列专用Interceptor实现解释。
  • Data Binding -- 抽象、可扩展的XML与Java Object映射层(如jaxb,aegis),实现不同的Reader与Writer进行编解码。

??????三、运作流程?

  1. CXF可以独立运行(Jetty),也可以整合到Web服务器(servlet,jca)
  2. 使用FrontEnd(如JaxWsServiceFactoryBean)从WSDL或annotated java class反射创建ServiceModel
  3. Transport(http,jms,local)上接收请求
  4. 通过Binding(SOAP,REST,JMS和Corba)创建Message,并由一系列Binding预设定的Interceptor进行解释与WS-*协议处理
  5. 确定目标的Java服务,并把Data Binding(JAXB,Aegis)解码参数
  6. 最后调度Java方法,将返回结果重新编码并发送回去。

直接处理原始XML请求的Provider接口

JAX-WS的API有两个层次,除了常见DataBinding后调用最终Java方法外,还可以使用客户端的Dispatch与服务端Provider接口,绕过DataBinding处理,直接处理XML。

在Spring配置文件里,将implementor指向Provider,指定WSDL,然后编写下类实现invoke函数。

@WebServiceProvider(portName="stockQuoteReporterPort" serviceName="stockQuoteReporter")
@ServiceMode(value="Service.Mode.PAYLOAD")
public class  stockQuoteReporterProvider implements Provider<DOMSource>
public stockQuoteReporterProvider(){
  }

public DOMSource invoke(DOMSource request){
    DOMSource response = new DOMSource();
    ...
    return response;
  }
}

?又见范型,<DOMSource>指明了数据的类型,可选DOM/SAX/StreamSource。也可以是Service.Mode.MESSAGE下的完整SOAPMessage或JMS的DataSource。记得需要自行拼装返回的XML结果。

?? JAX-WS新增的这个功能是为复杂Web服务编写贴身订造的。被绕过的DataBinding,可以自行调用JAXB2.0的api完成。至于WSDL,可以写死,也可以用wsdl4j动态扩展。

其他笔记

  • CXF中的Message信息:
    ID--唯一属性。
    Content--内容。可通过? <T> T getContent(Class<T> format) 函数获取,内部实现为Map<Class<?>, Object> contents。
    Exchange属性特别的将In Message 、Out Message、Fault与Transport信息关联。
    InterceptorChain--要处理Message的Chain。
  • Invoker?,CXF默认是直接调用POJO或Spring里的Bean,可以通过Invoker调用EJB等对象。

?

1 楼