javax.xml.bind.attachment
클래스 AttachmentUnmarshaller

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

public abstract class AttachmentUnmarshaller
extends Object 

최적화된 바이너리 데이터 형식을 포함한 루트 문서의 JAXB 비정렬화를 가능하게 합니다.

이 API 는, JAXB 2.0 구현과 MIME 베이스 패키지 프로세서 (MTOM/XOP 및 WS-I AP 1.0) 간에 있어서의, 최적화된 바이너리 데이터 형식의 효율적 또한 협조적인 처리를 가능하게 합니다. JAXB 는, 패키지의 본체를 비정렬화해, 사용되는 패키징 형식에 대한 이해를 이 abstract 클래스를 구현하는 MIME 베이스 패키지 프로세서에 위임합니다.

이 abstract 클래스는, 패키지가 XOP 처리를 필요로 할지 어떨지를 식별해 (isXOPPackage() ), 첨부로서 보존되고 있는 바이너리 컨텐츠를 컨텐츠 ID 에 의해 취득할 수 있도록(듯이) 합니다.

getAttachment*(String cid) 에 건네주는 컨텐츠 ID, cid 의 식별

• XOP 처리에 있어서의 cid 의 정보 세트 표현은, 「3.2 Interpreting XOP Packages 」의 스텝 2a 에 기재되어 있습니다.
• WS-I AP 1.0 에 있어서의 cid 는, 「Referencing Attachments from the SOAP Envelope 」에 기재되어 있는 ref:swaRef 형의 요소 또는 속성으로서 식별됩니다.

도입된 버젼:

JAXB 2.0

관련 항목:

Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller) , XML-binary Optimized Packaging , WS-I Attachments Profile Version 1.0. , Describing Media Content of Binary Data in XML

생성자 의 개요

AttachmentUnmarshaller ()

메소드의 개요

abstract byte[]	getAttachmentAsByteArray (String cid) 컨텐츠 ID,cid 에 의해 식별된 첨부를,byte[] 로서 가져옵니다.
abstract DataHandler	getAttachmentAsDataHandler (String cid) 컨텐츠 ID,cid 에 근거해 MIME 컨텐츠를 검색해,DataHandler 로서 돌려줍니다.
boolean	isXOPPackage () JAXB unmarshaller 가 XOP 처리를 실행할 필요가 있는 경우, true 를 돌려주는 읽기 전용 프로퍼티입니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

AttachmentUnmarshaller

public AttachmentUnmarshaller()

메소드의 상세

getAttachmentAsDataHandler

public abstract DataHandler  getAttachmentAsDataHandler(String  cid)

컨텐츠 ID,cid 에 근거해 MIME 컨텐츠를 검색해,DataHandler 로서 돌려줍니다.

반환값의 DataHandler 인스턴스는, 다음의 필요하게 되는 매핑 제약을 채우도록(듯이) 설정될 필요가 있습니다.

MIME 및 Java 형의 사이에 필요하게 되는 매핑
MIME 타입	Java 형
DataHandler.getContentType()	instanceof DataHandler.getContent()
image/gif	java.awt.Image
image/jpeg	java.awt.Image
text/xml 또는 application/xml	javax.xml.transform.Source

추가의 매핑을 지원할 수도 있습니다.

파라미터:

cid - XML Schema xs:anyURI 데이터형의 유효한 자구 표현인 것이 기대된다. isXOPPackage() ==true 의 경우, 각 cid: URI schema에 대한 유효한 URI 가 아니면 안 된다 (RFC 2387 을 참조)

반환값:

MIME 첨부를 나타내는 DataHandler

예외:

IllegalArgumentException - 지정한 cid 의 첨부가 발견되지 않는 경우

getAttachmentAsByteArray

public abstract byte[] getAttachmentAsByteArray(String  cid)

컨텐츠 ID,cid 에 의해 식별된 첨부를,byte[] 로서 가져옵니다.

.

파라미터:

cid - XML Schema xs:anyURI 데이터형의 유효한 자구 표현인 것이 기대된다. isXOPPackage() ==true 의 경우, 각 cid: URI schema에 대한 유효한 URI 가 아니면 안 된다 (RFC 2387 을 참조)

반환값:

cid 에 의해 식별된 첨부의 byte [] 표현

예외:

IllegalArgumentException - 지정한 cid 의 첨부가 발견되지 않는 경우

isXOPPackage

public boolean isXOPPackage()

JAXB unmarshaller 가 XOP 처리를 실행할 필요가 있는 경우, true 를 돌려주는 읽기 전용 프로퍼티입니다.

「Identifying XOP Documents 」로 지정된 제약을 채우는 경우, 이 메소드는 true 를 돌려줍니다. 정렬화 프로세스중에, 이 값을 변경하지 말아 주세요.

반환값:

MIME 문맥이 XOP 문서의 경우, true