java.lang.Object
   javax.xml.bind.attachment.AttachmentUnmarshaller

Enables JAXB unmarshalling of a root document containing optimized binary data formats.

This API enables an efficient cooperative processing of optimized binary data formats between a JAXB 2.0 implementation and MIME-based package processor (MTOM/XOP and WS-I AP 1.0). JAXB unmarshals the body of a package, delegating the understanding of the packaging format being used to a MIME-based package processor that implements this abstract class.

This abstract class identifies if a package requires XOP processing, #isXOPPackage() and provides retrieval of binary content stored as attachments by content-id.

Identifying the content-id, cid, to pass to getAttachment*(String cid)

• For XOP processing, the infoset representation of the cid is described in step 2a in Section 3.2 Interpreting XOP Packages
• For WS-I AP 1.0, the cid is identified as an element or attribute of type ref:swaRef specified in Section 4.4 Referencing Attachments from the SOAP Envelope

Also see:

javax.xml.bind.Unmarshaller#setAttachmentUnmarshaller(AttachmentUnmarshaller)
XML-binary Optimized Packaging
WS-I Attachments Profile Version 1.0.
Describing Media Content of Binary Data in XML
author: Marc - Hadley

author: Kohsuke - Kawaguchi

author: Joseph - Fialli

since: JAXB - 2.0

 abstract public byte[] getAttachmentAsByteArray(String cid)
Retrieve the attachment identified by content-id, cid,  as a byte[]
.

 abstract public DataHandler getAttachmentAsDataHandler(String cid)
Lookup MIME content by content-id, cid, and return as a DataHandler .

The returned DataHandler instance must be configured
to meet the following required mapping constaint.

  

    

      

      Required Mappings between MIME and Java Types
      
    

      
MIME Type
      
Java Type
    
    
    

      
DataHandler.getContentType()
      
instanceof DataHandler.getContent()
    
  
  

    

      
image/gif
      
java.awt.Image
    
    

      
image/jpeg
      
java.awt.Image
    
    

      
text/xml  or application/xml
      
javax.xml.transform.Source
    
  
 
Note that it is allowable to support additional mappings.

 public boolean isXOPPackage() 
{
 return false;
}