基于Servlet发送、接收SOAP消息
名词：SAAJ : SOAP with Attachments API for Java
1. WebServices在服务端和客户端使用SOAP消息格式来传递数据，SOAP消息的格式如下：
|
<?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Header> ... </soap:Header> <soap:Body> ... <soap:Fault> ... </soap:Fault> </soap:Body> </soap:Envelope> [附件信息] |
2. 下面我们就要使用Servlet来模拟SOAP消息的客户端和服务端。
要求： 客户端将姓名(username)，发送给服务端，然后服务端返回(Hello,[username]).
代码说明： SendingServlet.java： SOAP消息的客户端
ReceivingServlet.java： SOAP消息的服务端，继承自
com.sun.xml.messaging.soap.server.SAAJServlet（也是一个Servlet）
SAAJServlet是个抽象的HttpServlet,有一个抽象方法,接收请求的SOAPMessage,并返回响应的SoapMessage
|
public abstract SOAPMessage onMessage(SOAPMessage reqMsg); |
需要jar包： saaj-api.jar、saaj-impl.jar、saaj-coms.jar (SAAJ : SOAP with Attachments API for Java)
Web服务器： Tomcat
3. 开发过程
1> 编写SOAP客户端的Servlet，并在web.xml文件中进行相应配置，开发流程大致如下
|
// 1.创建消息工厂 // 2.创建soap消息reqMsg
// 3.创建soap消息的部分reqMsgpart // 3.1.创建sope信封envelope，要开始写信了，哈哈 // 3.2.写header // 3.3.写body // 3.4.向body中添加元素，即要传递的数据
// 4.创建reqMsg的附件attachmentpart，
// 5.创建SOAP消息的目标对象（服务端点endPoint），即消息发给谁（发给服务端Servlet的URL）， ////// 这里也可以将SOAP消息发送给一个已经存在的WebService，如： ////// URL endPoint = new URL("http://localhost:8080/axis/services/HelloWorld");
// 6.发送SOAP消息，并接收返回信息 |
2> 编写SOAP服务端的Servlet，并在web.xml文件中进行相应配置，开发流程大致如下。
|
// 1.接收客户端发送的SOAP请求消息，并提取出信息中的有效数据 // 2.根据请求的数据，返回SOAP消息响应 |
3> 编写一个jsp页面，调用客户端Servlet请求SOAP消息到服务端
4> SOAP消息请求、响应成功，观察输出的SOAP消息内容。
|
[SOAP请求消息(SendingServlet.java发送的)] <SOAP-ENV:Envelope xmlns:SOAP-ENV = "http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <koma:sayHello xmlns:koma = "http://koma.java.cn"> <koma:username>test</koma:username> </koma:sayHello> </SOAP-ENV:Body> </SOAP-ENV:Envelope> [附件信息(index.jsp文件的内容)] |
|
[SOAP响应消息(ReceivingServlet.java返回的)] <SOAP-ENV:Envelope xmlns:SOAP-ENV = "http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <ResponseMsg>Hello test!</ResponseMsg> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
4. 代码见附件 saaj_sample.rar
