出处:http://my.oschina.net/u/246522/blog/151422
拦截器(Interceptor)简单说明
Interceptor是CXF架构中一个很有特色的模式。你可以在不对核心模块进行修改的情况下,动态添加很多功能。这对于CXF这个以处理消息为中心的服务框架来说是非常有用的,CXF通过在Interceptor中对消息进行特殊处理,实现了很多重要功能模块,例如:日志记录,Soap消息处理,消息的压缩处。简单的说,可以在收到请求后,还未进行业务处理前,进行处理。或者在请求包发送前,进行报文的处理。
几个的API的介绍
Interceptor
定义两个方法,一个处理消息 handleMessage, 一个是处理错误 handleFault。
InterceptorChain
单个的Interceptor功能有限,CXF要实现一个SOAP消息处理,需要将许许多多的Interceptor组合在一起使用。因此设计了 InterceptorChain,在我看了InterceptorChain就像是一个Interceptor的小队长。 小队长有调配安置Interceptor的权力(add,remove),也有控制消息处理的权力(doInterceptor,pause,resume,reset,abort),同时也有交付错误处理的权力( {get|set}FaultObserver)。更有意思的是为灵活控制Interceptor的处理消息顺序(doInterceptStartingAt,doInterceptorStartingAfter),这也是InterceptorChain比较难理解的地方。
Fault
定义了CXF中的错误消息。
InterceptorProvider
这里定义了Interceptor的后备保障部队。我们可以在InterceptorProvider中设置In,Out,InFault,OutFault 后备小分队,添加我们所希望添加的Interceptor。而InterceptorChain会根据这些后备小分队,组建自己的小分队实例,完成具体的作战功能任务。
AbstractAttributedInterceptorProvider
InterceptorProvider实现的抽象类,由于这个类来继承了HashMap,我们可以像这个类中存储一些属性信息。
AbrstractBasicInterceptorProvider
与AbstractAttributedInterceptorProvider不同,这个Interceptor只是简单实现了InterceptorProvider的功能,并不提供对其属性存储的扩展。
Message
由于Interceptor是针对Message来进行处理的,当你打开Message这个类文件时,你会发现在Message中定义了很多常量,同时你还可以从Message中获取到很多与Message操作相关的信息。可以获取设置的对象有InterceptorChain Exchange Destination,还有获取设置Content的泛型接口,是不是感觉Message和Bus差不多,都成了大杂货铺,一切与消息处理相关的信息都可以放在Message中。
服务端拦截器
01 | package hs.cxf.soapHeader; |
03 | import javax.xml.soap.SOAPException; |
04 | import javax.xml.soap.SOAPHeader; |
05 | import javax.xml.soap.SOAPMessage; |
06 | import org.apache.cxf.binding.soap.SoapMessage; |
07 | import org.apache.cxf.binding.soap.saaj.SAAJInInterceptor; |
08 | import org.apache.cxf.interceptor.Fault; |
09 | import org.apache.cxf.phase.AbstractPhaseInterceptor; |
10 | import org.apache.cxf.phase.Phase; |
11 | import org.w3c.dom.NodeList; |
25 | public class ReadSoapHeader extends AbstractPhaseInterceptor<SoapMessage> { |
27 | private SAAJInInterceptor saa = new SAAJInInterceptor(); |
29 | public ReadSoapHeader() { |
30 | super (Phase.PRE_PROTOCOL); |
31 | getAfter().add(SAAJInInterceptor. class .getName()); |
34 | public void handleMessage(SoapMessage message) throws Fault { |
36 | SOAPMessage mess = message.getContent(SOAPMessage. class ); |
38 | saa.handleMessage(message); |
39 | mess = message.getContent(SOAPMessage. class ); |
41 | SOAPHeader head = null ; |
43 | head = mess.getSOAPHeader(); |
44 | } catch (SOAPException e) { |
52 | NodeList nodes = head.getElementsByTagName( "tns:spId" ); |
53 | NodeList nodepass = head.getElementsByTagName( "tns:spPassword" ); |
55 | if (nodes.item( 0 ).getTextContent().equals( "wdw" )) { |
56 | if (nodepass.item( 0 ).getTextContent().equals( "wdwsb" )) { |
57 | System.out.println( "认证成功" ); |
60 | SOAPException soapExc = new SOAPException( "认证错误" ); |
61 | throw new Fault(soapExc); |
64 | } catch (Exception e) { |
65 | SOAPException soapExc = new SOAPException( "认证错误" ); |
66 | throw new Fault(soapExc); |
配置文件中新增拦截器配置
01 | < beans xmlns = "http://www.springframework.org/schema/beans" |
02 | xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" |
03 | xmlns:jaxws = "http://cxf.apache.org/jaxws" |
05 | http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd |
06 | http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd"> |
08 | < import resource = "classpath:META-INF/cxf/cxf.xml" /> |
09 | < import resource = "classpath:META-INF/cxf/cxf-extension-soap.xml" /> |
10 | < import resource = "classpath:META-INF/cxf/cxf-servlet.xml" /> |
12 | < bean id = "jaxWsServiceFactoryBean" |
13 | class = "org.apache.cxf.jaxws.support.JaxWsServiceFactoryBean" > |
14 | < property name = "wrapped" value = "true" /> |
15 | < property name = "dataBinding" ref = "aegisBean" /> |
19 | class = "org.apache.cxf.aegis.databinding.AegisDatabinding" /> |
21 | < jaxws:endpoint id = "CollectiveServices" |
22 | implementor = "hs.cxf.server.WebServiceSampleImpl" address = "/HelloWorld" > |
23 | < jaxws:inInterceptors > |
25 | < bean class = "org.apache.cxf.interceptor.LoggingOutInterceptor" /> |
27 | < bean class = "hs.cxf.soapHeader.ReadSoapHeader" /> |
28 | </ jaxws:inInterceptors > |
29 | < jaxws:serviceFactory > |
30 | < ref bean = "jaxWsServiceFactoryBean" /> |
31 | </ jaxws:serviceFactory > |
客户端拦截器:
01 | package hs.cxf.client.SoapHeader; |
05 | import javax.xml.namespace.QName; |
06 | import org.apache.cxf.binding.soap.SoapHeader; |
07 | import org.apache.cxf.binding.soap.SoapMessage; |
08 | import org.apache.cxf.binding.soap.interceptor.AbstractSoapInterceptor; |
09 | import org.apache.cxf.headers.Header; |
10 | import org.apache.cxf.helpers.DOMUtils; |
11 | import org.apache.cxf.interceptor.Fault; |
12 | import org.apache.cxf.phase.Phase; |
13 | import org.w3c.dom.Document; |
14 | import org.w3c.dom.Element; |
17 | * @Title:在发送消息前,封装Soap Header 信息 |
28 | public class AddSoapHeader extends AbstractSoapInterceptor { |
29 | private static String nameURI= "http://127.0.0.1:8080/cxfTest/ws/HelloWorld" ; |
31 | public AddSoapHeader(){ |
35 | public void handleMessage(SoapMessage message) throws Fault { |
36 | String spPassword= "wdwsb" ; |
39 | QName qname= new QName( "RequestSOAPHeader" ); |
40 | Document doc=DOMUtils.createDocument(); |
42 | Element spId=doc.createElement( "tns:spId" ); |
43 | spId.setTextContent(spName); |
45 | Element spPass=doc.createElement( "tns:spPassword" ); |
46 | spPass.setTextContent(spPassword); |
48 | Element root=doc.createElementNS(nameURI, "tns:RequestSOAPHeader" ); |
49 | root.appendChild(spId); |
50 | root.appendChild(spPass); |
52 | SoapHeader head= new SoapHeader(qname,root); |
53 | List<Header> headers=message.getHeaders(); |
55 | System.out.println( ">>>>>添加header<<<<<<<" ); |
客户端调用时:
001 | package hs.cxf.client; |
003 | import hs.cxf.client.SoapHeader.AddSoapHeader; |
004 | import java.util.ArrayList; |
005 | import javax.xml.bind.JAXBElement; |
006 | import javax.xml.namespace.QName; |
007 | import org.apache.cxf.endpoint.Client; |
008 | import org.apache.cxf.frontend.ClientProxy; |
009 | import org.apache.cxf.interceptor.Interceptor; |
010 | import org.apache.cxf.jaxws.JaxWsProxyFactoryBean; |
011 | import org.apache.cxf.transport.http.HTTPConduit; |
012 | import org.apache.cxf.transports.http.configuration.HTTPClientPolicy; |
025 | public class TestClient { |
030 | @SuppressWarnings ( "unchecked" ) |
031 | public void testSend1() { |
033 | JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean(); |
035 | ArrayList<Interceptor> list = new ArrayList<Interceptor>(); |
037 | list.add( new AddSoapHeader()); |
039 | list.add( new org.apache.cxf.interceptor.LoggingOutInterceptor()); |
040 | factory.setOutInterceptors(list); |
041 | factory.setServiceClass(WebServiceSample. class ); |
042 | factory.setAddress( "http://127.0.0.1:8080/cxfTest/ws/HelloWorld" ); |
044 | Object obj = factory.create(); |
045 | System.out.println(obj == null ? "NULL" : obj.getClass().getName()); |
047 | WebServiceSample ws = (WebServiceSample) obj; |
048 | String str = ws.say( "test" ); |
049 | System.out.println(str); |
051 | str = ws.say( "1111" ); |
052 | System.out.println(str); |
055 | JAXBElement<String> je = new JAXBElement<String>( new QName( |
056 | "http://bean.cxf.hs" , "name" ), String. class , "张三" ); |
058 | str = ws.sayUserName(u); |
059 | System.out.println(str); |
062 | ReqBean req = new ReqBean(); |
063 | req.setExp( new JAXBElement<String>( new QName( |
064 | "http://bean.cxf.hs" , "exp" ), String. class , |
066 | req.setSeqId( new JAXBElement<String>( new QName( |
067 | "http://bean.cxf.hs" , "seqId" ), String. class , |
069 | RespBean resp = ws.action(req); |
070 | System.out.println( "resp_id:" + resp.getRespId().getValue()); |
071 | System.out.println( "resp_exp:" + resp.getExp().getValue()); |
073 | } catch (Exception ex) { |
074 | ex.printStackTrace(); |
081 | @SuppressWarnings ( "unchecked" ) |
082 | public void testSend2() { |
083 | String webServiceUrl = "http://127.0.0.1:8080/cxfTest/ws/HelloWorld" ; |
084 | String webServiceConTimeout = "60000" ; |
085 | String webServiceRevTimeout = "60000" ; |
086 | JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean(); |
088 | ArrayList<Interceptor> list = new ArrayList<Interceptor>(); |
090 | list.add( new AddSoapHeader()); |
092 | list.add( new org.apache.cxf.interceptor.LoggingOutInterceptor()); |
093 | factory.setOutInterceptors(list); |
094 | factory.setServiceClass(WebServiceSample. class ); |
095 | factory.setAddress(webServiceUrl); |
096 | WebServiceSample service = (WebServiceSample) factory.create(); |
099 | Client clientP = ClientProxy.getClient(service); |
100 | HTTPConduit http = (HTTPConduit) clientP.getConduit(); |
101 | HTTPClientPolicy httpClientPolicy = new HTTPClientPolicy(); |
102 | httpClientPolicy.setConnectionTimeout(Integer |
103 | .valueOf(webServiceConTimeout)); |
104 | httpClientPolicy.setReceiveTimeout(Integer |
105 | .valueOf(webServiceRevTimeout)); |
106 | httpClientPolicy.setAllowChunking( false ); |
107 | http.setClient(httpClientPolicy); |
111 | ReqBean req = new ReqBean(); |
112 | req.setExp( new JAXBElement<String>( new QName( |
113 | "http://bean.cxf.hs" , "exp" ), String. class , |
115 | req.setSeqId( new JAXBElement<String>( new QName( |
116 | "http://bean.cxf.hs" , "seqId" ), String. class , |
118 | System.out.println( ">>>>>>发送消息<<<<<<<<<" ); |
119 | RespBean resp = service.action(req); |
120 | System.out.println( "resp_id:" + resp.getRespId().getValue()); |
121 | System.out.println( "resp_exp:" + resp.getExp().getValue()); |
128 | public static void main(String[] args) { |
129 | TestClient tc = new TestClient(); |
131 | System.out.println( ">>>>>>>>>>>>2<<<<<<<<<<<<<" ); |
133 | System.out.println( ">>>>>>>>>>>>END<<<<<<<<<<<<<" ); |