XML Convert 2.2

Invoking XML Convert

This page describes several ways to invoke XML Convert.

From the command line, you can invoke one of the following XML Convert applications:

  1. flat2xml, which converts a flat file into XML.
  2. xml2flat, which converts an XML document into a flat file.
  3. flat2flat, which converts a flat file from one format to another.
  4. flat2xt, which invokes XT to transform a flat file as if it was an XML document.

Your Java application can invoke XML Convert using one or more of the following classes:

  1. com.unidex.xflat.XmlConvert, which provides a simple API to the functions provided by the flat2xml, xml2flat and flat2flat applications.
  2. com.unidex.xflat.Sax2FlatFileParser, which is a SAX 2.0 parser that converts flat file data into a stream of SAX 2.0 document events. The com.unidex.xflat.SaxFlatFileParser class, which is deprecated but still available, is a SAX 1.0 parser that converts flat file data into a stream of SAX 1.0 document events.
  3. com.unidex.xflat.Sax2FlatFileBuilder, which is a SAX 2.0 content handler that converts a stream of SAX 2.0 document events into flat file data. The com.unidex.xflat.SaxFlatFileBuilder class, which is deprecated but still available, is a SAX 1.0 document handler that converts a stream of SAX 2.0 document events into flat file data.

Multi-threaded applications can invoke these classes under certain conditions, which are described in detail in the javadoc for the classes.

Please refer to the javadoc index for additional information about these classes.

Finally, you can invoke XML Convert from the following XSLT processors:

  1. Michael Kay's SAXON
    SAXON can use the XML Convert flat file parser to transform a non-XML source document into XML, HTML or text. SAXON can also invoke XML Convert, in order to write the result tree as a flat file, the format of which is described in an XFlat schema. For more information about invoking XML Convert from SAXON, please refer to the Invoking XML Convert from SAXON page. For more information about SAXON, please refer to the SAXON home page.
  2. James Clark's XT
    XT can invoke XML Convert as an XT output method, in order to write the result tree as a flat file, the format of which is described in an XFlat schema. Please note that XT does not fully support the XSLT 1.0 recommendation and that James Clark no longer supports XT. For more information about invoking XML Convert from XT, please refer to the Invoking XML Convert as an XT Output Method page. For more information about XT, please refer to James Clark's web site.