Visite virtuelle d'application de grille de données simple

Vous pouvez vous connecter au serveur de catalogue, obtenir une instance ObjectGrid et utiliser l'API ObjectMap.

Avant de commencer

Vous devez créer une grille de données simple dans l'interface utilisateur. Pour plus d'informations, voir Création de grilles de données simples.

Visite virtuelle d'application de grille de données simple

  1. Connexion au service de catalogue en obtenant une instance ClientClusterContext

    Le serveur de catalogue que vous devez utiliser pour la connexion figure dans la page d'interface utilisateur de la grille de données simple que vous avez créée. Cliquez sur Grille de données > Grille de données simple > my_simple_data_grid et utilisez les valeurs dans la zone Services de catalogue.

    Pour établir la connexion au serveur de catalogues, utilisez la méthode connect de l'API ObjectGridManager. La méthode connect utilisée nécessite uniquement un noeud final de serveur de catalogue dans le format hostname:port. Vous pouvez indiquer plusieurs noeuds finaux de serveur de catalogue en séparant les valeurs hostname:port par une virgule. Le fragment de code suivant montre comment se connecter à un serveur de catalogue et obtenir une instance ClientClusterContext :

    ClientClusterContext ccc = ObjectGridManagerFactory.getObjectGridManager().connect("myXC10.myhost.com:2809", null, null);

    La méthode connect tente de se connecter à chaque dispositif de la liste jusqu'à ce qu'elle puisse établir une connexion en utilisant le basculement automatiquement si l'un des autres dispositifs ne répond pas.

    Si les connexions aux serveurs de catalogue aboutissent, la méthode connect retourne une instance ClientClusterContext. L'instance ClientClusterContext est requise pour obtenir l'ObjectGrid à partir de l'API ObjectGridManager.
  2. Obtenir une instance ObjectGrid

    Pour obtenir une instance ObjectGrid, utilisez la méthode getObjectGrid de l'API ObjectGridManager. La méthode getObjectGrid requiert l'instance ClientClusterContext et le nom de l'instance de grille de données. L'instance ClientClusterContext est obtenue pendant la connexion au serveur de catalogue. Le nom de l'instance de grille de données est le nom de la grille de données simple que vous avez créée dans l'interface utilisateur. Le fragment de code suivant montre comment obtenir la grille de données en appelant la méthode getObjectGrid de l'API ObjectGridManager.

    ObjectGrid grid = ObjectGridManagerFactory.getObjectGridManager().getObjectGrid(ccc, “my_simple_data_grid”);
  3. Obtenir une instance Session

    Vous pouvez obtenir une session de l'instance ObjectGrid obtenue. Une instance Session est indispensable pour obtenir l'instance ObjectMap et pour effectuer une démarcation de transaction. Le fragment de code suivant montre comment obtenir une instance Session en appelant la méthode getSession de l'API ObjectGrid.

    Session sess = grid.getSession();
  4. Obtenir une instance ObjectMap

    Après avoir obtenu une instance Session, vous pouvez obtenir une instance ObjectMap depuis une instance Session en appelant la méthode getMap de l'API Session. Le nom d'instance de mappe que vous envoyez à la méthode getMap porte le nom de la grille de données que vous avez créée dans l'interface utilisateur. Le fragment de code suivant montre comment obtenir ObjectMap en appelant la méthode getMap de l'API Session.

    ObjectMap map1 = sess.getMap("my_simple_data_grid");
  5. Utiliser les méthodes ObjectMap

    Une fois un ObjectMap obtenu, vous pouvez utiliser l'API ObjectMap. N'oubliez pas que l'interface ObjectMap est une mappe transactionnelle et qu'elle requiert une démarcation de transaction à l'aide des méthodes begin et commit de l'API Session. Faute de démarcation de transaction explicite, les opérations ObjectMap s'exécutent avec des transactions de validation automatique.

    Le fragment de code suivant montre comment utiliser l'API ObjectMap avec une transaction de validation automatique.

    map1.insert(key1, value1);

    La clé que vous utilisez peut avoir n'importe quel type Java existant, tel que java.lang.String ou Entier. Les valeurs peuvent correspondre à n'importe quel type d'objet sérialisable.

    Le fragment de code suivant montre comment utiliser l'API ObjectMap avec une démarcation de transaction explicite.

    sess.begin();
    map1.insert(key1, value1);
    sess.commit();