深入探索SOAP1.1--使用SAAJ1.2.1

http://www.diybl.com/　2008-1-25 　网络　点击: 　[ 评论 ]

深入探索SOAP1.1--使用SAAJ1.2.1 选择自 jwsh1984 的 Blog

本文的预定作者应该对SOAP1.1的基本规范有所了解，并熟悉了j2ee的基本开发，如果不熟悉的话，可以看一下我的Blog：使用SOAP开发java web服务--Axis开发方案，详细标准可以查看w3c的官方网站，连接如下：http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ 。本文主要是探讨SAAJ（SOAP with Attachment API for Java),JAXM(Java API for XML Messaging)，了解SOAP在j2ee开发中的作用与其接口。JAXM和SAAJ均支持针对B2B和Web服务应用程序、基于XML的消息交换，支持诸多行业标准，包括SOAP和ebXML。
      SAAJ是JWSDP的组成部分之一，JWSDP目前已经更新到了1.5版，SAAJ可以从SUN的网站单独下载：http://java.sun.com/xml/downloads/saaj.html，JAXM是用于XML消息交换的标准，不在JWSDP1.5的发行包内，可以另外下载：http://java.sun.com/xml/jaxm/downloads/index.html ，由于SAAJ是基于JavaMail^TM API (1.2) 、 JavaBeans^TM Activation Framework (JAF) (1.1.3)和JAXP(1.2.6) 的，所以也要把他们下载下来，SUN的官方网站都有提供的，好了，现在我们得到了以下包（按我下载的名称）：activation.jar（JAF），jaxm-api.jar（JAXM），mail.jar(JavaMail),saaj-api.jar(SAAJ),saaj-impl.jar(SAAJ)，我的JAXP已经包括在jdk1.5中了。另外还要有个支持Servlet的容器。
       好了，准备工作完毕了，下面开始我们的学习：
一、 SAAJ可用于将XML文档作为SOAP消息发送和接收，而无需JAXM提供商的基础程序结构，也无需处理基于SOAP的HTTP请求/响应。SAAJ最初是JAXM1.0API软件包的组成部分，而从JAXM1.1开始，该软件包更名为SAAJ1.1API。
     以下我们先了解一个简单的SOAP1.1消息：
POST /StockQuote HTTP/1.1
Host: www.stockquoteserver.com
Content-Type: text/xml; charset="utf-8"
Content-Length: nnnn
SOAPAction: "Some-URI"

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>              <------------这是信封标志
   <SOAP-ENV:Header>                                                                                           <------------这是消息头标志
       <t:Transaction
           xmlns:t="some-URI"
           SOAP-ENV:mustUnderstand="1">
               5
       </t:Transaction>
   </SOAP-ENV:Header>
   <SOAP-ENV:Body>                                                                                              <------------这是主体标志
       <m:GetLastTradePrice xmlns:m="Some-URI">
           <symbol>DEF</symbol>
       </m:GetLastTradePrice>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
      SAAJ API为我们提供了一个高层次SOAP消息封装接口，如:信封接口：javax.xml.soap.SOAPEnvelope，并提供了操作getHeader(),该方法返回一个消息头：javax.xml.soap.SOAPHeader。所以，通过调用SAAJ的接口函数，我们就可以对SOAP消息进行操作。
二、现在我们来讨论一下在不使用消息交换提供程序的JAXM时，应用程序客户端通过SOAP直接与其远程伙伴发送和接收消息操作（定义了点到点的交互作用和同步通信模型，其中发送方和接收方以请求和响应的形式交换消息。发送方发送消息并等待锁定目标位置的响应）。
       发送方步骤：
       1）创建SOAP连接；
       2）创建消息工厂；
       3）创建消息；
       4）填充消息；
       5）添加消息；
       6）添加SOAP附件；
       7）发送消息并接收响应；
       8）关闭提供程序连接；
       一下是我写的一个例子：

/**
*Sender.java
*Copyright 2005-2-10
*/
import javax.xml.soap.SOAPConnectionFactory;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPConnection;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPPart;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPHeader;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPBodyElement;