La méthode attach() permet de se connecter à une instance de Director et d'établir un chemin de communication vers un serveur de nettoyage ou de correspondance Director.
La valeur renvoyée est le chemin de communication (handle) vers le serveur. Le chemin de communication doit être utilisé dans les appels API ultérieurs pour échanger des données avec le serveur. (Si la valeur renvoyée est 0, voir « Valeurs renvoyées » ci-dessous.)
Syntaxe
public int attach(char systemID,
java.lang.String serverName,
int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
systemID |
caractère |
Entrée |
1 |
ID système du serveur demandé. |
|
serverName |
chaîne |
Entrée |
1-8 |
Nom du serveur demandé. |
|
retCode |
int[] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
Valeurs renvoyées
La valeur retournée 0 indique que la tentative de connexion à un serveur Director a échoué, et le code retCode indique l'erreur spécifique. Pour la description du contenu du paramètre retCode, reportez-vous à Valeurs renvoyées.
Exemple
import java.util.*;
import java.io.*;
import java.lang.*;
import trillium.director.*;
class TestJNIClient
{
public static void main(String[] args)
{
TrilTGenClient testClient = new TrilTGenClient();
int handle = 0; // System and Server ID for attach()
char systemID = 'G';
String serverName = “Cleanser”; // Attach to G Cleanser
handle = testClient.attach(systemID, serverName, retCode);
//
// Cleanse or match requests not shown for this example
//
if (retCode[0] == 0) { testClient.release(handle, retCode);
}
}