javax.xml.bind.helpers
クラス AbstractUnmarshallerImpl

java.lang.Object
  javax.xml.bind.helpers.AbstractUnmarshallerImpl

すべての実装されたインタフェース:

Unmarshaller

public abstract class AbstractUnmarshallerImpl
extends Object
implements Unmarshaller

部分的なデフォルト Unmarshaller 実装です。

このクラスは、Unmarshaller インタフェースの部分的なデフォルト実装を提供します。

JAXB プロバイダは、getUnmarshallerHandler、unmarshal(Node)、unmarshal(XMLReader,InputSource)、unmarshal(XMLStreamReader)、および unmarshal(XMLEventReader) の 5 つのメソッドを実装する必要があります 。

導入されたバージョン:

JAXB1.0

関連項目:

Unmarshaller

入れ子のクラスの概要

インタフェース javax.xml.bind.Unmarshaller から継承された入れ子のクラス/インタフェース

Unmarshaller.Listener

フィールドの概要

protected boolean

validating unmarshaller が検証を行うかどうか

コンストラクタの概要

AbstractUnmarshallerImpl()

メソッドの概要

protected UnmarshalException	createUnmarshalException(SAXException e) SAXException から UnmarshalException を作成します。
<A extends XmlAdapter> A	getAdapter(Class<A> type) 指定した型に関連付けられているアダプタを取得します。
AttachmentUnmarshaller	getAttachmentUnmarshaller()
ValidationEventHandler	getEventHandler() 現在のイベントハンドラ、または、それが設定されていない場合はデフォルトイベントハンドラを返します。
Unmarshaller.Listener	getListener() この Unmarshaller に登録されている Unmarshaller.Listener を返します。
Object	getProperty(String name) 必要なプロパティーがないため、getProperty メソッドのデフォルト実装は常に、PropertyException をスローします。
Schema	getSchema() 非整列化時の検証に使用されている JAXP 1.3 Schema オブジェクトを取得します。
protected XMLReader	getXMLReader() 設定された XMLReader を取得します。
boolean	isValidating() 非整列化操作中に検証するように Unmarshaller が設定されているかどうかを示します。
<A extends XmlAdapter> void	setAdapter(Class<A> type, A adapter) XmlAdapter の設定済みのインスタンスをこの Unmarshaller に関連付けます。
void	setAdapter(XmlAdapter adapter) XmlAdapter の設定済みのインスタンスをこの Unmarshaller に関連付けます。
void	setAttachmentUnmarshaller(AttachmentUnmarshaller au) cid、コンテンツ ID URI を、添付として渡されたバイナリデータに解決するコンテキストを関連付けます。
void	setEventHandler(ValidationEventHandler handler) アプリケーションが検証イベントハンドラを登録することができます。
void	setListener(Unmarshaller.Listener listener) この Unmarshaller に非整列化イベントコールバック Unmarshaller.Listener を登録します。
void	setProperty(String name, Object value) 必要なプロパティーがないため、setProperty メソッドのデフォルト実装は常に、PropertyException をスローします。
void	setSchema(Schema schema) 後の非整列化操作の検証に使用する、JAXP 1.3 Schema オブジェクトを指定します。
void	setValidating(boolean validating) 非整列化操作中に Unmarshaller が検証を行うかどうかを指定します。
Object	unmarshal(File f) 指定されたファイルから XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(InputSource source) 指定された SAX InputSource から XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(InputStream is) 指定された InputStream から XML データを非整列化し、結果のコンテンツツリーを返します。
<T> JAXBElement<T>	unmarshal(Node node, Class<T> expectedType) JAXB マップ declaredType によって XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(Reader reader) 指定された Reader から XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(Source source) 指定された XML Source から XML データを非整列化し、結果のコンテンツツリーを返します。
<T> JAXBElement<T>	unmarshal(Source source, Class<T> expectedType) declaredType に基づき、指定された XML Source から XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(URL url) 指定された URL から XML データを非整列化し、結果のコンテンツツリーを返します。
Object	unmarshal(XMLEventReader reader) 指定されたプルパーサーから XML データを非整列化し、結果のコンテンツツリーを返します。
<T> JAXBElement<T>	unmarshal(XMLEventReader reader, Class<T> expectedType) JAXB マップ declaredType にルート要素を非整列化し、結果のコンテンツツリーを返します。
protected abstract Object	unmarshal(XMLReader reader, InputSource source) 指定した XMLReader と InputSource を使用して、オブジェクトを非整列化します。
Object	unmarshal(XMLStreamReader reader) 指定されたプルパーサーから XML データを非整列化し、結果のコンテンツツリーを返します。
<T> JAXBElement<T>	unmarshal(XMLStreamReader reader, Class<T> expectedType) JAXB マップ declaredType にルート要素を非整列化し、結果のコンテンツツリーを返します。

