Ecriture du plug-in ObjectGridPlugin

Un plug-in ObjectGridPlugin est une interface intégrée mixte que vous pouvez utiliser pour fournir des événements de gestion de cycle de vie étendu à tous les autres plug-in ObjectGrid .

Pourquoi et quand exécuter cette tâche

Un plug-in ObjectGrid qui implémente le plug-in ObjectGridPlugin reçoit le jeu étendu des événements de cycle de vie, et peut fournir davantage de contrôle, que vous pouvez utiliser pour configurer ou supprimer des ressources. Dans un conteneur de grille de données partitionnées, il existera une instance ObjectGrid (le plug-in propriétaire) pour chaque partition gérée par le conteneur.Lorsque des partitions individuelles sont supprimées, les ressources utilisées par l'instance ObjectGrid doivent être supprimées également. Par conséquent, vous devrez peut-être fermer ou terminer une ressource, telle qu'un fichier de configuration ouvert ou une unité d'exécution qui est gérée par un plug-in, lorsque la partition propriétaire de cette ressource est supprimée.

L'interface ObjectGridPlugin fournit les méthodes pour définir ou modifier l'état du plug-in, ainsi que des méthodes pour analyser l'état actuel du plug-in. Toutes les méthodes doivent être correctement implémentées, et l'environnement d'exécution WebSphere eXtreme Scale vérifie le comportement de la méthode dans certains cas. Par exemple, après l'appel de la méthode initialize() , l'environnement d'exécution eXtreme Scale appelle la méthode isInitialized() pour s'assurer que la méthode a terminé l'initialisation appropriée.

Procédure

  1. Implémentez l'interface ObjectGridPlugin afin que le plug-in ObjectGridPlugin reçoive des notifications sur les événements eXtreme Scale importants. Il existe trois catégories principales de méthodes :
    Méthodes de propriété Fonction
    setObjectGrid() Appelée pour indiquer l'instance ObjectGrid pour laquelle le plug-in est utilisé.
    getObjectGrid() Appelée pour obtenir ou confirmer l'instance ObjectGrid pour laquelle le plug-in est utilisé.
    Méthodes d'initialisation Fonction
    initialize() Appelée pour initialiser le plug-in ObjectGridPlugin.
    isInitialized() Appelée pour obtenir ou confirmer l'initialisation du plug-in.
    Méthodes de destruction Fonction
    destroy() Appelée pour détruire le plug-in ObjectGridPlugin.
    isDestroyed() Appelée pour obtenir ou confirmer la destruction du plug-in.

    Voir la doculentation d'API pour plus d'informations sur ces interfaces.

  2. Configurez un plug-in ObjectGridPlugin avec XML. Utilisez la classe com.company.org.MyObjectGridPluginTxCallback qui implémente l'interface TransactionCallback et l'interface ObjectGridPlugin.
    Dans l'exemple de code suivant, le rappel de transaction personnalisée, qui finalement recevra des événements de cycle de vie étendu, est généré et ajouté à un plug-in ObjectGrid.
    Important : L'interface TransactionCallback dispose déjà d'une méthode d'initialisation, une nouvelle méthode initialisation est ajoutée, ainsi que de la méthode destroy et d'autres méthodes ObjectGridPlugin. Chaque méthode est utilisée, et les méthodes d'initialisation exécutent une seule initialisation. Le code XML suivant crée une configuration qui utilise l'interface TransactionCallback étendue.

    Le texte suivant doit se trouver dans le fichier 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">
                <bean id="TransactionCallback"
                      className="com.company.org.MyObjectGridPluginTxCallback" />
                <backingMap name="Book"/>
            </objectGrid>
        </objectGrids>
    </objectGridConfig>

    Notez que les déclarations de bean précèdent les déclarations backingMap.

  3. Indiquez le fichier myGrid.xml au plug-in ObjectGridManager pour faciliter la création de cette configuration.