Apache CXF学习笔记

yxixi

架构笔记
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进行编解码。
      三、运作流程

CXF可以独立运行(Jetty)，也可以整合到Web服务器(servlet,jca)
使用FrontEnd(如JaxWsServiceFactoryBean)从WSDL或annotated java class反射创建ServiceModel
在Transport(http，jms,local)上接收请求
通过Binding(SOAP，REST，JMS和Corba)创建Message，并由一系列Binding预设定的Interceptor进行解释与WS-*协议处理
确定目标的Java服务，并把Data Binding(JAXB,Aegis)解码参数
最后调度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等对象。