クラス java.lang.Object から継承されたメソッド

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

インタフェース javax.xml.bind.Unmarshaller から継承されたメソッド

getUnmarshallerHandler, unmarshal

フィールドの詳細

validating

protected boolean validating

unmarshaller が検証を行うかどうか

コンストラクタの詳細

AbstractUnmarshallerImpl

public AbstractUnmarshallerImpl()

メソッドの詳細

getXMLReader

protected XMLReader getXMLReader()
                          throws JAXBException

設定された XMLReader を取得します。 このメソッドは、クライアントが指定した SAXSource オブジェクトに XMLReader がない場合に使用されます。 Unmarshaller は再入不可能なため、XMLReader の単一のインスタンスのみが使用されます。

例外:

JAXBException

unmarshal

public Object unmarshal(Source source)
                 throws JAXBException

インタフェース Unmarshaller の記述:

指定された XML Source から XML データを非整列化し、結果のコンテンツツリーを返します。

グローバルルート要素の非整列化を実装します。

プラグイン可能な SAX 2.0 パーサー

クライアントアプリケーションは、その JAXB プロバイダで提供されているデフォルトパーサー機構を使用しないことを選択できます。任意の SAX 2.0 準拠パーサーを、JAXB プロバイダのデフォルト機構に置換することができます。これを行うため、クライアントアプリケーションは、SAX 2.0 パーサープロバイダが実装している XMLReader を含む SAXSource を適切に設定する必要があります。XMLReader に org.xml.sax.ErrorHandler が登録されている場合、それが JAXB プロバイダによって置き換えられ、検証エラーは JAXB の ValidationEventHandler 機構を介して報告される可能性があります。SAXSource に XMLReader が含まれない場合、JAXB プロバイダのデフォルトパーサー機構が使用されます。

このパーサー置換機構は、JAXB プロバイダの非整列化時の検証エンジンの置換にも使用できます。クライアントアプリケーションは、(前述の例に示したように) その SAX 2.0 準拠パーサーが検証を実行するように適切に設定する必要があります。非整列化操作中にパーサーが SAXParserExceptions に遭遇すると、JAXB プロバイダがそれを処理し、JAXB ValidationEvent オブジェクトに変換されます。このオブジェクトは、Unmarshaller に登録されている ValidationEventHandler を介してクライアントに報告されます。注: 非整列化に代替の検証 SAX 2.0 パーサーを指定した場合でも、オンデマンドの検証を実行するために JAXB プロバイダが使用する検証エンジンは必ずしも置き換えられません。

非整列化中に使用される別のパーサー機構をクライアントアプリケーションが指定できる唯一の方法は、unmarshal(SAXSource) API を介する方法です。非整列化メソッドの他のすべての形式 (File、URL、Node など) は、JAXB プロバイダのデフォルトのパーサーとバリデータ機構を使用します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

source - 非整列化する XML データが含まれる XML Source (プロバイダは、 SAXSource、DOMSource、StreamSource をサポートする必要があるのみ)

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

関連項目:

