Les connexions CARMA sont établies lors de la création du noeud racine
d'une hiérarchie CARMA.
A propos de cette tâche
Le noeud racine d'une hiérarchie CARMA
est un objet
CARMA
qui doit être configuré pour utiliser un service de transport CARMA lors de la création.
Pour créer un noeud racine pour une hiérarchie CARMA et configurer son service de transport CARMA,
procédez comme suit :
Procédure
- Utilisez la classe fabrique com.ibm.carma.CARMASystemFactory
pour créer un objet CARMA avec la méthode getInstance
comme illustré dans l'exemple de code suivant :
String identifier = "ConnectionIdentifier";
Map connectionProperties = new TreeMap();
// insert your code to configure the connection properties here
CARMA carma = CARMASystemFactory.getInstance().getCARMAInstance(identifier, connectionProperties);
La chaîne d'identificateur doit être unique pour votre hiérarchie CARMA.
Actuellement, le seul service de transport valide est le service de transport RSE,
qui est utilisé par défaut (si vous utilisez l'autre appel de méthode qui nécessite
de spécifier un ID dorsal, vous pouvez sélectionner le service de transport RSE
en transmettant une valeur d'ID de "com.ibm.carma.client.rse.datastore").
Les propriétés de connexion mappent des paires clé-valeur de magasin
pour les options de configuration de transport. Si les paramètres requis
pour le transport que vous utilisez ne sont pas spécifiés dans la mappe,
la méthode getCARMAInstance émet une exception
CARMAException. Le service de transport RSE requiert
de spécifier une valeur pour la clé "aliasName" dans la mappe
des propriétés de connexion. Pour la valeur de la clé "aliasName",
indiquez un nom que la connexion RSE utilisera pour communiquer
avec l'hôte CARMA.
- Stockez une référence à votre hiérarchie CARMA pour l'extraction
ultérieure dans le registre CARMA :
CarmaRegistry.getRegistry().addCarma(carma);
L'objet CarmaRegistry
singleton est utilisé par un objet CARMABrowser
pour gérer la liste des connexions CARMA connues. Des événements sont envoyés à des écouteurs enregistrés
lorsque des objets sont ajoutés ou retirés de la hiérarchie CARMA.
Vous pouvez extraire une hiérarchie CARMA du registre CARMA en transmettant
son identificateur dans la méthode getCARMA du registre CARMA.
Que faire ensuite
Vous pouvez à présent vous connecter à l'hôte CARMA de votre objet
CARMA
à l'aide de la méthode
connect.