public abstract class AttachmentUnmarshaller extends ObjectSE
最適化されたバイナリデータ形式を含むルートドキュメントの Jakarta XML Binding アンマーシャリングを有効にします。
この API により、Jakarta XML Binding 実装と MIME ベースのパッケージプロセッサー (MTOM/XOP および WS-I AP 1.0) の間で、最適化されたバイナリデータ形式の効率的な協調処理が可能になります。Jakarta XML Binding はパッケージの本体をアンマーシャリングし、使用されているパッケージ形式の理解を、この抽象クラスを実装する MIME ベースのパッケージプロセッサーに委譲します。
この抽象クラスは、パッケージが XOP 処理 isXOPPackage()
を必要とするかどうかを識別し、content-id によって接続ファイルとして保存されているバイナリコンテンツの取得を提供します。
getAttachment*(String cid)
に渡すコンテンツ ID cid の識別 ref:swaRef
の要素または属性として識別されます。Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller)
, XML バイナリ最適化パッケージ , WS-I 接続ファイルプロファイルバージョン 1.0 ., XML でのバイナリデータのメディアコンテンツの記述コンストラクターと説明 |
---|
AttachmentUnmarshaller() |
修飾子と型 | メソッドと説明 |
---|---|
abstract byte[] | getAttachmentAsByteArray(StringSE cid) content-id cid で識別される添付ファイルを byte[] として取得します。 |
abstract DataHandler | getAttachmentAsDataHandler(StringSE cid) content-id、 cid で MIME コンテンツを検索し、DataHandler として返します。 |
boolean | isXOPPackage() Jakarta XML Binding アンマーシャラーが XOP 処理を実行する必要がある場合に true を返す読み取り専用プロパティ。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public abstract DataHandler getAttachmentAsDataHandler(StringSE cid)
content-id、cid
で MIME コンテンツを検索し、DataHandler
として返します。
返される DataHandler
インスタンスは、次の必要なマッピングの制約を満たすように構成する必要があります。
MIME 型 | Java 型 |
---|---|
DataHandler.getContentType() | instanceof DataHandler.getContent() |
イメージ /gif | java.awt.Image |
イメージ /jpeg | java.awt.Image |
text/xml または application/xml | javax.xml.transform.Source |
cid
- これは、XML スキーマ xs:anyURI
データ型の有効な字句形式であることが期待されます。isXOPPackage()
==true
の場合、cid:
URI スキームごとの有効な URI である必要があります (RFC 2387 を参照)DataHandler
。IllegalArgumentExceptionSE
- 指定された cid の添付ファイルが見つからない場合。public abstract byte[] getAttachmentAsByteArray(StringSE cid)
content-id cid
で識別される添付ファイルを byte[]
として取得します。
cid
- これは、XML スキーマ xs:anyURI
データ型の有効な字句形式であることが期待されます。isXOPPackage()
==true
の場合、cid:
URI スキームごとの有効な URI である必要があります (RFC 2387 を参照)IllegalArgumentExceptionSE
- 指定された cid の添付ファイルが見つからない場合。public boolean isXOPPackage()
Jakarta XML Binding アンマーシャラーが XOP 処理を実行する必要がある場合に true を返す読み取り専用プロパティ。
このメソッドは、XOP ドキュメントの識別で指定された制約が満たされると、true
を返します。この値は、非整列化プロセス中に変更してはなりません。
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.