SAAJ API 介绍

http://melin.javaeye.com/blog/200277

 

SAAJ是一个可是用户利用java来创建，读或修改SOAP消息的API，SAAJ包含了对SOAP的
Envelop元素，Body元素，Fault元素以及XML命名空间，元素，属性，文本注释和MIME
附件建模的类和接口。SAAJ是一个空的类，有点类似JDBC。又供应商实现。我一般在CXF的
Interceptor中使用的比较多
SAAJ是一个抽象工厂模式，而抽象工厂模式的根就是MessageFactory。它负责创建本身的实例，
而该实例能用于创建SOAPMessage。SOAPMessage包含SOAPPart。SOAPPart表示文档以及零个或多个
AttachmentPart。
SOAPPart包含一个要对SOAP文档建立模型的对象族，其中包含Envelop元素，Body元素和Header元素

创建一个简单的SOAP消息实例：

Java代码

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <SOAP:Envelope  
3.     xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"  
4.     xmlns:ns="http://www.javaeye.com/saaj/simple">  
5.     <soap:body>  
6.         <ns:getMessage>  
7.             <msg>Hello World</msg>  
8.         </ns:getMessage>  
9.     </soap:body>  
10. </SOAP:Envelope>  

<?xml version="1.0" encoding="UTF-8"?>
<SOAP:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns="http://www.javaeye.com/saaj/simple">
	<soap:body>
		<ns:getMessage>
			<msg>Hello World</msg>
		</ns:getMessage>
	</soap:body>
</SOAP:Envelope>

对应的java代码：

Java代码

1. MessageFactory msgFactory = MessageFactory.newInstance();  
2. //用MessageFactory对象创建SOAPMessage对象  
3. SOAPMessage message = msgFactory.createMessage();  
4. //如果没有附件是。可以直接通过getSOAPHeader或getSOAPBody来获取Header或Body  
5. //不需要通过这样的方式来获取message.getSOAPPart().getEnvelope().getHeader()  
6. message.getSOAPHeader().detachNode();  
7. SOAPBody body = message.getSOAPBody();  
8. SOAPElement getMessage = body.addChildElement("getMessage", "ns", "http://www.javaeye.com/saaj/simple");  
9. getMessage.setEncodingStyle(SOAPConstants.URI_NS_SOAP_ENCODING);  
10. SOAPElement msg = getMessage.addChildElement("msg");  
11. msg.addTextNode("Hello World");  
12. message.writeTo(System.out);  

MessageFactory msgFactory = MessageFactory.newInstance();
//用MessageFactory对象创建SOAPMessage对象
SOAPMessage message = msgFactory.createMessage();
//如果没有附件是。可以直接通过getSOAPHeader或getSOAPBody来获取Header或Body
//不需要通过这样的方式来获取message.getSOAPPart().getEnvelope().getHeader()
message.getSOAPHeader().detachNode();
SOAPBody body = message.getSOAPBody();
SOAPElement getMessage = body.addChildElement("getMessage", "ns", "http://www.javaeye.com/saaj/simple");
getMessage.setEncodingStyle(SOAPConstants.URI_NS_SOAP_ENCODING);
SOAPElement msg = getMessage.addChildElement("msg");
msg.addTextNode("Hello World");
message.writeTo(System.out);

资料：
【1】SAAJ－－理论上很美，实践中受阻?
【2】The Sorry State of SAAJ

 

CXF Interceptor获取SOAP Header中数据的方法

http://melin.javaeye.com/blog/223643