com.novell.nds.dirxml.driver

Class DelimitedText

java.lang.Object

com.novell.nds.dirxml.driver.DelimitedText

public class DelimitedText
extends java.lang.Object

Class for representing a delimited text file as XML.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String[]	columnNames Delimited text column names.
static char	FIELD_DELIMITER_COMMA Standard comma (',') delimiter.
static char	FIELD_DELIMITER_DEFAULT Default field delimiter (FIELD_DELIMITER_COMMA).
static char	FIELD_DELIMITER_TAB Standard tab ('\t') delimiter.
static java.lang.String	FIELD_ELEMENT Delimited text XML field-name element.
static java.lang.String	FIELD_NAME_ATTR Delimited text XML field element name attribute.
static java.lang.String	FIELD_NAME_ELEMENT Delimited text XML field element.
static char	FIELD_QUOTE Quote character ('"').
protected char	fieldDelimiter Delimited text field delimiter character.
protected boolean	hasHeaderRow Delimited text header row indicator.
static java.lang.String	HEADER_ELEMENT Delimited text XML header element.
static java.lang.String	RECORD_ELEMENT Delimited text XML record element
static java.lang.String	ROOT_ELEMENT Delimited text XML root element.

Constructor Summary

Constructors

Constructor and Description
DelimitedText() Construct a DelimitedText instance with defaults.
DelimitedText(char inFieldDelimiter) Construct a DelimitedText instance with a custom field delimiter character.
DelimitedText(char inFieldDelimiter, boolean inHasHeaderRow) Construct a DelimitedText instance with a custom field delimiter character.
DelimitedText(char inFieldDelimiter, java.lang.String[] inColumnNames) Construct a DelimitedText instance with a custom field delimiter character.

Method Summary

Modifier and Type	Method and Description
void	convertFromXML(org.w3c.dom.Document doc, java.io.BufferedWriter output) Convert XML to delimited text.
void	convertFromXML(org.w3c.dom.Document doc, java.io.OutputStream output) Convert XML to delimited text.
void	convertFromXML(org.w3c.dom.Document doc, java.lang.String fileName) Convert XML to delimited text.
void	convertFromXML(org.w3c.dom.Document doc, java.io.Writer output) Convert XML to delimited text.
org.w3c.dom.Document	convertToXML(java.io.BufferedReader input) Convert delimited text to XML.
org.w3c.dom.Document	convertToXML(java.io.InputStream input) Convert delimited text to XML.
org.w3c.dom.Document	convertToXML(java.io.Reader input) Convert delimited text to XML.
org.w3c.dom.Document	convertToXML(java.lang.String fileName) Convert delimited text to XML.
protected java.lang.String	quoteIfNeeded(java.lang.String string) Quote a delimited text field of it contains special characters.
protected java.lang.String[]	readRecord(java.io.BufferedReader input) Read a delimited text record.
protected void	writeField(org.w3c.dom.Element field, java.io.BufferedWriter output) Write a delimited text field.
protected void	writeRecord(org.w3c.dom.Element record, java.io.BufferedWriter output) Write a delimited text record.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FIELD_DELIMITER_COMMA

public static final char FIELD_DELIMITER_COMMA

Standard comma (',') delimiter.

See Also:

Constant Field Values

FIELD_DELIMITER_TAB

public static final char FIELD_DELIMITER_TAB

Standard tab ('\t') delimiter.

See Also:

Constant Field Values

FIELD_DELIMITER_DEFAULT

public static final char FIELD_DELIMITER_DEFAULT

Default field delimiter (FIELD_DELIMITER_COMMA).

See Also:

Constant Field Values

FIELD_QUOTE

public static final char FIELD_QUOTE

Quote character ('"').

See Also:

Constant Field Values

ROOT_ELEMENT

public static final java.lang.String ROOT_ELEMENT

Delimited text XML root element.

See Also:

Constant Field Values

HEADER_ELEMENT

public static final java.lang.String HEADER_ELEMENT

Delimited text XML header element.

See Also:

Constant Field Values

FIELD_NAME_ELEMENT

public static final java.lang.String FIELD_NAME_ELEMENT

Delimited text XML field element.

See Also:

Constant Field Values

RECORD_ELEMENT

public static final java.lang.String RECORD_ELEMENT

Delimited text XML record element

See Also:

Constant Field Values

FIELD_ELEMENT

public static final java.lang.String FIELD_ELEMENT

Delimited text XML field-name element.

See Also:

Constant Field Values

FIELD_NAME_ATTR

public static final java.lang.String FIELD_NAME_ATTR

Delimited text XML field element name attribute.

See Also:

Constant Field Values

fieldDelimiter

protected char fieldDelimiter

Delimited text field delimiter character.

columnNames

protected java.lang.String[] columnNames

Delimited text column names.

hasHeaderRow

protected boolean hasHeaderRow

Delimited text header row indicator.

Constructor Detail

DelimitedText

public DelimitedText()

Construct a DelimitedText instance with defaults.

DelimitedText

public DelimitedText(char inFieldDelimiter)

