JavaTM Platform
Standard Ed. 6

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 を適切に設定する必要があります。XMLReaderorg.xml.sax.ErrorHandler が登録されている場合、それが JAXB プロバイダによって置き換えられ、検証エラーは JAXB の ValidationEventHandler 機構を介して報告される可能性があります。SAXSourceXMLReader が含まれない場合、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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから false が返されるか、または Unmarshaller が XML から Java へのバインディングを実行 できない場合。「XML データの非整列化」を参照

unmarshal

public final Object unmarshal(File f)
                       throws JAXBException
インタフェース Unmarshaller の記述:
指定されたファイルから XML データを非整列化し、結果のコンテンツツリーを返します。

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

定義:
インタフェース Unmarshaller 内の unmarshal
パラメータ:
f - 非整列化する XML データが含まれるファイル
戻り値:
新しく作成される Java コンテンツツリーのルートオブジェクト
例外:
JAXBException - 非整列化の実行中に予想外のエラーが発生した場合
UnmarshalException - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 マップクラス
戻り値:
nodeJAXB 要素表現
例外:
JAXBException - 非整列化の実行中に予想外のエラーが発生した場合
UnmarshalException - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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 - ValidationEventHandlerhandleEvent メソッドから 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。