Vous pouvez vous connecter au serveur de catalogue, obtenir une instance ObjectGrid et utiliser l'API ObjectMap.
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 Services de catalogue.
et utilisez les valeurs dans la zonePour é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.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”);
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();
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");
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();