Unmarshaller.unmarshal(javax.xml.transform.Source, Class)

unmarshal

protected abstract Object unmarshal(XMLReader reader,
                                    InputSource source)
                             throws JAXBException

指定した XMLReader と InputSource を使用して、オブジェクトを非整列化します。 呼び出される側は、XMLReader の setErrorHandler メソッドを呼び出し、エラーがクライアント指定の ValidationEventHandler に渡されるようにしてください。

例外:

JAXBException

unmarshal

public final Object unmarshal(InputSource source)
                       throws JAXBException

インタフェース Unmarshaller の記述:

指定された SAX InputSource から XML データを非整列化し、結果のコンテンツツリーを返します。

グローバルルート要素の非整列化を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

source - 非整列化する XML データが含まれる入力ソース

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public final Object unmarshal(URL url)
                       throws JAXBException

インタフェース Unmarshaller の記述:

指定された URL から XML データを非整列化し、結果のコンテンツツリーを返します。

グローバルルート要素の非整列化を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

url - 非整列化する XML データが含まれる URL

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public final Object unmarshal(File f)
                       throws JAXBException

インタフェース Unmarshaller の記述:

指定されたファイルから XML データを非整列化し、結果のコンテンツツリーを返します。

グローバルルート要素の非整列化を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

f - 非整列化する XML データが含まれるファイル

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public final Object unmarshal(InputStream is)
                       throws JAXBException

インタフェース Unmarshaller の記述:

指定された InputStream から XML データを非整列化し、結果のコンテンツツリーを返します。この形式の非整列化 API を使用した場合、検証イベントの位置情報が不完全な場合があります。

グローバルルート要素の非整列化を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

is - 非整列化する XML データが含まれる InputStream

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public final Object unmarshal(Reader reader)
                       throws JAXBException

インタフェース Unmarshaller の記述:

指定された Reader から XML データを非整列化し、結果のコンテンツツリーを返します。この形式の非整列化 API を使用した場合、Reader はシステム ID を提供しないため、検証イベントの位置情報が不完全な場合があります。

グローバルルート要素の非整列化を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

reader - 非整列化する XML データが含まれる Reader

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

isValidating

public boolean isValidating()
                     throws JAXBException

非整列化操作中に検証するように Unmarshaller が設定されているかどうかを示します。

注: getValidating() に対して、JAXP に合わせて isValidating() というメソッド名にしました。

定義:

インタフェース Unmarshaller 内の isValidating

戻り値:

Unmarshaller が非整列化操作中に検証を実行するように設定されている 場合、true。それ以外の場合、false

例外:

JAXBException - 検証フラグの取得中にエラーが発生した場合

setEventHandler

public void setEventHandler(ValidationEventHandler handler)
                     throws JAXBException

アプリケーションが検証イベントハンドラを登録することができます。

検証イベントハンドラは、いずれかの unmarshal メソッドを呼び出している途中で検証エラーが発生した場合、JAXB プロバイダによって呼び出されます。非整列化メソッドを呼び出す前に、クライアントアプリケーションが検証イベントハンドラを登録しなかった場合、すべての検証イベントは通知されることなく無視され、予想外の動作を引き起こす可能性があります。

定義:

インタフェース Unmarshaller 内の setEventHandler

パラメータ:

handler - 検証イベントハンドラ

例外:

JAXBException - イベントハンドラの設定中にエラーが発生した場合

setValidating

public void setValidating(boolean validating)
                   throws JAXBException

非整列化操作中に Unmarshaller が検証を行うかどうかを指定します。デフォルトでは、Unmarshaller は検証を行いません。

このメソッドは、非整列化メソッドのいずれかを呼び出す前、または呼び出したあとに、呼び出すことができます。

定義:

インタフェース Unmarshaller 内の setValidating

パラメータ:

validating - Unmarshaller が非整列化中に検証すべき場合、true それ以外の場合、false

例外:

JAXBException - 非整列化時の検証を有効または無効にしている途中で エラーが発生した場合

