La méthode cleanse() envoie des données « sales » à un serveur de nettoyage Director et reçoit des données « propres » ou enrichies. Les données sont nettoyées selon les règles de gestion disponibles pour le serveur de nettoyage cible lors de son démarrage.
Avant d'appeler la méthode cleanse(), vous devez utiliser la méthode attach() pour obtenir un handle vers le serveur de nettoyage.
Syntaxe
public void cleanse(int handle,
java.lang.String trillName[],
java.lang.String inputData[],
java.lang.String updtRule[],
java.lang.String outputData[],
int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
handle |
entier |
Entrée |
–– |
Handle d'une instance de serveur de nettoyage Director. |
|
trillName |
string[ ] |
Entrée |
n* |
Tableau de chaînes contenant les noms des champs des données à nettoyer. Ces noms de champ correspondent aux noms des champs dans les fichiers DDL. |
|
inputData |
string[ ] |
Entrée |
n* |
Tableau de chaînes de caractères contenant des données à nettoyer. |
|
updtRule |
string[ ] |
Entrée |
n* |
Tableau de chaînes contenant les règles de mise à jour pour les données renvoyées. |
|
outputData |
string[ ] |
Sortie |
n* |
Tableau de chaînes contenant les données nettoyées retournées. Doit être pré-alloué par l'appelant avec le nombre correct d'éléments. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
n* indique que la longueur est spécifique à la plateforme, c'est-à-dire qu'elle dépend de la plateforme sur laquelle le programme s'exécute.
Valeurs renvoyées
Reportez-vous à la section Valeurs renvoyées.
Exemple
import java.util.*;
import java.io.*;
import java.lang.*;
import trillium.director.*;
class CleanseMulti {
public static void main(String[] args) {
TrilTGenClient testClient = new TrilTGenClient();
// Return code and handle
int[] retCode= new int[1];
int handle = 0;
// Miscellaneous processing
int i;
int j;
int maxOut;
// System and Server ID for attach()
char systemID = 'G';
String serverName = "Cleanser";
// Data for Cleanser
String[] trillName = {"LINE_01",
"LINE_03",
"LINE_09",
"FirstName",
"HouseNo",
"StreetAddress",
"City",
"State",
"PostalCode",
"Country"};
String[] updtRule = {"",
"",
"",
"PR_GIVEN_NAME1_RECODED_01",
"dr_house_number1",
"dr_street_name",
"dr_city_name",
"dr_region_name",
"dr_postal_code",
"WINDOW_KEY_01",
"WINDOW_KEY_03"};
String[] inputData = {"john smith",
"164 lexington",
"01821"};
// Create array that will contain the returned cleansed data
// Must be initalized large enough to contain all returned elements
String[] outputData = new String[12];
// Attach to a cleansing server once
handle = testClient.attach(systemID, serverName, retCode);
if (retCode[0] == 0) { // If we got a cleansing server
// Loop 10 times to cleanse the same record
for (i = 0; i < 10; i++) {
testClient.cleanse(handle, trillName, inputData, updtRule,
outputData, retCode);
if (retCode[0] != 0) {
System.out.println("cleanse method returned" +
retCode[0]);
}
maxOut = outputData.length;// Print the cleansed data
if (maxOut > 0) {
for (j = 0; j < maxOut; j++) {
System.out.println(outputData[j]);
}
}
}
// When done, release cleansing server
testClient.release(handle, retCode);
}
}