帶附件的soap消息api,其內(nèi)容很豐富,它是一個(gè)允許用soap消息而不是用jax-rpc來(lái)調(diào)用web service的API .它通過(guò)直接創(chuàng)建XML消息來(lái)完成web serivce的調(diào)用.SOAP API 簡(jiǎn)化了創(chuàng)建XML的工作. 取自j2ee文檔的soap消息的結(jié)構(gòu)圖.
 
完整的SAAJ客戶(hù)端程序. 服務(wù)器端的程序在j2ee web service開(kāi)發(fā)(一) 里可以找到.沒(méi)有詳細(xì)介紹saaj的一些類(lèi)
的使用.好在它們都有很好的自解釋性.

package array;  
 
import javax.xml.soap.*;  
import java.net.*;  
import java.io.*;  
import java.util.*;  
import java.text.SimpleDateFormat;  
public class SaajClient {  
    public SaajClient() {  
    }  
 
    public static void main(String[] args) throws Exception {  
        SaajClient client = new SaajClient();  
        User[] user = new User[2];  
        user[0] = new User("張三", "027-88888888", new Date());  
        user[1] = new User("lisi", null, new Date());  
        saajTest(user);  
 
    }  
 
    private static void saajTest(User[] user) throws MalformedURLException,  
            IOException,  
            UnsupportedOperationException, SOAPException {  
        MessageFactory factory = MessageFactory.newInstance();//SAAJ的根工廠類(lèi)  
        SOAPMessage message = factory.createMessage();  
        //SOAPMessage 對(duì)象需要一些元素，包括SOAPPart,SOAPEnvelope,SOAPHeader,SOAPBody對(duì)象  
        //SAAJ通過(guò)返回一個(gè)新的已經(jīng)包括這些元素的SOAPMessage對(duì)象來(lái)簡(jiǎn)化操作  
        SOAPFactory s = SOAPFactory.newInstance();//通用工廠類(lèi)，創(chuàng)建Name，SOAPElement對(duì)象  
 
        Name countUser = s.createName("countUser", "mh", "http://array");  
        //Name對(duì)象表示一個(gè)XML限定名稱(chēng)  
        Name arrayOfUser_1 = s.createName("arrayOfUser_1");  
        Name xsi = s.createName("xmlns:xsi");  
        Name nullAttribute = s.createName("xsi:nil");  
 
        //下面的代碼創(chuàng)建soap對(duì)象  
        SOAPBody body = message.getSOAPBody();  
        SOAPBodyElement bodyChildElement = body.addBodyElement(countUser);  
        SOAPElement arrayOfUser = bodyChildElement.addChildElement(  
                arrayOfUser_1);  
      //  arrayOfUser.addAttribute(xsi, "http://www.w3.org/2001/XMLSchema-instance");  
        arrayOfUser.addNamespaceDeclaration("xsi","http://www.w3.org/2001/XMLSchema-instance");  
        //定義arrayOfUser的 xmlns:xsi屬性  該名稱(chēng)空間是XML模式實(shí)例命名空間，由XML模式規(guī)范定義，它定義了  
        //可以在XML文檔中使用的屬于該命名空間的一些特性.  
        for (int i = 0; i < user.length; i++) {  
            //需要注意順序，也就是和復(fù)雜類(lèi)型的sequence元素的順序?qū)?yīng)  
            Name valueName = s.createName("value");  
            SOAPElement value = arrayOfUser.addChildElement(valueName);  
            Name birthday = s.createName("birthDay");  
            SOAPElement birthdayElement = value.addChildElement(birthday);  
 
            if (user[i].getBirthDay() == null) {  
                birthdayElement.addAttribute(nullAttribute, "1");  
            } else {  
                //日期類(lèi)型必須進(jìn)行格式化  
                SimpleDateFormat format= new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");  
                birthdayElement.addTextNode(format.format(user[i].getBirthDay()));  
            }  
            Name name = s.createName("name");  
            SOAPElement nameElement = value.addChildElement(name);  
            if (user[i].getName() == null) {  
                //傳送空值  
                nameElement.addAttribute(nullAttribute, "1");  
            } else {  
                nameElement.addTextNode(user[i].getName());  
            }  
            Name phone = s.createName("phone");  
            SOAPElement phoneElement = value.addChildElement(phone);  
            if (user[i].getPhone() == null) {  
                phoneElement.addAttribute(nullAttribute, "1");  
            } else {  
                phoneElement.addTextNode(user[i].getPhone());  
            }  
 
        }  
 
        //發(fā)送soap消息  
        SOAPConnectionFactory f = SOAPConnectionFactory.newInstance();  
        SOAPConnection conn = f.createConnection();  
        URL url = new URL("http://localhost:8082/complexType-array/services/CountUser");  
        SOAPMessage response = conn.call(message, url);  
 
        SOAPBody soapBody = response.getSOAPBody();  
        Iterator it = soapBody.getChildElements();  
        while (it.hasNext()) {  
            SOAPBodyElement bodyElement = (SOAPBodyElement) it.next();  
            String returnValue = bodyElement.getValue();  
            System.out.println(bodyElement.getElementName().getLocalName() +  
                               "      " + returnValue);  
        }  
 
 
        response.writeTo(System.out);  
    }  
}  

程序向服務(wù)器端傳送的數(shù)據(jù):

POST /complexType-array/services/CountUser HTTP/1.1  
SOAPAction: ""  
Content-Type: text/xml; charset=UTF-8  
User-Agent: Java/1.5.0_03  
Host: localhost:8082  
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2  
Connection: keep-alive  
Content-Length: 448  
 
< env:Envelope xmlns:env='http://schemas.xmlsoap.org/soap/envelope/'> 
   < env:Header/> 
   < env:Body> 
      < mh:countUser xmlns:mh='http://array'> 
         < arrayOfUser_1 xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'> 
            < value> 
               < birthDay>2006-11-08T22:36:13< /birthDay> 
               < name>張三< /name> 
               < phone>027-88888888< /phone> 
            < /value> 
            < value> 
               < birthDay>2006-11-08T22:36:13  
               < name>lisi  
               < phone xsi:nil='1'/> 
            < /value> 
         < /arrayOfUser_1> 
      < /mh:countUser> 
   < /env:Body> 

從傳送的數(shù)據(jù)來(lái)看,就是一個(gè)符合soap規(guī)范的xml文檔.既然是xml文檔,也就是說(shuō)可以用jdom api 來(lái)操作它
事實(shí)上就是這樣，在J2EE web service開(kāi)發(fā)中，soap api 可以跟 jdom api混合使用。

【編輯推薦】

1. 實(shí)現(xiàn)數(shù)據(jù)庫(kù)表字j2ee應(yīng)用
2. j2ee web service開(kāi)發(fā)(二)動(dòng)態(tài)代理與動(dòng)態(tài)調(diào)用
3. j2ee web service開(kāi)發(fā)(一) 映射數(shù)組復(fù)雜類(lèi)型
4. J2ee學(xué)習(xí)經(jīng)驗(yàn)和流程
5. 快速開(kāi)發(fā)EJB和J2EE Web Applic