Connexion aux instances ObjectGrid distribuées à l'aide d'un programme

Vous pouvez vous connecter à un ObjectGrid réparti avec les points de contact de connexion pour le domaine de service de catalogue. Vous devez connaître le nom d'hôte et le port d'écoute de chaque serveur de catalogue dans le domaine de service de catalogue auquel vous souhaitez vous connecter.

Avant de commencer

Pourquoi et quand exécuter cette tâche

Lorsque l'exécution s'effectue dans une application Java EE, vous devez utiliser l'adaptateur de ressources eXtreme Scale. L'adaptateur de ressources permet à l'application de rechercher une connexion ObjectGrid dans l'interface JNDI (Java Naming Directory Interface) à l'aide d'une fabrique de connexions JCA (Java Connector Architecture), ce qui simplifie considérablement l'accès à la grille de données et permet l'intégration avec les transactions JTA (Java Transaction API). Pour plus d'informations, voir Utilisation de JCA pour connecter des applications transactionnelles à des clients eXtreme Scale.

Les méthodes ObjectGridManager.connect() se connectent à un domaine de service de catalogue à l'aide des points de contact de connexion fournis et renvoie un objet ClientClusterContext qui est utilisé pour extraire les instances ObjectGrid pour le domaine. Les points de contact de connexion sont des listes de combinaisons hôte/port délimitées par des virgules pour chaque serveur de catalogue dans le domaine de service de catalogue. Voici le format des points de contact du service de catalogue :
catalogServiceEndpoints ::= <catalogServiceEndpoint> [,<catalogServiceEndpoint>]
catalogServiceEndpoint  ::= <hostName> : <listenerPort>
hostName                ::= adresse IP ou nom d'hôte d'un service de catalogue.
listenerPort            ::= port d'écoute que le service de catalogue est configuré pour utiliser.

Une fois que vous êtes connecté au domaine de service de catalogue, utilisez la méthode ObjectGridManagerFactory.getObjectGrid(ClientClusterContext ccc, String objectGridName) pour extraire une instance de client ObjectGrid nommée. Cette instance ObjectGrid est un proxy pour la grille de données nommée et est en cache dans l'application client. L'instance ObjectGrid représente une connexion logique à la grille de données distante et est sécurisée pour les unités d'exécution. Toutes les connexions physiques sous-jacentes à la grille de données sont gérées automatiquement et peuvent tolérer des événements d'échec.

Les étapes de connexion varient selon que vous utilisez une configuration autonome ou WebSphere Application Server.

Procédure

Que faire ensuite

Si le domaine de service de catalogue est hébergé dans un gestionnaire de déploiement WebSphere Application Server, les clients extérieurs à la cellule, y compris les clients Java Platform, Enterprise Edition, doivent se connecter au service de catalogue à l'aide du nom d'hôte du gestionnaire de déploiement et du port d'amorçage IIOP. Lorsque le service de catalogue s'exécute dans des cellules WebSphere Application Server et que les clients sont exécutés hors des cellules, vous devez rechercher dans les pages de configuration des domaines eXtreme Scale, sur la console d'administration de WebSphere Application Server, les informations permettant de pointer un client sur le service de catalogue.