org.polarsys.capella.common.helpers.export.utils

Class CSVWriter

java.lang.Object

org.polarsys.capella.common.helpers.export.utils.CSVWriter

public class CSVWriter
extends java.lang.Object

CSV writer

Constructor Summary

Constructors

Constructor and Description
CSVWriter(java.io.OutputStream outputStream, char delimiter) Creates a CsvWriter object using a Writer to write data to.
CSVWriter(java.io.OutputStream outputStream, char delimiter, java.nio.charset.Charset charset) Creates a CsvWriter object using an OutputStream to write data to.
CSVWriter(java.lang.String fileName) Creates a CsvWriter object using a file as the data destination. Uses a comma as the column delimiter and ISO-8859-1 as the Charset.
CSVWriter(java.lang.String fileName, char delimiter, java.nio.charset.Charset charset) Creates a CsvWriter object using a file as the data destination.
CSVWriter(java.io.Writer outputStream, char delimiter) Creates a CsvWriter object using a Writer to write data to.

Method Summary

Modifier and Type	Method and Description
void	close() Closes and releases all related resources.
void	endRecord() Ends the current record by sending the record delimiter.
void	flush() Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.
char	getComment()
char	getDelimiter() Gets the character being used as the column delimiter.
int	getEscapeMode()
boolean	getForceQualifier() Whether fields will be surrounded by the text qualifier even if the qualifier is not necessarily needed to escape this field.
char	getRecordDelimiter()
char	getTextQualifier() Gets the character to use as a text qualifier in the data.
boolean	getUseTextQualifier() Whether text qualifiers will be used while writing data or not.
static java.lang.String	replace(java.lang.String original, java.lang.String pattern, java.lang.String replace) Utility method.
void	setComment(char comment)
void	setDelimiter(char delimiter) Sets the character to use as the column delimiter.
void	setEscapeMode(int escapeMode)
void	setForceQualifier(boolean forceQualifier) Use this to force all fields to be surrounded by the text qualifier even if the qualifier is not necessarily needed to escape this field.
void	setRecordDelimiter(char recordDelimiter) Sets the character to use as the record delimiter.
void	setTextQualifier(char textQualifier) Sets the character to use as a text qualifier in the data.
void	setUseTextQualifier(boolean useTextQualifier) Sets whether text qualifiers will be used while writing data or not.
void	write(java.lang.String content) Writes another column of data to this record. Does not preserve leading and trailing whitespace in this column of data.
void	write(java.lang.String content, boolean preserveSpaces) Writes another column of data to this record.
void	writeComment(java.lang.String commentText) Write a csv comment.
void	writeRecord(java.lang.String[] values) Writes a new record using the passed in array of values.
void	writeRecord(java.lang.String[] values, boolean preserveSpaces) Writes a new record using the passed in array of values.

Methods inherited from class java.lang.Object

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

Constructor Detail

CSVWriter

public CSVWriter(java.lang.String fileName,
                 char delimiter,
                 java.nio.charset.Charset charset)

Creates a CsvWriter object using a file as the data destination.

Parameters:

fileName - The path to the file to output the data.

delimiter - The character to use as the column delimiter.

charset - The Charset to use while writing the data.

CSVWriter

public CSVWriter(java.lang.String fileName)

Creates a CsvWriter object using a file as the data destination. Uses a comma as the column delimiter and ISO-8859-1 as the Charset.

Parameters:

fileName - The path to the file to output the data.

CSVWriter

public CSVWriter(java.io.Writer outputStream,
                 char delimiter)

Creates a CsvWriter object using a Writer to write data to.

Parameters:

outputStream - The stream to write the column delimited data to.

delimiter - The character to use as the column delimiter.

CSVWriter

public CSVWriter(java.io.OutputStream outputStream,
                 char delimiter)

Creates a CsvWriter object using a Writer to write data to.

Parameters:

outputStream - The stream to write the column delimited data to.

delimiter - The character to use as the column delimiter.

CSVWriter