getEventHandler

public ValidationEventHandler getEventHandler()
                                       throws JAXBException

現在のイベントハンドラ、または、それが設定されていない場合はデフォルトイベントハンドラを返します。

定義:

インタフェース Unmarshaller 内の getEventHandler

戻り値:

現在の ValidationEventHandler、または、それが設定されていない場合、 デフォルトイベントハンドラ

例外:

JAXBException - 現在のイベントハンドラの取得中にエラーが発生した場合

createUnmarshalException

protected UnmarshalException createUnmarshalException(SAXException e)

SAXException から UnmarshalException を作成します。 これは、派生クラスに提供されるユーティリティーメソッドです。

プロバイダが実装した ContentHandler が JAXBException をスローすることを望む場合、SAXException によってその例外をラップする必要があります。unmarshaller 実装が JAXBException によって SAXException をやみくもにラップした場合、こうした例外がほかの JAXBException によってラップされた SAXException によってラップされた JAXBException になります。これは非常に無益です。

このメソッドは、SAXException の入れ子の例外をチェックし、こうした過剰なラップを排除します。

戻り値:

結果の UnmarshalException

setProperty

public void setProperty(String name,
                        Object value)
                 throws PropertyException

必要なプロパティーがないため、setProperty メソッドのデフォルト実装は常に、PropertyException をスローします。プロバイダは追加プロパティーを扱う必要がある場合、派生クラスでこのメソッドをオーバーライドするようにしてください。

定義:

インタフェース Unmarshaller 内の setProperty

パラメータ:

name - 設定するプロパティーの名前。この値は、定数フィールドの 1 つか ユーザー指定文字列を使用して指定できる

value - 設定するプロパティーの値

例外:

PropertyException - 与えられたプロパティーまたは値の処理中にエラーが 発生した場合

getProperty

public Object getProperty(String name)
                   throws PropertyException

必要なプロパティーがないため、getProperty メソッドのデフォルト実装は常に、PropertyException をスローします。プロバイダは追加プロパティーを扱う必要がある場合、派生クラスでこのメソッドをオーバーライドするようにしてください。

定義:

インタフェース Unmarshaller 内の getProperty

パラメータ:

name - 取得するプロパティーの名前

戻り値:

要求されたプロパティーの値

例外:

PropertyException - 指定したプロパティー、またはプロパティー名値の取得中にエラーが発生 した場合

unmarshal

public Object unmarshal(XMLEventReader reader)
                 throws JAXBException

インタフェース Unmarshaller の記述:

指定されたプルパーサーから XML データを非整列化し、結果のコンテンツツリーを返します。

このメソッドは、グローバルルートの非整列化メソッドです。

このメソッドは、パーサーでの START_DOCUMENT または START_ELEMENT イベントの発生を前提としています。非整列化は、この start イベントから、対応する end イベントまでの間に実行されます。このメソッドが正常な結果を返す場合、reader は、end イベントの直後のトークンをポイントします。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

reader - 読み込まれるパーサー

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

関連項目:

Unmarshaller.unmarshal(javax.xml.stream.XMLEventReader, Class)

unmarshal

public Object unmarshal(XMLStreamReader reader)
                 throws JAXBException

インタフェース Unmarshaller の記述:

指定されたプルパーサーから XML データを非整列化し、結果のコンテンツツリーを返します。

グローバルルート要素の非整列化を実装します。

このメソッドは、パーサーでの START_DOCUMENT または START_ELEMENT イベントの発生を前提としています。非整列化は、この start イベントから、対応する end イベントまでの間に実行されます。このメソッドが正常な結果を返す場合、reader は、end イベントの直後のトークンをポイントします。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

reader - 読み込まれるパーサー

戻り値:

新しく作成される Java コンテンツツリーのルートオブジェクト

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

関連項目:

Unmarshaller.unmarshal(javax.xml.stream.XMLStreamReader, Class)

unmarshal

