Plug-in MapEventListener

Un plug-in MapEventListener proporciona notificaciones de devolución de llamada y cambios significativos de estado de memoria caché que se producen para un objeto BackingMap: cuando una correlación ha terminado la precarga o cuando se desaloja una entrada de la correlación. Un determinado plug-in MapEventListener es una clase personalizada que se escribe implementando la interfaz MapEventListener.

Convenios del plug-in MapEventListener

Cuando desarrolle un plug-in MapEventListener, debe seguir los convenios comunes de plug-in. Para obtener más información sobre los convenios de plug-in, consulteVisión general de los plug-ins. Para otros tipos de plug-ins de escuchas, consulte Plug-ins para proporcionar escuchas de sucesos.

Después de escribir una implementación de MapEventListener, puede conectarse a éste en la configuración de BackingMap a través de programa o con una configuración de XML.

Grabar una implementación de MapEventListener

La aplicación puede incluir una implementación del plug-in MapEventListener. El plug-in debe implementar la interfaz MapEventListener para recibir sucesos significativos sobre una correlación. Los sucesos se envían al plug-in MapEventListener cuando una entrada se desaloja de la correlación y cuando finaliza la precarga de una correlación.

Conexión a través de programa de una implementación de MapEventListener

El nombre de clase para la clase personalizada MapEventListener es com.company.org.MyMapEventListener. Esta clase implementa la interfaz MapEventListener. El siguiente fragmento de código crea el objetoMapEventListener personalizado y lo añade a un objeto BackingMap:
ObjectGridManager objectGridManager =
	ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = objectGridManager.createObjectGrid("myGrid", false);
BackingMap myMap = myGrid.defineMap("myMap");
MyMapEventListener myListener = new MyMapEventListener();
myMap.addMapEventListener(myListener);

Conectar una implementación de MapEventListener utilizando XML

Se puede configurar una implementación de MapEventListner utilizando el XML. El siguiente XML debe aparecer en el archivo 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>
Proporcionar este archivo a la instancia de ObjectGridManager facilita la creación de esta configuración. El siguiente fragmento de código muestra cómo crear una instancia de ObjectGrid utilizando este archivo XML. La instancia de ObjectGrid recién creada tiene un MapEventListener establecido en myMap BackingMap.
ObjectGridManager objectGridManager =
	ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = 
	objectGridManager.createObjectGrid("myGrid", new URL("file:etc/test/myGrid.xml"), 
		true, false);