public CSVWriter(java.io.OutputStream outputStream,
                 char delimiter,
                 java.nio.charset.Charset charset)

Creates a CsvWriter object using an OutputStream to write data to.

Parameters:

outputStream - The stream to write the column delimited data to.

delimiter - The character to use as the column delimiter.

charset - The Charset to use while writing the data.

Method Detail

getDelimiter

public char getDelimiter()

Gets the character being used as the column delimiter.

Returns:

The character being used as the column delimiter.

setDelimiter

public void setDelimiter(char delimiter)

Sets the character to use as the column delimiter.

Parameters:

delimiter - The character to use as the column delimiter.

getRecordDelimiter

public char getRecordDelimiter()

setRecordDelimiter

public void setRecordDelimiter(char recordDelimiter)

Sets the character to use as the record delimiter.

Parameters:

recordDelimiter - The character to use as the record delimiter. Default is combination of standard end of line characters for Windows, Unix, or Mac.

getTextQualifier

public char getTextQualifier()

Gets the character to use as a text qualifier in the data.

Returns:

The character to use as a text qualifier in the data.

setTextQualifier

public void setTextQualifier(char textQualifier)

Sets the character to use as a text qualifier in the data.

Parameters:

textQualifier - The character to use as a text qualifier in the data.

getUseTextQualifier

public boolean getUseTextQualifier()

Whether text qualifiers will be used while writing data or not.

Returns:

Whether text qualifiers will be used while writing data or not.

setUseTextQualifier

public void setUseTextQualifier(boolean useTextQualifier)

Sets whether text qualifiers will be used while writing data or not.

Parameters:

useTextQualifier - Whether to use a text qualifier while writing data or not.

getEscapeMode

public int getEscapeMode()

setEscapeMode

public void setEscapeMode(int escapeMode)

setComment

public void setComment(char comment)

getComment

public char getComment()

getForceQualifier

public boolean getForceQualifier()

Whether fields will be surrounded by the text qualifier even if the qualifier is not necessarily needed to escape this field.

Returns:

Whether fields will be forced to be qualified or not.

setForceQualifier

public void setForceQualifier(boolean forceQualifier)

Use this to force all fields to be surrounded by the text qualifier even if the qualifier is not necessarily needed to escape this field. Default is false.

Parameters:

forceQualifier - Whether to force the fields to be qualified or not.

write

public void write(java.lang.String content,
                  boolean preserveSpaces)
           throws java.io.IOException

Writes another column of data to this record.

Parameters:

content - The data for the new column.

preserveSpaces - Whether to preserve leading and trailing whitespace in this column of data.

Throws:

java.io.IOException

write

public void write(java.lang.String content)
           throws java.io.IOException

Writes another column of data to this record. Does not preserve leading and trailing whitespace in this column of data.

Parameters:

contentThe - data for the new column.

Throws:

java.io.IOException

writeComment

public void writeComment(java.lang.String commentText)
                  throws java.io.IOException

Write a csv comment.

Parameters:

commentText - the comment itself

Throws:

java.io.IOException

writeRecord

public void writeRecord(java.lang.String[] values,
                        boolean preserveSpaces)
                 throws java.io.IOException

Writes a new record using the passed in array of values.

Parameters:

values - Values to be written.

preserveSpaces - Whether to preserver leading and trailing spaces in columns while writing out to the record or not.

Throws:

java.io.IOException

writeRecord

public void writeRecord(java.lang.String[] values)
                 throws java.io.IOException

Writes a new record using the passed in array of values.

Parameters:

values - Values to be written.

Throws:

java.io.IOException

endRecord

public void endRecord()
               throws java.io.IOException

Ends the current record by sending the record delimiter.

Throws:

java.io.IOException

flush

public void flush()

Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

close

public void close()

Closes and releases all related resources.

replace

public static java.lang.String replace(java.lang.String original,
                                       java.lang.String pattern,
                                       java.lang.String replace)

Utility method.

Parameters:

original -

pattern -

replace -

Returns: