MapEventListener プラグイン

MapEventListener プラグインは、 マップがプリロードを終了したり、エントリーがマップから除去されたりしたときに、BackingMap オブジェクトに対して発生するコールバック通知および重要なキャッシュ状態変更を提供します。 特定の MapEventListener プラグインは、MapEventListener インターフェースを実装して作成するカスタム・クラスです。

MapEventListener プラグイン規則

MapEventListener プラグインを開発する際には、共通のプラグイン規則に従う必要があります。プラグイン規則について詳しくは、プラグインの概要を参照してください。 その他のタイプのリスナー・プラグインについては、イベント・リスナーの指定のためのプラグインを参照してください。

MapEventListener 実装を作成すると、プログラムで、あるいは、XML 構成を使用してそれを BackingMap 構成にプラグインできます。

MapEventListener 実装の作成

MapEventListener プラグインの実装は、アプリケーションに組み込むことができます。 このプラグインで、MapEventListener インターフェースを実装し、マップに関する重要なイベントを受信する必要があります。エントリーがマップから除去されたとき、およびマップのプリロードが完了したときに、イベントが MapEventListener プラグインに送られます。

MapEventListener 実装のプログラムによるプラグイン

カスタム MapEventListener のクラス名は、com.company.org.MyMapEventListener クラスです。このクラスは MapEventListener インターフェースを実装します。 以下のコード・スニペットは、カスタム MapEventListener オブジェクトを作成し、それを BackingMap オブジェクトに追加します。
ObjectGridManager objectGridManager =
	ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = objectGridManager.createObjectGrid("myGrid", false);
BackingMap myMap = myGrid.defineMap("myMap");
MyMapEventListener myListener = new MyMapEventListener();
myMap.addMapEventListener(myListener);

XML を使用した MapEventListener 実装のプラグイン

MapEventListner 実装は、XML を使用して構成できます。以下の XML は、myGrid.xml ファイルに存在しなければなりません。
<?xml version="1.0" encoding="UTF-8" ?>
<objectGridconfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://ibm.com/ws/objectgrid/config../objectGrid.xsd" 
	xmlns="http://ibm.com/ws/objectgrid/config">
    <objectGrids>
        <objectGrid name="myGrid">
            <backingMap name="myMap" pluginCollectionRef="myPlugins" />
        </objectGrid>
    </objectGrids>
    <backingMapPluginCollections>
        <backingMapPluginCollection id="myPlugins">
            <bean id="MapEventListener" className=
							"com.company.org.MyMapEventListener" />
        </backingMapPluginCollection>
    </backingMapPluginCollections>
</objectGridConfig>
このファイルを ObjectGridManager インスタンスに提供すると、この構成の作成が容易になります。以下のコード・スニペットは、この XML ファイルを使用して ObjectGrid インスタンスを作成する方法を示しています。新規に作成された ObjectGrid インスタンスにおいて、myMap BackingMap で MapEventListener が設定されます。
ObjectGridManager objectGridManager = 
	ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = 
	objectGridManager.createObjectGrid("myGrid", new URL("file:etc/test/myGrid.xml"), 
		true, false);