用SAAJ1.2發送接收二進制Web服務內容(二)

2019-11-18 12:52:26

字體：大中小

來源：轉載

供稿：網友

　　帶有附件的SOAP分析
　　帶有附件的SOAP信息并沒有給SOAP增加新的特征。確切的說，它定義了如何利用在SOAP信息中MIME類型來定義附件, 并且還定義了如何引用在SOAP體（SOAP Body）中的那些附件。
　　MIME類型的復合塊/關聯（multipart/related）特性能定義由多部分組成的一個文檔。帶有附件的SOAP信息一定要符合這樣的復合塊/關聯（multipart/related）的MIME類型。下面的例子展示了一個復合塊/關聯的 SOAP 信息，它被綁定到到 HTTP 協議，帶有兩個附件:
　　
　　POST /PRopertyListing HTTP/1.1
　　Host: www.realproperties.com
　　Content-Type: Multipart/Related; boundary=MIME_boundary; type=text/xml; start=""
　　Content-Length: NNNN
　　
　　--MIME_boundary
　　Content-Type: text/xml; charset=UTF-8
　　Content-Transfer-Encoding: 8bit
　　Content-ID:
　　
　　
　　

　　
　　　　　　　　　xmlns:realProperty="http://schemas.realhouses.com/listingSubmission";>
　　
　　　　　 Really Nice Homes, Inc.
　　　　　Add
　　　　　
　　　　　　1234 Main St
　　　　　　Pleasantville
　　　　　　CA　　　　
　　　　　　94323
　　　　　
　　　　　
　　　　　　 250000
　　　　　
　　
　　　　　
　　　　　
　　
　　　　
　　
　　
　　
　　
　　--MIME_boundary
　　Content-Type: image/jpeg
　　Content-ID:
　　
　　....JPEG DATA .....
　　--MIME_boundary
　　Content-Type: image/jpeg
　　Content-ID:
　　
　　....JPEG DATA .....
　　--MIME_boundary--
　　
　　上述的復合塊信息包含一系列的MIME頭和相關的數據。文件的底層是SOAP體（SOAP Body）。因為SOAP體只包含XML數據,整個信息的MIME類型是本文/xml（text/xml）類型。在SOAP封套(SOAP envelope)后面是二個附件,每個附件都包含一個連同信息一起發送的圖像文件。
　　用內容ID（Content ID)來識別每一個附件。W3C 備忘錄答應用內容ID或內容位置來引用附件,但是它優先選擇前者。這樣的一個內容ID作為統一資源標志符URI(Uniform Resource Identifier)引用給附件；SOAP 1.1的編碼規則定義了如何通過URI來引用SOAP信息里面的任何資源,不僅僅是引用XML( 參考SOAP1.1第5節資源)。當SOAP處理機處理信息時，它會解析這些URI引用。在上述的例子中,SOAP處理器把元素frontImage關聯到內容ID為property1234_front.jpeg@realhouses.com的數據段中。
　　
　　創建并發送帶有附件的SOAP信息
　　SAAJ能讓你創建并編輯SOAP信息的任何部份, 包括附件。大多數的SAAJ以抽象類和接口為基礎，所以每個供給商都能實現它自己的SAAJ產品。Sun Microsystems公司的參考實現附在JWSDP包（java Web Services Developer Pack）中。
　　因為SOAP信息只是XML文檔的一種非凡形式,JAAS在DOM（document．nbspObject Model）API的基礎上處理XML。大多數的SOAP信息組件派生自 avax.xml.soap.Node接口, 而這個接口又是org.w3c.dom.Node的子類。SAAJ繼續了Node來添加SOAP樣式的結構。舉例來說，這個非凡的Node, SOAPElement,代表了一個SOAP信息元素。
　　SAAJ依靠于接口和抽象類的直接結果是：你要通過工廠方法（factory methods）來完成大多數與SOAP相關的工作。要把你的程序鏈接到SAAJ API,你首先要創建一個來自工廠方法SOAPConnectionFactory的鏈接SOAPConnection。要創建和編輯SOAP信息,你可以初始化MessageFactory和SOAPFactory。MessageFactory能讓你產生SOAP信息，而 SOAPFactory則提供方法產生SOAP信息的各個部份:
　　
　　SOAPConnectionFactory spConFactory = SOAPConnectionFactory.newInstance();
　　SOAPConnection con = spConFactory.createConnection();
　　SOAPFactory soapFactory = SOAPFactory.newInstance();
　　
　　把這些工具用在適當的位置，你就可以創建一個 SOAP 信息，在前面的例子中，來自房產代理的客戶可以使用這些信息發送項目表更新給一個網站入口。
　　SAAJ 提供了幾個方法來產生一個新的 SOAP 信息。下面例子演示了用最簡單的方法來創建一個有封套（envelope）的空白SOAP信息,這個封套還帶有頭（heade）和體（body）。假如你在這個信息中不需要SOAP頭（SOAP header），那么你可以將這個元素從信息中刪除:
　　
　　SOAPMessage message = factory.createMessage();
　　SOAPHeader header = message.getSOAPHeader();
　　header.detachNode();
　　
　　把 XML 結構加入信息也是直接了當的:
　　
　　SOAPBody body = message.getSOAPBody();
　　
　　Name listingElementName = soapFactory.createName(
　　　　"propertyListing", "realProperty",
　　　　"http://schemas.realhouses.com/listingSubmission";);
　　SOAPBodyElement listingElement = body.addBodyElement(listingElementName);
　　
　　Name attname = soapFactory.createName("id");
　　listingElement.addAttribute(attname, "property_1234");
　　
　　SOAPElement listingAgency = listingElement.addChildElement("listingAgency");
　　listingAgency.addTextNode("Really Nice Homes, Inc");
　　
　　SOAPElement listingType = listingElement.addChildElement("listingType");
　　listingType.addTextNode("add");
　　
　　SOAPElement propertyAddress = listingElement.addChildElement("propertyAddress");
　　SOAPElement street = propertyAddress.addChildElement("street");
　　street.addTextNode("1234 Main St");
　　SOAPElement city = propertyAddress.addChildElement("city");
　　city.addTextNode("Pleasantville");
　　SOAPElement state = propertyAddress.addChildElement("state");
　　state.addTextNode("CA");
　　SOAPElement zip = propertyAddress.addChildElement("zip");
　　zip.addTextNode("94521");
　　
　　SOAPElement listPrice = listingElement.addChildElement("listPrice");
　　listPrice.addTextNode("25000");
　　
　　注重,你要把屬性的ID作為一個參數加入到屬性列表元素(propertyListing)中。更進一步的是，你要用QName, 或namespace來限定propertyListing元素。
　　
　　你可以用幾種方法把附件加入到SOAP信息中。在這一個例子中，你首先要創建元素來指示列表屬性的背景圖片和前景圖片。它們每個都有一個href屬性指明附件的內容ID:
　　
　　String frontImageID = "property1234_front_jpeg@realhouses.com";
　　SOAPElement frontImRef = listingElement.addChildElement("frontImage");
　　Name hrefAttName = soapFactory.createName("href");
　　frontImRef.addAttribute(hrefAttName, frontImageID);
　　
　　String interiorID = "property1234_interior_jpeg@realhouses.com";
　　SOAPElement interiorImRef = listingElement.addChildElement("interiorImage");
　　interiorImRef.addAttribute(hrefAttName, interiorID);
　　
　　要方便地把需要的圖像文件附加在信息中,可以使用JavaBeans Activation Framework架構里面的javax.activation.DataHandler對象。DataHandler能自動地檢測傳遞給它的數據類型，而且它還能自動地分配適當的MIME類型給附件:
　　
　　URL url = new URL("file&:///eXPort/files/pic1.jpg");
　　DataHandler dataHandler = new DataHandler(url);
　　AttachmentPart att = message.createAttachmentPart(dataHandler);
　　att.setContentId(frontImageID);
　　message.addAttachmentPart(att);
　　
　　另一種方法，你可以把一個對象,連同正確的MIME類型一起,傳遞到createAttachmentPart()方法里。這個方法跟第一個方法類似。在內部,SAAJ將會尋找處理器DataContentHandler 來處理這個MIME類型。假如它不能找一個合適的處理器,createAttachmentPart() 方法將會拋出一個IllegalArgumentException異常:
　　
　　URL url2 = new URL("file&:///export/files/pic2.jpg");
　　Image im　= Toolkit.getDefaultToolkit().createImage(url2);
　　AttachmentPart att2 = message.createAttachmentPart(im, "image/jpeg");
　　att2.setContentId(interiorID);
　　message.addAttachmentPart(att2);
　　
　　這個方法的缺點集中在：它依靠于AWT中示例UI（用戶界面user interface）相關的類。在一些粗心的（服務器）設置中，這些庫并沒有被正確的設置。
　　不管你選擇什么方法來產生附件，上述的代碼表示了在第一個列表里面的SOAP信息。既然這只是一個簡

上一篇：Weblogic 下 servlet實現應用級身份認證

下一篇：關于 Java web start 是干什么用的