- 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つのメソッドを実装する必要があります。
- 導入されたバージョン:
- 1.6, JAXB 1.0
- 関連項目:
Unmarshaller
-
-
ネストされたクラスのサマリー
-
インタフェース javax.xml.bind.Unmarshallerから継承されたネストされたクラス/インタフェース
Unmarshaller.Listener
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 protected boolean
validating
unmarshallerが検証を行うかどうか
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 AbstractUnmarshallerImpl()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 protected UnmarshalException
createUnmarshalException(SAXException e)
SAXExceptionからUnmarshalExceptionを作成します。<A extends XmlAdapter>
AgetAdapter(Class<A> type)
指定した型に関連付けられているアダプタを取得します。AttachmentUnmarshaller
getAttachmentUnmarshaller()
ValidationEventHandler
getEventHandler()
現在のイベント・ハンドラ、または、それが設定されていない場合はデフォルト・イベント・ハンドラを返します。Unmarshaller.Listener
getListener()
このUnmarshaller
に登録されたUnmarshaller.Listener
を返します。Object
getProperty(String name)
必要なプロパティがないため、getPropertyメソッドのデフォルト実装は常に、PropertyExceptionをスローします。Schema
getSchema()
非整列化時の検証に使用されるJAXP 1.3Schema
オブジェクトを取得します。protected XMLReader
getXMLReader()
設定されたXMLReaderを取得します。boolean
isValidating()
非整列化操作中に検証するようにUnmarshallerが設定されているかどうかを示します。<A extends XmlAdapter>
voidsetAdapter(Class<A> type, A adapter)
XmlAdapter
の構成済みのインスタンスをこのアンマーシャラに関連付けます。void
setAdapter(XmlAdapter adapter)
XmlAdapter
の構成済みのインスタンスをこのアンマーシャラに関連付けます。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.3Schema
オブジェクトを指定します。void
setValidating(boolean validating)
非整列化操作中にUnmarshallerが検証を行うかどうかを指定します。Object
unmarshal(File f)
指定されたファイルからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(InputStream is)
指定されたInputStreamからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(Reader reader)
指定されたReaderからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(URL url)
指定されたURLからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(XMLEventReader reader)
指定されたプル・パーサーからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。<T> JAXBElement<T>
unmarshal(XMLEventReader reader, Class<T> expectedType)
JAXBマップdeclaredType
にルート要素を非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(XMLStreamReader reader)
指定されたプル・パーサーからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。<T> JAXBElement<T>
unmarshal(XMLStreamReader reader, Class<T> expectedType)
JAXBマップdeclaredType
にルート要素を非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(Source source)
指定されたXML SourceからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。<T> JAXBElement<T>
unmarshal(Source source, Class<T> expectedType)
declaredType
に基づき、指定されたXML SourceからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。<T> JAXBElement<T>
unmarshal(Node node, Class<T> expectedType)
JAXBマップdeclaredType
によってXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。Object
unmarshal(InputSource source)
指定されたSAX InputSourceからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。protected abstract Object
unmarshal(XMLReader reader, InputSource source)
指定したXMLReaderとInputSourceを使用して、オブジェクトを非整列化します。-
クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
インタフェース javax.xml.bind.Unmarshallerから継承されたメソッド
getUnmarshallerHandler, unmarshal
-
-
-
-
メソッドの詳細
-
getXMLReader
protected XMLReader getXMLReader() throws JAXBException
設定されたXMLReaderを取得します。 このメソッドは、クライアントが指定したSAXSource
オブジェクトにXMLReaderがない場合に使用されます。Unmarshaller
は再入不可能なため、XMLReaderの単一のインスタンスのみが使用されます。- 例外:
JAXBException
-
unmarshal
public Object unmarshal(Source source) throws JAXBException
インタフェースからコピーされた説明:Unmarshaller
指定されたXML SourceからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。グローバル・ルート要素の非整列化を実装します。
クライアント・アプリケーションは、その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プロバイダによって処理され、JAXBValidationEvent
オブジェクトに変換され、Unmarshaller
で登録されたValidationEventHandler
を介してクライアントに報告されます。 注: 非整列化に代替の検証SAX 2.0パーサーを指定した場合でも、オンデマンドの検証を実行するためにJAXBプロバイダが使用する検証エンジンは必ずしも置き換えられません。非整列化中に使用される別のパーサー・メカニズムをクライアント・アプリケーションが指定できる唯一の方法は、
unmarshal(SAXSource)
APIを介する方法です。 非整列化メソッドのほかのすべての形式(File、URL、Nodeなど)は、JAXBプロバイダのデフォルトのパーサーとバリデータ・メカニズムを使用します。- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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データを非整列化し、結果として得られるコンテンツ・ツリーを返します。グローバル・ルート要素の非整列化を実装します。
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
source
- 非整列化するXMLデータが含まれる入力ソース- 戻り値:
- 新しく作成されるJavaコンテンツ・ツリーのルート・オブジェクト
- 例外:
JAXBException
- 非整列化の実行中に予想外のエラーが発生した場合UnmarshalException
-ValidationEventHandler
のhandleEvent
メソッドからfalseが返されるか、Unmarshaller
がXMLからJavaへのバインディングを実行できない場合。 XMLデータの非整列化を参照
-
unmarshal
public final Object unmarshal(URL url) throws JAXBException
インタフェースからコピーされた説明:Unmarshaller
指定されたURLからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。グローバル・ルート要素の非整列化を実装します。
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
url
- 非整列化するXMLデータが含まれるURL- 戻り値:
- 新しく作成されるJavaコンテンツ・ツリーのルート・オブジェクト
- 例外:
JAXBException
- 非整列化の実行中に予想外のエラーが発生した場合UnmarshalException
-ValidationEventHandler
のhandleEvent
メソッドからfalseが返されるか、Unmarshaller
がXMLからJavaへのバインディングを実行できない場合。 XMLデータの非整列化を参照
-
unmarshal
public final Object unmarshal(File f) throws JAXBException
インタフェースからコピーされた説明:Unmarshaller
指定されたファイルからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。グローバル・ルート要素の非整列化を実装します。
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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を使用した場合、検証イベントの位置情報が不完全な場合があります。グローバル・ルート要素の非整列化を実装します。
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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を提供しないため、検証イベントの位置情報が不完全な場合があります。グローバル・ルート要素の非整列化を実装します。
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
reader
- 非整列化するXMLデータが含まれるReader- 戻り値:
- 新しく作成されるJavaコンテンツ・ツリーのルート・オブジェクト
- 例外:
JAXBException
- 非整列化の実行中に予想外のエラーが発生した場合UnmarshalException
-ValidationEventHandler
のhandleEvent
メソッドからfalseが返されるか、Unmarshaller
がXMLからJavaへのバインディングを実行できない場合。 XMLデータの非整列化を参照
-
isValidating
public boolean isValidating() throws JAXBException
非整列化操作中に検証するようにUnmarshallerが設定されているかどうかを示します。注: getValidating()に対して、JAXPに合わせてisValidating()というメソッド名にしました。
- 定義:
isValidating
、インタフェース:Unmarshaller
- 戻り値:
- Unmarshallerが非整列化操作中に検証を行うように設定されている場合はtrue、それ以外の場合はfalse
- 例外:
JAXBException
- 検証フラグの取得中にエラーが発生した場合
-
setEventHandler
public void setEventHandler(ValidationEventHandler handler) throws JAXBException
アプリケーションが検証イベント・ハンドラを登録することができます。検証イベント・ハンドラは、いずれかの
unmarshal
メソッドを呼び出している途中で検証エラーが発生した場合、JAXBプロバイダによって呼び出されます。 非整列化メソッドを呼び出す前に、クライアント・アプリケーションが検証イベント・ハンドラを登録しなかった場合、すべての検証イベントは通知されることなく無視され、予想外の動作を引き起こす可能性があります。- 定義:
setEventHandler
、インタフェース:Unmarshaller
- パラメータ:
handler
- 検証イベント・ハンドラ- 例外:
JAXBException
- イベント・ハンドラの設定中にエラーが発生した場合
-
setValidating
public void setValidating(boolean validating) throws JAXBException
非整列化操作中にUnmarshallerが検証を行うかどうかを指定します。 デフォルトでは、Unmarshaller
は検証を行いません。このメソッドは、非整列化メソッドのいずれかを呼び出す前、または呼び出したあとにのみ、呼び出すことができます。
- 定義:
setValidating
、インタフェース:Unmarshaller
- パラメータ:
validating
- Unmarshallerが非整列化中に検証を行うようにする場合はtrue、それ以外の場合はfalse- 例外:
JAXBException
- 非整列化時の検証を有効または無効にしている途中でエラーが発生した場合
-
getEventHandler
public ValidationEventHandler getEventHandler() throws JAXBException
現在のイベント・ハンドラ、または、それが設定されていない場合はデフォルト・イベント・ハンドラを返します。- 定義:
getEventHandler
、インタフェース:Unmarshaller
- 戻り値:
- 現在の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をスローします。 プロバイダは追加プロパティを扱う必要がある場合、派生クラスでこのメソッドをオーバーライドするようにしてください。- 定義:
setProperty
、インタフェース:Unmarshaller
- パラメータ:
name
- 設定するプロパティの名前。 この値は、定数フィールドの1つかユーザーが指定した文字列を使用して指定できる。value
- 設定するプロパティの値- 例外:
PropertyException
- 指定したプロパティまたは値の処理中にエラーが発生した場合
-
getProperty
public Object getProperty(String name) throws PropertyException
必要なプロパティがないため、getPropertyメソッドのデフォルト実装は常に、PropertyExceptionをスローします。 プロバイダは追加プロパティを扱う必要がある場合、派生クラスでこのメソッドをオーバーライドするようにしてください。- 定義:
getProperty
、インタフェース:Unmarshaller
- パラメータ:
name
- 取得するプロパティの名前- 戻り値:
- 要求されたプロパティの値
- 例外:
PropertyException
- 指定したプロパティまたは値プロパティ名の取得中にエラーが発生した場合
-
unmarshal
public Object unmarshal(XMLEventReader reader) throws JAXBException
インタフェースからコピーされた説明:Unmarshaller
指定されたプル・パーサーからXMLデータを非整列化し、結果として得られるコンテンツ・ツリーを返します。このメソッドは、グローバル・ルートの非整列化メソッドです。
このメソッドは、パーサーでのSTART_DOCUMENTまたはSTART_ELEMENTイベントの発生を前提としています。 非整列化は、このstartイベントから、対応するendイベントまでの間に実行されます。 このメソッドが正常な結果を返す場合、
reader
は、endイベントの直後のトークンをポイントします。- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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イベントの直後のトークンをポイントします。- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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データを非整列化し、結果として得られるコンテンツ・ツリーを返します。宣言型による非整列化を実装します
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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パーサー」を参照してください
- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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イベントの直後のトークンをポイントします。- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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イベントの直後のトークンをポイントします。- 定義:
unmarshal
、インタフェース:Unmarshaller
- パラメータ:
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.3Schema
オブジェクトを指定します。 このメソッドにnullを渡すと、検証は無効になります。このメソッドは、非推奨の
setValidating(boolean)
APIに置き換わるものです。このプロパティは最初に
null
に設定されます。- 定義:
setSchema
、インタフェース:Unmarshaller
- パラメータ:
schema
- 非整列化操作の検証に使用するスキーマ・オブジェクト。検証を無効にする場合はnull
-
getSchema
public Schema getSchema()
インタフェースからコピーされた説明:Unmarshaller
非整列化時の検証に使用されるJAXP 1.3Schema
オブジェクトを取得します。 Unmarshallerにスキーマが設定されていない場合、このメソッドは、非整列化時に検証を実行しないことを示す、nullを返します。このメソッドは、非推奨の
Unmarshaller.isValidating()
APIに代わる機能であり、Schemaオブジェクトへのアクセスを提供します。 Unmarshallerが検証を有効にしているかどうかを判断するには、戻り値の型とnullを照らし合わせてチェックすれば簡単にわかります。boolean isValidating = u.getSchema()!=null;
- 定義:
getSchema
、インタフェース:Unmarshaller
- 戻り値:
- 非整列化時の検証を実行するために使用されるSchemaオブジェクト。存在しない場合はnull
-
setAdapter
public void setAdapter(XmlAdapter adapter)
インタフェースからコピーされた説明:Unmarshaller
XmlAdapter
の構成済みのインスタンスをこのアンマーシャラに関連付けます。これは
setAdapter(adapter.getClass(),adapter);
を呼び出す簡易メソッドです。- 定義:
setAdapter
、インタフェース:Unmarshaller
- 関連項目:
Unmarshaller.setAdapter(Class,XmlAdapter)
-
setAdapter
public <A extends XmlAdapter> void setAdapter(Class<A> type, A adapter)
インタフェースからコピーされた説明:Unmarshaller
XmlAdapter
の構成済みのインスタンスをこのアンマーシャラに関連付けます。すべてのUnmarshallerは、内部的に
Map
<Class
,XmlAdapter
>を保持しており、フィールドまたはメソッドがXmlJavaTypeAdapter
で注釈されたクラスを非整列化するために使用します。このメソッドにより、アプリケーションは
XmlAdapter
の構成済みのインスタンスを使用できます。 アダプタのインスタンスが与えられない場合、Unmarshallerはそのデフォルト・コンストラクタを呼び出してインスタンスを作成します。- 定義:
setAdapter
、インタフェース:Unmarshaller
- パラメータ:
type
- アダプタの型。XmlJavaTypeAdapter.value()
がこの型を参照する場合は、指定したインスタンスが使用される。adapter
- 使用するアダプタのインスタンス。 nullの場合、この型に対して現在設定されているアダプタの登録が解除される。
-
getAdapter
public <A extends XmlAdapter> A getAdapter(Class<A> type)
インタフェースからコピーされた説明:Unmarshaller
指定した型に関連付けられているアダプタを取得します。 これは、Unmarshaller.setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter)
メソッドの逆の操作です。- 定義:
getAdapter
、インタフェース:Unmarshaller
-
setAttachmentUnmarshaller
public void setAttachmentUnmarshaller(AttachmentUnmarshaller au)
インタフェースからコピーされた説明:Unmarshaller
cid、コンテンツID URIを、添付として渡されたバイナリ・データに解決するコンテキストを関連付けます。
非整列化時の検証は、
Unmarshaller.setSchema(Schema)
を介して有効化され、UnmarshallerがXOP処理を実行する場合でもサポートする必要があります。- 定義:
setAttachmentUnmarshaller
、インタフェース:Unmarshaller
-
getAttachmentUnmarshaller
public AttachmentUnmarshaller getAttachmentUnmarshaller()
- 定義:
getAttachmentUnmarshaller
、インタフェース:Unmarshaller
-
setListener
public void setListener(Unmarshaller.Listener listener)
インタフェースからコピーされた説明:Unmarshaller
この
Unmarshaller
に非整列化イベント・コールバックUnmarshaller.Listener
を登録します。各UnmarshallerにListenerは1つだけです。 Listenerを設定すると、前に設定されていたListenerと置き換わります。 Listenerに
null
を設定することにより、現在のListenerの登録を解除できます。- 定義:
setListener
、インタフェース:Unmarshaller
- パラメータ:
listener
- このUnmarshaller
に非整列化イベント・コールバックを提供する
-
getListener
public Unmarshaller.Listener getListener()
インタフェースからコピーされた説明:Unmarshaller
この
Unmarshaller
に登録されたUnmarshaller.Listener
を返します。- 定義:
getListener
、インタフェース:Unmarshaller
- 戻り値:
- 登録されている
Unmarshaller.Listener
、またはこのUnmarshallerに登録されているListenerがない場合null
。
-
-