架构笔记
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等对象。
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等对象。