javax.xml.bind

クラスUnmarshaller.Listener

java.lang.Object

javax.xml.bind.Unmarshaller.Listener

含まれているインタフェース:

Unmarshaller

public abstract static class Unmarshaller.Listener
extends Object

Unmarshallerにこのクラスの実装のインスタンスを登録し、非整列化イベントを外部的に待機します。

このクラスは、XMLデータから非整列化される際のJAXBマップ・クラスのインスタンスの事前および事後処理を可能にします。XMLコンテンツがJAXBElementインスタンスに非整列化されるとき、または、複雑型定義を表現するJAXBマップ・クラスに非整列化されるとき、イベント・コールバックは呼び出されます。単純型定義を表すJavaデータ型のインスタンスに非整列化する場合、イベント・コールバックは呼び出されません。

外部リスナーは、非整列化イベント・コールバックを定義するための2つの異なるメカニズムの1つです。概要については、「非整列化イベント・コールバック」を参照してください。

(@link #setListener(Listener)} (@link #getListener()}

導入されたバージョン:

JAXB2.0

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Listener()

メソッドのサマリー

修飾子と型	メソッドと説明
void	afterUnmarshal(Object target, Object parent) XMLデータをtargetに非整列化したあとに呼び出されるコールバック・メソッド。
void	beforeUnmarshal(Object target, Object parent) targetに非整列化する前に呼び出されるコールバック・メソッド。

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

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

コンストラクタの詳細

Listener

public Listener()

メソッドの詳細

beforeUnmarshal

public void beforeUnmarshal(Object target,
                            Object parent)

targetに非整列化する前に呼び出されるコールバック・メソッド。

このメソッドは、targetが作成された直後、および、オブジェクトの非整列化が開始される直前に呼び出されます。targetのクラスがそれ自身のbeforeUnmarshalメソッドを定義している場合、このメソッドが呼び出される直前にクラス固有のコールバック・メソッドが呼び出されます。

パラメータ:

target - 非整列化実行前のnullでないJAXBマップ・クラス・インスタンス。

parent - 最終的にtargetを参照するJAXBマップ・クラス・インスタンス。targetがルート要素の場合はnull。

afterUnmarshal

public void afterUnmarshal(Object target,
                           Object parent)

XMLデータをtargetに非整列化したあとに呼び出されるコールバック・メソッド。

このメソッドは、すべてのプロパティ(IDREFを除く)がtargetに非整列化されたあと、targetがそれのparentオブジェクトに設定される前に呼び出されます。targetのクラスがそれ自身のafterUnmarshalメソッドを定義している場合、このメソッドが呼び出される直前にクラス固有のコールバック・メソッドが呼び出されます。

パラメータ:

target - 非整列化実行前のnullでないJAXBマップ・クラス・インスタンス。

parent - targetを参照するJAXBマップ・クラス・インスタンス。targetがルート要素の場合はnull。