J2EE web service开发(三)SAAJ带附件的soap消息-51CTO.COM

带附件的soap消息api,其内容很丰富,它是一个允许用soap消息而不是用jax-rpc来调用web service的API .它通过直接创建XML消息来完成web serivce的调用.SOAP API 简化了创建XML的工作. 取自j2ee文档的soap消息的结构图.

完整的SAAJ客户端程序. 服务器端的程序在j2ee web service开发(一) 里可以找到.没有详细介绍saaj的一些类
的使用.好在它们都有很好的自解释性.

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的根工厂类  
        SOAPMessage message = factory.createMessage();  
        //SOAPMessage 对象需要一些元素，包括SOAPPart,SOAPEnvelope,SOAPHeader,SOAPBody对象  
        //SAAJ通过返回一个新的已经包括这些元素的SOAPMessage对象来简化操作  
        SOAPFactory s = SOAPFactory.newInstance();//通用工厂类，创建Name，SOAPElement对象  
 
        Name countUser = s.createName("countUser", "mh", "http://array");  
        //Name对象表示一个XML限定名称  
        Name arrayOfUser_1 = s.createName("arrayOfUser_1");  
        Name xsi = s.createName("xmlns:xsi");  
        Name nullAttribute = s.createName("xsi:nil");  
 
        //下面的代码创建soap对象  
        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属性  该名称空间是XML模式实例命名空间，由XML模式规范定义，它定义了  
        //可以在XML文档中使用的属于该命名空间的一些特性.  
        for (int i = 0; i < user.length; i++) {  
            //需要注意顺序，也就是和复杂类型的sequence元素的顺序对应  
            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 {  
                //日期类型必须进行格式化  
                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());  
            }  
 
        }  
 
        //发送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);  
    }  
}

程序向服务器端传送的数据:

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>

从传送的数据来看,就是一个符合soap规范的xml文档.既然是xml文档,也就是说可以用jdom api 来操作它
事实上就是这样，在J2EE web service开发中，soap api 可以跟 jdom api混合使用。

【编辑推荐】