La méthode match permet de faire correspondre les fenêtres et de les uniformiser. Elle fait correspondre et uniformise les enregistrements, en renvoyant une structure en lecture seule contenant un tableau d'enregistrements correspondants.
Pour utiliser les données renvoyées par la méthode match, utilisez les méthodes disponibles dans les classes suivantes :
-
MatchResults permet d'accéder aux données au niveau de la structure (par exemple, la méthode size renvoie le nombre d'enregistrements dans la structure).
-
MatchRecord permet d'accéder aux données au niveau des champs (par exemple, la méthode size renvoie le nombre de champs dans chaque enregistrement). Utilisez la méthode getString avec l'entrée index pour accéder à des champs individuels.
Syntaxe
public MatchResults Match(int handle,
String returnFieldNames[],
int retCode[])Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
handle |
entier |
Entrée |
–– |
Handle vers une instance du serveur du programme de correspondance Director. |
|
returnFieldNames |
chaîne |
Entrée |
|
Tableau de chaînes Java de noms de champs DDL. |
|
MatchResults |
|
out |
|
Un objet MatchResults contenant le résultat des enregistrements renvoyés par le programme de correspondance. |
|
retCode |
entier |
Sortie |
|
Tableau des codes d'erreur. |
Valeurs renvoyées
Reportez-vous à la section Valeurs renvoyées.
Exemple
String[] fieldNames = {
"FirstName",
"LastName",
"MiddleName",
"HouseNo",
"StreetAddress",
"City",
"State",
"PostalCode",
"Country"
};
String[] DataValues1 = {
"JOHN",
"SMITH",
"D",
"25",
"Linnell cir",
"Billerica",
"MA",
"01821",
"US"
};
String[] DataValues2 = {
"JOHN",
"JONES",
"DAVID",
"164",
"Lexington rd",
"Billerica",
"MA",
"01821",
"US"
};
String[] DataValues3 = {
"J",
"SMITH",
"D",
"25",
"Linnell cir",
"Billerica",
"MA",
"01821",
"US"
};
int maxOut;
int fieldCount = 0;
// Misc stuff
int i;
MatchResults results = null;
String key;
testClient.clearWindow(handle, retCode);
System.out.println("open a matcher");
key = "JOHN1";
testClient.addToMatchWindow(handle, fieldNames, DataValues1, key, retCode);
key = "JOHN2";
testClient.addToMatchWindow(handle, fieldNames, DataValues2, key, retCode);
key = "JOHN3";
testClient.addToMatchWindow(handle, fieldNames, DataValues3, key, retCode);
results = testClient.match(handle, matchFields, retCode);