Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.xml.bind.attachment.AttachmentUnmarshaller
public abstract class 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.
getAttachment*(String cid)
ref:swaRef
specified in
Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller)
,
Constructor Summary | |
---|---|
AttachmentUnmarshaller()
|
Method Summary | |
---|---|
abstract byte[] |
getAttachmentAsByteArray(java.lang.String cid)
Retrieve the attachment identified by content-id, cid , as a byte[] |
abstract javax.activation.DataHandler |
getAttachmentAsDataHandler(java.lang.String cid)
Lookup MIME content by content-id, cid , and return as a DataHandler . |
boolean |
isXOPPackage()
Read-only property that returns true if JAXB unmarshaller needs to perform XOP processing. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AttachmentUnmarshaller()
Method Detail |
---|
public abstract javax.activation.DataHandler getAttachmentAsDataHandler(java.lang.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 |
cid
- It is expected to be a valid lexical form of the XML Schema
xs:anyURI
datatype. If isXOPPackage()
==true
, it must be a valid URI per the cid:
URI scheme (see DataHandler
that represents the MIME attachment.
IllegalArgumentException
- if the attachment for the given cid is not found.public abstract byte[] getAttachmentAsByteArray(java.lang.String cid)
Retrieve the attachment identified by content-id, cid
, as a byte[]
cid
- It is expected to be a valid lexical form of the XML Schema
xs:anyURI
datatype. If isXOPPackage()
==true
, it must be a valid URI per the cid:
URI scheme (see IllegalArgumentException
- if the attachment for the given cid is not found.public boolean isXOPPackage()
Read-only property that returns true if JAXB unmarshaller needs to perform XOP processing.
This method returns true
when the constraints specified
in
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to
Generated on 10-February-2011 12:41