Construct a DelimitedText instance with a custom field delimiter character.

Parameters:

inFieldDelimiter - the field delimiter character

DelimitedText

public DelimitedText(char inFieldDelimiter,
                     boolean inHasHeaderRow)

Construct a DelimitedText instance with a custom field delimiter character.

Parameters:

inFieldDelimiter - the field delimiter character

inHasHeaderRow - true if input/output delimited text file has a header row

DelimitedText

public DelimitedText(char inFieldDelimiter,
                     java.lang.String[] inColumnNames)

Construct a DelimitedText instance with a custom field delimiter character.

Parameters:

inFieldDelimiter - the field delimiter character

inColumnNames - list of column names to use on input

Method Detail

convertToXML

public org.w3c.dom.Document convertToXML(java.lang.String fileName)
                                  throws java.io.IOException,
                                         org.w3c.dom.DOMException

Convert delimited text to XML.

Parameters:

fileName - name of delimited text file

Throws:

java.io.IOException - thrown if an error reading the file occurs

org.w3c.dom.DOMException - thrown if an error constructing the XML representaton occurs

convertToXML

public org.w3c.dom.Document convertToXML(java.io.InputStream input)
                                  throws java.io.IOException,
                                         org.w3c.dom.DOMException

Convert delimited text to XML.

Parameters:

input - InputStream containing delimited text

Throws:

java.io.IOException - thrown if an error reading the file occurs

org.w3c.dom.DOMException - thrown if an error constructing the XML representaton occurs

convertToXML

public org.w3c.dom.Document convertToXML(java.io.Reader input)
                                  throws java.io.IOException,
                                         org.w3c.dom.DOMException

Convert delimited text to XML.

Parameters:

input - Reader containing delimited text

Throws:

java.io.IOException - thrown if an error reading the file occurs

org.w3c.dom.DOMException - thrown if an error constructing the XML representaton occurs

convertToXML

public org.w3c.dom.Document convertToXML(java.io.BufferedReader input)
                                  throws java.io.IOException,
                                         org.w3c.dom.DOMException

Convert delimited text to XML.

Parameters:

input - BufferedReader containing delimited text

Throws:

java.io.IOException - thrown if an error reading the file occurs

org.w3c.dom.DOMException - thrown if an error constructing the XML representaton occurs

readRecord

protected java.lang.String[] readRecord(java.io.BufferedReader input)
                                 throws java.io.IOException

Read a delimited text record.

Parameters:

input - BufferedReader positioned at beginning of delimited text record

Returns:

list of field values in record

Throws:

java.io.IOException - thrown if an error occurs reading from input.

convertFromXML

public void convertFromXML(org.w3c.dom.Document doc,
                           java.lang.String fileName)
                    throws java.io.IOException,
                           org.w3c.dom.DOMException

Convert XML to delimited text.

Parameters:

doc - DOM document to convert

fileName - name of output delimited text file

Throws:

java.io.IOException - thrown if an error occurs writing to the file

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

convertFromXML

public void convertFromXML(org.w3c.dom.Document doc,
                           java.io.OutputStream output)
                    throws java.io.IOException,
                           org.w3c.dom.DOMException

Convert XML to delimited text.

Parameters:

doc - DOM document to convert

output - delimited text OutputStream

Throws:

java.io.IOException - thrown if an error occurs writing to output

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

convertFromXML

public void convertFromXML(org.w3c.dom.Document doc,
                           java.io.Writer output)
                    throws java.io.IOException,
                           org.w3c.dom.DOMException

Convert XML to delimited text.

Parameters:

doc - DOM document to convert

output - delimited text Writer

Throws:

java.io.IOException - thrown if an error occurs writing to output

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

convertFromXML

public void convertFromXML(org.w3c.dom.Document doc,
                           java.io.BufferedWriter output)
                    throws java.io.IOException,
                           org.w3c.dom.DOMException

Convert XML to delimited text.

Parameters:

doc - DOM document to convert

output - delimited text BufferedWriter

Throws:

java.io.IOException - thrown if an error occurs writing to output

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

writeRecord

protected void writeRecord(org.w3c.dom.Element record,
                           java.io.BufferedWriter output)
                    throws java.io.IOException,
                           org.w3c.dom.DOMException

Write a delimited text record.

Parameters:

record - DOM record element

output - delimited text BufferedWriter

Throws:

java.io.IOException - thrown if an error occurs writing to output

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

writeField

protected void writeField(org.w3c.dom.Element field,
                          java.io.BufferedWriter output)
                   throws java.io.IOException,
                          org.w3c.dom.DOMException

Write a delimited text field.

Parameters:

field - DOM field element

output - delimited text BufferedWriter

Throws:

java.io.IOException - thrown if an error occurs writing to output

org.w3c.dom.DOMException - thrown if an error occurs accessing the XML

quoteIfNeeded

protected java.lang.String quoteIfNeeded(java.lang.String string)

Quote a delimited text field of it contains special characters.

Parameters:

string - value to quote

Returns:

quoted string if quoting needed, original string otherwise