16.2.4　イベントリスナに関する留意事項

イベントが発生した場合，クラスタイベントリスナおよびノードイベントリスナは，EADSクライアントに追加した順序（addClusterEventListener()およびaddNodeEventListener()で追加した順序）で実行されます。

イベントリスナ内では，CacheManagerクラスの次のメソッドを呼び出さないでください。

• create()

• destroy()

イベントリスナのtoString()はメッセージログに使用します。オーバーライドする場合は，次の点に注意してください。

• インスタンスを識別できる文字列を返却すること。

• 改行を含まない文字列を返却すること。

ClusterEventContextと，そこから取得できるオブジェクトの有効範囲は，ClusterEventListenerインタフェースのメソッドの中だけです。これらのオブジェクトを，メソッドの範囲外で参照した場合，動作は保証されません。

NodeEventContextと，そこから取得できるオブジェクトの有効範囲は，NodeEventListenerインタフェースのメソッドの中だけです。これらのオブジェクトを，メソッドの範囲外で参照した場合，動作は保証されません。

イベントリスナ内には，EADSクライアントの正常な処理に影響を及ぼす処理（例えば，リソースを大量に消費する処理）を実装しないでください。

同一EADSクライアント内のすべてのイベントリスナは，1つのスレッドから呼び出されて動作します。イベントリスナの動作中は，EADSサーバから受信したデータの保持用にメモリを占有します。そのため，イベントリスナ内には，長時間動作する処理を実装しないでください。

EADSサーバが初期化状態（initialized）以降の状態の場合に，EADSサーバからEADSクライアントにイベントが通知されます。ただし，EADSサーバとのコネクションの再接続に成功した場合は，EADSサーバの状態に関係なく，そのEADSサーバがまだ通知していないイベントが通知されます。

EADSクライアントがクラスタ内のどのEADSサーバとも通信できなかった場合は，イベントが通知されません。ただし，EADSクライアントはEADSサーバとのコネクションの再接続を繰り返すため，再接続に成功すると，そのあとでイベントが通知されます。

半数以上のEADSサーバが縮退している場合，イベントが通知されないことがあります。

EADSクライアントとEADSサーバ間のコネクションで，切断と再接続を繰り返した場合や，通信が遅延している場合には，イベントの通知が遅延します。

EADSクライアントとEADSサーバ間のコネクションが切断している間に，複数のEADSサーバが縮退した場合，EADSサーバのイベント再送時間（サーバ定義のeads.server.eventListener.notify.retry.timeoutパラメタの指定値）を過ぎて再送用のデータが破棄されると，イベントを通知する順序が逆転するおそれがあります。

EADSクライアントとEADSサーバ間のコネクションが切断している間に，あるEADSサーバが縮退後に復旧した場合，EADSサーバのイベント再送時間（サーバ定義のeads.server.eventListener.notify.retry.timeoutパラメタの指定値）を過ぎて再送用のデータが破棄されると，何もイベントが通知されないおそれがあります。

同じプロセス内で，EADSクライアントを終了（CacheManagerクラスのdestroy()）したあとにEADSクライアントを開始（CacheManagerクラスのcreate()）した場合は，すでに終了したEADSクライアントの再送用のデータは破棄されています。そのため，EADSクライアントを開始したあとのイベントだけが通知されます。

EADSサーバの処理は，EADSクライアントとの通信路の状態とは関係なく進みます。そのため，EADSクライアントへのイベントの通知が完了していなくても，クラスタの終了（eztool stop）やEADSサーバの縮退などの処理は完了します。