La méthode cleanseXML() envoie des données « sales » dans un document XML à un serveur de nettoyage et reçoit des données « propres » ou enrichies dans un document XML. Les données sont nettoyées conformément aux règles de gestion disponibles pour le serveur de nettoyage cible lors de son démarrage.
Avant d'appeler cette méthode, vous devez appeler la méthode attach() pour obtenir un handle vers le serveur de nettoyage requis.
Syntaxe
public void cleanseXML(int handle, java.lang.String rootTag, java.lang.String inputXML, java.lang.StringBuffer outputXML, int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
handle |
entier |
Entrant |
–– |
Handle vers un serveur de nettoyage Director. |
|
rootTag |
string[ ] |
Entrant |
n* |
Balise racine XML. |
|
inputXML |
string[ ] |
Entrant |
n* |
Chaîne XML contenant les données à nettoyer. |
|
outputXML |
string[ ] |
Sortant |
n* |
StringBuffer où le XML nettoyé est renvoyé. |
|
retCode |
int[ ] |
Sortant |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
n* indique la longueur maximale et varie en fonction du matériel et du système d'exploitation sur lequel le programme s'exécute.
Exemple
TrilTGenClient testClient = new TrilTGenClient(); int[] retCode= new int[1]; // Return code and handle int handle = 0; char systemID = 'G'; // System and Server ID for attach() String serverName = "Cleanser"; // Root Tag of XML document String rootTag = "CustomerData/PrimaryCustomer/Address"; // This is the input (dirty) XML document String inputXML = "<?xml version = '1.0' encoding = 'ISO-8859-1' standalone = 'no'?>" + "<CustomerData>" + "<REQUESTTYPE>Cleanse</REQUESTTYPE>" + "<PrimaryCustomer>" + "<Name>John Smith</Name>" + "<Address>" + "<StreetLine1>11 falk</StreetLine1>" + "<StreetLine2 />" + "<City>pompton lakes</City>" + "<State>NJ</State>" + "<Country>US</Country>" + "<ZipCode></ZipCode>" + "</Address>" + "</PrimaryCustomer>" + "</CustomerData> " // Attach is required before cleanseXML() handle = testClient.attach(systemID, serverName, retCode); if (retCode[0] == 0) { StringBuffer outputXML = new StringBuffer (""); testClient.cleanseXML(handle, rootTag, inputXML, outputXML, retCode); if (retCode[0] != 0) { System.out.println("cleanseXML method returned" + retCode[0]); } else { // Do something with cleansed data in outputXML } // Release cleansing server using release() testClient.release(handle, retCode); }