Plug-in MapEventListener

Um plug-in MapEventListener fornece notificações de retorno de chamada e mudanças de estado de cache significativas que ocorrem para um objeto BackingMap: quando um mapa termina o pré-carregamento ou quando uma entrada é despejada do mapa. Um plug-in MapEventListener específico é uma classe customizada que você grava implementando a interface MapEventListener.

Convenções de Plug-in do MapEventListener

Ao desenvolver um plug-in do MapEventListener, é necessário seguir convenções comuns do plug-in. Para obter mais informações sobre convenções de plug-in, consulte Visão Geral de Plug-ins. Para os outros tipos de plug-ins de listener, consulte Plug-ins para Fornecer Listeners de Eventos.

Depois de gravar uma implementação do MapEventListener, será possível conectá-la à configuração de BackingMap programaticamente ou com uma configuração XML.

Gravar uma Implementação do MapEventListener

Seu aplicativo pode incluir uma implementação do plug-in do MapEventListener. O plug-in deve implementar a interface MapEventListener para receber eventos significativos sobre um mapa. Os eventos são enviados para o plug-in do MapEventListener quando uma entrada é despejada do mapa e quando o pré-carregamento de um mapa é concluído.

Conexão Programática em uma Implementação do MapEventListener

O nome da classe para o MapEventListener customizado é a classe com.company.org.MyMapEventListener. Esta classe implementa a interface MapEventListener. O trecho de código a seguir cria o objeto MapEventListener customizado e o inclui em um 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 uma Implementação do MapEventListener Utilizando XML

Uma implementação do MapEventListner pode ser configurada utilizando XML. O XML a seguir deve estar no arquivo 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>
Fornecer este arquivo para a instância do ObjectGridManager facilita a criação desta configuração. O fragmento de código a seguir mostra como criar um ObjectGrid utilizando este arquivo XML. A instância ObjectGrid recém-criada tem um MapEventListener configurado no BackingMap myMap.
ObjectGridManager objectGridManager = 
	ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = 
	objectGridManager.createObjectGrid("myGrid", new URL("file:etc/test/myGrid.xml"), 
		true, false);