设计美好的服务器(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等对象。