public <T> JAXBElement<T> unmarshal(Node node,
                                    Class<T> expectedType)
                         throws JAXBException

インタフェース Unmarshaller の記述:

JAXB マップ declaredType によって XML データを非整列化し、結果のコンテンツツリーを返します。

「宣言型による非整列化」を実装します。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

node - 非整列化する XML データが含まれる文書または要素。 呼び出し側は最低限、文書と要素をサポートする必要がある

expectedType - node の XML データを保持する、適切な JAXB マップクラス

戻り値:

node の JAXB 要素表現

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public <T> JAXBElement<T> unmarshal(Source source,
                                    Class<T> expectedType)
                         throws JAXBException

インタフェース Unmarshaller の記述:

declaredType に基づき、指定された XML Source から XML データを非整列化し、結果のコンテンツツリーを返します。

「宣言型による非整列化」を実装します。

「プラグイン可能な SAX 2.0 パーサー」を参照してください。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

source - 非整列化する XML データが含まれる XML Source (プロバイダは、 SAXSource、DOMSource、StreamSource をサポートする必要があるのみ)

expectedType - source の XML ルート要素を保持する、適切な JAXB マップクラス

戻り値:

JAXB 要素をルートとする Java コンテンツ

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public <T> JAXBElement<T> unmarshal(XMLStreamReader reader,
                                    Class<T> expectedType)
                         throws JAXBException

インタフェース Unmarshaller の記述:

JAXB マップ declaredType にルート要素を非整列化し、結果のコンテンツツリーを返します。

このメソッドは、宣言型による非整列化を実装します。

このメソッドは、パーサーでの START_DOCUMENT または START_ELEMENT イベントの発生を前提としています。非整列化は、この start イベントから、対応する end イベントまでの間に実行されます。このメソッドが正常な結果を返す場合、reader は、end イベントの直後のトークンをポイントします。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

reader - 読み込まれるパーサー

expectedType - reader の START_ELEMENT XML データを保持する、適切な JAXB マップクラス

戻り値:

JAXB 要素表現をルートとするコンテンツツリー

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public <T> JAXBElement<T> unmarshal(XMLEventReader reader,
                                    Class<T> expectedType)
                         throws JAXBException

インタフェース Unmarshaller の記述:

JAXB マップ declaredType にルート要素を非整列化し、結果のコンテンツツリーを返します。

このメソッドは、宣言型による非整列化を実装します。

このメソッドは、パーサーでの START_DOCUMENT または START_ELEMENT イベントの発生を前提としています。非整列化は、この start イベントから、対応する end イベントまでの間に実行されます。このメソッドが正常な結果を返す場合、reader は、end イベントの直後のトークンをポイントします。

定義:

インタフェース Unmarshaller 内の unmarshal

パラメータ:

reader - 読み込まれるパーサー

expectedType - reader の START_ELEMENT XML データを保持する、適切な JAXB マップクラス

戻り値:

JAXB 要素表現をルートとするコンテンツツリー

例外:

JAXBException - 非整列化の実行中に予想外のエラーが発生した場合

UnmarshalException - ValidationEventHandler の handleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

setSchema

public void setSchema(Schema schema)

インタフェース Unmarshaller の記述:

後の非整列化操作の検証に使用する、JAXP 1.3 Schema オブジェクトを指定します。このメソッドに null を渡すと、検証は無効になります。

このメソッドは、推奨されなくなった setValidating(boolean) API に置き換わるものです。

このプロパティーは最初に null に設定されます。

定義:

インタフェース Unmarshaller 内の setSchema

パラメータ:

schema - 非整列化操作の検証に使用するスキーマオブジェクト。検証を無効にする場合は null

getSchema

public Schema getSchema()

インタフェース Unmarshaller の記述:

非整列化時の検証に使用されている JAXP 1.3 Schema オブジェクトを取得します。Unmarshaller にスキーマが設定されていない場合、このメソッドは、非整列化時に検証を実行しないことを示す、null を返します。

