cleanseXMLEx() - trillium_quality - Latest

Trillium Director SDK Reference

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Quality
Version
Latest
ft:locale
en-US
Product name
Trillium Quality
ft:title
Trillium Director SDK Reference
Copyright
2024
First publish date
2008
ft:lastEdition
2024-10-18
ft:lastPublication
2024-10-18T15:24:49.097000

The cleanseXMLEx() method combines the attach(), cleanseXML() and release() methods into a single method. Use this method in a real-time environment when you want to process only one record at a time. This method performs the attach and release of a cleansing server and therefore, relieves the developer from explicitly calling the attach() and release() methods.

Note: Use of this method requires a special configuration file to define the format of the XML document. Use the TRILLCONFIG environment variable to point to this configuration file.

Syntax

public void cleanseXMLEx(char systemID,
                        java.lang.String serverName,
                        java.lang.String rootTag,
                        java.lang.String inputXML,
                        java.lang.StringBuffer outputXML,
                        int retCode[]);

Parameters

Name

Type

Use

Length

Description

systemID

int

In

1

System ID of the requested server.

serverName

string

In

1-8

Server name of the requested server.

rootTag

string[ ]

In

n*

XML root tag.

inputXML   

string[ ]

In

n*

XML string containing the data to be cleansed.

outputXML

string[ ]

Out

n*

StringBuffer where the cleansed XML is returned.

retCode

int[ ]

Out

4

Error code that indicates status of method call.

n* indicates the platform-specific length which varies depending on the hardware and operating system on which the program runs.

Example

TrTrilTGenClient testClient = new TrilTGenClient();

// Return code
int[] retCode= new int[1];

// System and Server ID for attach()
char systemID = 'G';
String serverName = "Cleanser";

// Root Tag of XML doc
String rootTag = "CustomerData/PrimaryCustomer/Address";

// This is the input (dirty) XML doc

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> "

// Allocate StringBuffer to receive clean XML
StringBuffer outputXML = new StringBuffer ("");

testClient.cleanseXMLEx(systemId, server Name,rootTag, inputXML, outputXML,
retCode);
  if (retCode[0] != 0) {
  System.out.println("cleanseXMLEx method returned" + retCode[0]);
  } else {
// Do something with cleansed data that is in outputXML
}