CXF WEB service 框架学习笔记

/docs/index.html/注意，在非java-project中，例如在web-project中可能出现(activation.jar 和 mail.jar)与工程中的 j2ee.jar 以及 myeclipse 中 D:MyEclipse 5.5.1 GAmyeclipseeclipsepluginscom.genuitec.eclipse.j2eedt.core_5.5.1datalibrarysetEE_5 的javaee.jar里面的同名包发生冲突，建议把j2ee.jar和javaee.jar中的同名包删除，或者直接使用J2ee.jar把eclipse自带的javaee.jar从工程中去除并加入相应的包1. WSDL2JAVA 生成客户端代码 2. JAXB 3. JAX-WS 4. WS-Addressing 5. WS-Policy 6. WS -Security 7. webservice 注释 8. 拦截器 WSDL2JAVA生成客户端代码CXF支持代码生成1）Java to WSDL 、2）WSDL to Java 、3）XSD to WSDL 、4）WSDL to XML 5）WSDL to SOAP 、6）WSDL to service 如下：D:apache-cxf-2.2.5binwsdl2java -d d:/cxf-client -p example1.client :8080/ws/HelloWorld?wsdlJAXB/group/10141/topic/12028CXF默认的数据绑定使用的JAXB，XFIRE使用Aegis替代数据绑定就是把java对象转化为xml和把xml文件转化为java对象不管使用任何的XML解析代码库（dom4j等），对于xml只是一个解析工作而已，不能马上绑定到java 对象。对于对象，每 set 或者get相应的 ， 可以使用map xml 。 于是，一 的 用于对象和xml 的 就 非 ， sun jaxb，一 的 java对象和xml中的xjc po.xsd能把xsd中定的java转currency1为java，“xmlbeans的scompJAX-WS//webservices/docs/2.0/tutorial/doc/index.htmlJAX-WSfifl是一 XML web services的JAVA API ( ：JAX-RPC 2.0 renamed to JAX-WS 2.0)在 JAXWS中，一个程用可以转currency1为一个 于XML的议例如SOAP。在使用JAXWS程中，发者不 ”任何生成和 SOAP的代码。JAXWS的 现“AP的用转currency1成为对于SOAP。在器端，用户只 Java 定程用 现的接S service eoit iter ace ，并 相 的 现，用JAXWS的发 接就可以发 为We Service接。在客户端，用户可以JAXWS的AP 建一个代 （用 对象 替代程的） 现对于程器端的用。 e service 的 作 ， 可以用JAXWS 现JA A 与 程 et等 的 作。JAXWS与JAX P 的 S 的 e services的 现是JAX P 1 1 JS 1 1 。“个 现是 于Java的P 并不 支持sce afifl，同 对 ii和Parsi定 的 现。JAXWS2 JS 224 是S 的 e services议，是一个 于 的 现。在ii 2 ava对象 ，使用的是te Java Arcitectre or XML ii JAX JS 222 ，在arsi，使用的是te Strea i AP or XML StAX JS 1 3 ，同 支持sce afifl。1客户端发者URL 到WSDL文件(HTTP 问可以 到http:/?wsdl)2客户端根据WSDL的描述，生成相 client接代 法,HTTP POST发送SOAP给器端。3器端Listener接受到SOAP请求,对JAVA 说, 是一个servlet或者EJB。Listener把转发给 Dispatcher,候listener和Dispatcher 可能是同一个。Dispatcher把请求交给WebService的 终端。4,“候,器端 HTTP request 转成器端的型,形成javax.xml.ws.handler.MessageContext, 并 SOAP 的 头 信 , 如mustUnderstand。5,如果在器端 handler,用handler的handleMessage 法, 用handler 承储,解密或者 证到达的顺序。handler在HandlerChain 注 ,handlers.xml文件为：WSSOAPHandlercom.cxf.test.WSSOAPHandlerWSHandlercom.cxf.test.WSHandler6,SOAP被反序列化为JAVA对象,传到真正的 现业的。7,用真正的业 法,执 后利用JAXB注解序列化成SOAP返回。8,如果 handler,用handler的handleMessage 法。如果业 法异 抛出,把异 转为SOAP fault 。9,ListenerHTTP把response返回给客户端。JAX-WS的客户端用分为proxy 以及dispatch URL wsdlURL = new URL(file:/D:/ wsdl/prjCXFWeb.wsdl)；QName serviceQName = new QName(/, WSCXFProviderService)；QName portQName = new QName(/, WSCXFProviderPort)；Service service = Service.create(wsdlURL, serviceQName)；WSCXFProvider port = (WSCXFProvider) service.getPort(portQName, WSCXFProvider.class)；trySystem.out.println(port.testWS(message)；catch(SOAPFaultException e)System.out.println(e.getFault().getFaultCode()；System.out.println(e.getFault().getFaultString()；1，用工具WSDL文件产生一个SEI(service endpoint interface),一个java的interface，能够对应该web service 的功能。“个interface的名对应到WSDL的portType名称， 法和operation对应， 法的参数和message以及types对应。CXF和Axis “样的工具：wsdl2java。【上面的WSCXFProvider就是SEI】2，初 化Service，指定wsdL URL和service的QName，service的QName的前一部分是命名空 ，后一部分是名称，与WSDL文件中的部分对应。 后getPort 到一个 现 SEI的例，“个 例被叫做Proxy。 的QName与 wsdl文件中的wsdl:port name=WSCXFProviderPort部分对应。3，SEI用web service，传给SEI的参数是加上JAXB annotation的java（简单型和String不用 记）。4，传入的参数被序列化为SOAP的payload（body部分的xml），“是因为service.getPort是proxy机制 建的，用“个proxy的 法，和 联的InvocationHandler的invoke 法 执 ，invoke 法JAXB把java参数序列化为XML。 后把soap request发到器端。5，返回response是后与4似，InvocationHandler负责把XML利用JAXB反序列化为java对象。上面是ProxyWS-Addressing具体而 ，WS-Addressing为同步和/或异步传输的SOAP 一套统一的寻址 ,而且， 一寻址特 帮助Web的发人员围绕多样 的交currency1模 不仅仅只是请求/响应的简单交currency1模 建 的应用WS-Policy/developerworks/cn/webservices/ws-policy.html(WS-Policy) fifl为请求者和 者定 法和 描述 的 求、首选项和 能如：安 、隐私 、应用程序优先权 、用户帐户优先权 、传输控制WS-Security/developerworks/cn/webservices/ws-secure/建安 的 Web 以 现 整 和机密 使用， 被设计成用 建多 安 模型（包括 PKI、Kerberos 和 SSL）的 础。WS-Security 特别为多安 令牌、多信任域、多签名格 和多加密技术 支持。fifl 三 主 的机制：安 令牌传播、 整 和机密 。“机制 身并不 整的安 解决 案。相反，WS-Security 是一 件， 可以与 Web 扩展和更高级的特定于应用程序的议联合使用，以适应多 安 模型和加密技术。“机制可以独 使用（例如传送安 令牌），或以 密 成的 使用（例如，对签名和加密，并 与用于签名和加密的密 相 的安 令牌 ）。javax.jws包webservice注释WebServicepublic interface WebServiceSample String say(String hello)；WebResult(name = user)String sayUserName(WebParam(name = user) UserDTO user)；WebResult(name = req)RespBean action(WebParam(name = req)ReqBean req)；1）Webservice，接中的 法输出为Web Service，说 承 A WEB SERVICE,或者说 该接为Web Service 接endpointInterface ，一 作用于接的 现上，且 就是该 现的接的 。name 用 指定 WebService的name，对应于的name2）WebResult自定返回 mapping到wsdl和xml-wsdl:part3）WebParam自定返回 mapping到message part和xml-wsdl:messagewebParam注解ws的 为的参数信header=true 信是 加到soap的header中4）WebMethodOnewayonly an input message and no output拦截器参 ：jax-ws中的javax.xml.ws.handler.Handler是个拦截器，能够在 的webserver前后 Handler分为LogicalMessage： 法getPayload（），以 XML 的形 负 ，可以在相同的 LogicalMessage 例上多 用， 是返回可以用 整个负 的的 Source1. Interceptor一个 handleMessage， 一个是 handleFault， 注意的是，在 具体的Interceptor的“ 个 法中， 别用Interceptor部的成员 。“是 于Interceptor是面 的，每个Interceptor 可能 在不同的程中，如果用 Interceptor中的部成员 ，就在Interceptor中成 的 问的，而“的Interceptor 就不是程安 的Interceptor 。2. InterceptorChain单个的Interceptor功能currency1，CXF 现一个SOAP ， 多多的Interceptor 合在一“使用。因设计 InterceptorChain，在 InterceptorChain就是一个Interceptor的fifl 安 Interceptor的权 （add，remove），控制 的权 （doInterceptor，pause，resume，reset，abort），交 的权 （ get|setFaultObserver）。更 意 的 是 为 控 制 Interceptor 的 顺 序（doInte