jp.littlesoft.data.event
インタフェース ChangeListener

すべてのスーパーインタフェース:

EventListener

public interface ChangeListener
extends EventListener

データ変更イベントリスナー。

Tableクラス、Paramsクラスなどのデータの内容が変更された際のイベントを受け取るためのインタフェースです。
このイベントを受け取るには、受け取り側クラスでChangeListenerインターフェースを実装し、 対象のデータオブジェクトaddChangeListenerで受け取り側オブジェクトを登録します。

データ項目の値が変更された場合は、当クラスのoldValue､newValueプロパティに変更される前後のそれぞれの値が設定されます。

バージョン:

1.3.0

作成者:

LittleSoft Corporation

関連項目:

Table, ChangeEvent

メソッドの概要

void	afterSetValue(ChangeEvent e) データオブジェクトのカラムに新しい値がセットされた直後のイベント。
void	beforeSetValue(ChangeEvent e) データオブジェクトのカラムに新しい値がセットされる直前のイベント。
void	onActivate(ChangeEvent e) データオブジェクトの活性化が完了した際のイベント。
void	onColumnSetup(ChangeEvent e) データオブジェクトのカラム構造が決定した際のイベント。
void	onPassivate(ChangeEvent e) データオブジェクトが非活性化が完了したイベント。

メソッドの詳細

onActivate

void onActivate(ChangeEvent e)
                throws Exception

データオブジェクトの活性化が完了した際のイベント。

このイベントは表示コンポーネントの初期化に使用します。

パラメータ:

e - ChangeEvent

例外:

Exception - 例外

onColumnSetup

void onColumnSetup(ChangeEvent e)

データオブジェクトのカラム構造が決定した際のイベント。

このイベントは各カラムオブジェクトの属性設定で使用します。

パラメータ:

e - ChangeEvent

onPassivate

void onPassivate(ChangeEvent e)

データオブジェクトが非活性化が完了したイベント。

パラメータ:

e - ChangeEvent

beforeSetValue

void beforeSetValue(ChangeEvent e)
                    throws Exception

データオブジェクトのカラムに新しい値がセットされる直前のイベント。

このイベントはカラム値に対する特別なチェック処理等で利用できます。
ChangeEventのNewValueを検証し、必要であれば値の変更を行う事ができます。
また、このメソッド内でExceptionを送出するとカラムの変更を強制的にキャンセルする事ができます。

パラメータ:

e - ChangeEvent

例外:

Exception - 例外

afterSetValue

void afterSetValue(ChangeEvent e)

データオブジェクトのカラムに新しい値がセットされた直後のイベント。

パラメータ:

e - ChangeEvent