このメソッドは、推奨されなくなった Unmarshaller.isValidating() API に置き換わるとともに、Schema オブジェクトへのアクセスを提供します。Unmarshaller が検証を有効にしているかどうかを判断するには、戻り値の型と null を照らし合わせてチェックすれば簡単にわかります。

boolean isValidating = u.getSchema()!=null;

定義:

インタフェース Unmarshaller 内の getSchema

戻り値:

非整列化時の検証を実行するために使用されるスキーマオブジェクト、 または、存在しない場合、null

setAdapter

public void setAdapter(XmlAdapter adapter)

インタフェース Unmarshaller の記述:

XmlAdapter の設定済みのインスタンスをこの Unmarshaller に関連付けます。

これは、setAdapter(adapter.getClass(),adapter); を呼び出す簡易メソッドです。

定義:

インタフェース Unmarshaller 内の setAdapter

関連項目:

Unmarshaller.setAdapter(Class,XmlAdapter)

setAdapter

public <A extends XmlAdapter> void setAdapter(Class<A> type,
                                              A adapter)

インタフェース Unmarshaller の記述:

XmlAdapter の設定済みのインスタンスをこの Unmarshaller に関連付けます。

すべての Unmarshaller は、内部的に Map<Class,XmlAdapter> を保持しており、フィールドまたはメソッドが XmlJavaTypeAdapter で注釈されたクラスを非整列化するために使用します。

このメソッドにより、アプリケーションは XmlAdapter の設定済みのインスタンスを使用することができます。アダプタのインスタンスが与えられない場合、Unmarshaller はそのデフォルトコンストラクタを呼び出してインスタンスを作成します。

定義:

インタフェース Unmarshaller 内の setAdapter

パラメータ:

type - アダプタの型。XmlJavaTypeAdapter.value() がこの型を参照している場合、指定されたインスタンスが使用される

adapter - 使用するアダプタのインスタンス。null の場合、この型の現在のアダプタ セットの登録を取り消す

getAdapter

public <A extends XmlAdapter> A getAdapter(Class<A> type)

インタフェース Unmarshaller の記述:

指定した型に関連付けられているアダプタを取得します。 このメソッドは、Unmarshaller.setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter) メソッドの逆の操作です。

定義:

インタフェース Unmarshaller 内の getAdapter

setAttachmentUnmarshaller

public void setAttachmentUnmarshaller(AttachmentUnmarshaller au)

インタフェース Unmarshaller の記述:

cid、コンテンツ ID URI を、添付として渡されたバイナリデータに解決するコンテキストを関連付けます。

非整列化時の検証は、Unmarshaller.setSchema(Schema) を介して有効化され、Unmarshaller が XOP 処理を実行する場合でもサポートする必要があります。

定義:

インタフェース Unmarshaller 内の setAttachmentUnmarshaller

getAttachmentUnmarshaller

public AttachmentUnmarshaller getAttachmentUnmarshaller()

定義:

インタフェース Unmarshaller 内の getAttachmentUnmarshaller

setListener

public void setListener(Unmarshaller.Listener listener)

インタフェース Unmarshaller の記述:

この Unmarshaller に非整列化イベントコールバック Unmarshaller.Listener を登録します。

各 Unmarshaller に Listener は 1 つだけです。Listener を設定すると、前に設定されていた Listener と置き換わります。Listener に null を設定することにより、現在の Listener の登録を解除できます。

定義:

インタフェース Unmarshaller 内の setListener

パラメータ:

listener - この Unmarshaller に非整列化イベントコールバックを提供する

getListener

public Unmarshaller.Listener getListener()

インタフェース Unmarshaller の記述:

この Unmarshaller に登録されている Unmarshaller.Listener を返します。

定義:

インタフェース Unmarshaller 内の getListener

戻り値:

登録されている Unmarshaller.Listener、または、この Unmarshaller に登録されている Listener がない場合、null