La méthode openMatcher() initialise une session entre une application client et un serveur de programme de correspondance Director.
Lorsque la fonction openMatcher() est appelée, la taille maximale de la fenêtre est renvoyée par le serveur du programme de correspondance à TGenClient. Si un projet comporte plusieurs étapes d'éditeur de liens de relations et que chaque étape spécifie une taille de fenêtre maximale différente, le serveur du programme de correspondance renvoie la valeur la plus petite au client.
Pour plus d'informations sur la définition et la vérification de la taille maximale de fenêtre, reportez-vous à addToMatchWindow() et à setWindowSize().
Syntaxe
public void openMatcher(int handle, int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
handle |
entier |
Entrée |
–– |
Handle vers un serveur de programme de correspondance Director. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
Valeurs renvoyées
Reportez-vous à la section Valeurs renvoyées.
Exemple
TrilTGenClient testClient = new TrilTGenClient();
// Return code and handle
int[] retCode= new int[1];
int handle = 0;
// System and Server ID for attach()
char systemID = ‘G’;
String serverName = “RMatcher”;
// openMatcher() requires attach to server using attach()
handle = testClient.attach(systemID, serverName, retCode);
if (retCode[0] == 0) {
// Initialize session with matcher server using openMatcher()
testClient.openMatcher(handle, retCode);
if (retCode[0] == 0) {
// Perform relevant processing
}
// Close the matcher server
testClient.closeMatcher(handle, retCode);
// closeMatcher() requires release of server using release()
testClient.release(handle, retCode);
}