com.helger.commons.csv

Class CSVWriter

java.lang.Object

com.helger.commons.csv.CSVWriter

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class CSVWriter
extends Object
implements Closeable, Flushable

A very simple CSV writer released under a commercial-friendly license.

Author:

Glen Smith

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_LINE_END The default line delimiter to be used.
static boolean	DEFAULT_QUOTE_ALL
static char	NO_ESCAPE_CHARACTER The escape constant to use when you wish to suppress all escaping.
static char	NO_QUOTE_CHARACTER The quote constant to use when you wish to suppress all quoting.

Constructor Summary

Constructors

Constructor and Description
CSVWriter(Writer aWriter) Constructs CSVWriter with all default settings.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkError() Checks to see if the there has been an error in the printstream.
void	close() Close the underlying stream writer flushing any buffered content.
void	flush() Flush underlying stream to writer.
void	flushQuietly() flushes the writer without throwing any exceptions.
char	getEscapeChar()
protected StringBuilder	getEscapedText(String sNextElement) Processes all the characters in a line.
String	getLineEnd()
char	getQuoteChar()
char	getSeparatorChar()
CSVWriter	setEscapeChar(char cEscapeChar) Sets the character to use for escaping a separator or quote.
CSVWriter	setLineEnd(String sLineEnd) Set the line delimiting string.
CSVWriter	setQuoteChar(char cQuoteChar) Sets the character to use for quoted elements.
CSVWriter	setSeparatorChar(char cSeparator) Sets the delimiter to use for separating entries.
protected boolean	stringContainsSpecialCharacters(String sLine) checks to see if the line contains special characters.
void	writeAll(List<List<String>> aAllLines) Writes the entire list to a CSV file with quoting enabled.
void	writeAll(List<List<String>> aAllLines, boolean bApplyQuotesToAll) Writes the entire list to a CSV file.
void	writeNext(Iterable<String> aNextLine) Writes the next line to the file.
void	writeNext(Iterable<String> aNextLine, boolean bApplyQuotesToAll) Writes the next line to the file.
void	writeNext(Iterator<String> aNextLine, boolean bApplyQuotesToAll) Writes the next line to the file.
void	writeNext(String... aNextLine) Writes the next line to the file.
void	writeNext(String[] aNextLine, boolean bApplyQuotesToAll) Writes the next line to the file.
void	writeNext(String[] aNextLine, int nOfs, int nLength) Writes the next line to the file.
void	writeNext(String[] aNextLine, int nOfs, int nLength, boolean bApplyQuotesToAll) Writes the next line to the file.

Methods inherited from class java.lang.Object

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

Field Detail

NO_QUOTE_CHARACTER

public static final char NO_QUOTE_CHARACTER

The quote constant to use when you wish to suppress all quoting.

See Also:

Constant Field Values

NO_ESCAPE_CHARACTER

public static final char NO_ESCAPE_CHARACTER

The escape constant to use when you wish to suppress all escaping.

See Also:

Constant Field Values

DEFAULT_LINE_END

public static final String DEFAULT_LINE_END

The default line delimiter to be used.

See Also:

Constant Field Values

DEFAULT_QUOTE_ALL

public static final boolean DEFAULT_QUOTE_ALL

See Also:

Constant Field Values

Constructor Detail

CSVWriter

public CSVWriter(@Nonnull
         Writer aWriter)

Constructs CSVWriter with all default settings.

Parameters:

aWriter - the writer to an underlying CSV source. May not be null .

Method Detail

getSeparatorChar

public char getSeparatorChar()

Returns:

The default separator for this writer.

setSeparatorChar

@Nonnull
public CSVWriter setSeparatorChar(char cSeparator)

Sets the delimiter to use for separating entries.

Parameters:

cSeparator - the delimiter to use for separating entries

Returns:

this

getQuoteChar

public char getQuoteChar()

Returns:

The default quotation character for this writer.

setQuoteChar

@Nonnull
public CSVWriter setQuoteChar(char cQuoteChar)

Sets the character to use for quoted elements.

Parameters:

cQuoteChar - the character to use for quoted element.

Returns:

this

getEscapeChar

public char getEscapeChar()

Returns:

The default escape character for this writer.

setEscapeChar

@Nonnull
public CSVWriter setEscapeChar(char cEscapeChar)

Sets the character to use for escaping a separator or quote.

Parameters:

cEscapeChar - the character to use for escaping a separator or quote.

Returns:

this

getLineEnd

@Nonnull
@Nonempty
public String getLineEnd()

Returns:

the line delimiting string. Neither null nor empty.

setLineEnd

@Nonnull
public CSVWriter setLineEnd(@Nonnull@Nonempty
                           String sLineEnd)

Set the line delimiting string.

Parameters:

sLineEnd - The line end. May neither be null nor empty.

Returns:

this

writeAll

public void writeAll(@Nonnull
            List<List<String>> aAllLines,
            boolean bApplyQuotesToAll)

Writes the entire list to a CSV file.

Parameters:

aAllLines - a List of List of String, with each List of String representing a line of the file.

bApplyQuotesToAll - true if all values are to be quoted. false if quotes only to be applied to values which contain the separator, escape, quote or new line characters.

writeAll

public void writeAll(@Nonnull
            List<List<String>> aAllLines)

Writes the entire list to a CSV file with quoting enabled.

Parameters:

aAllLines - a List of List of String, with each List of String representing a line of the file.

writeNext

public void writeNext(@Nullable
             Iterator<String> aNextLine,
             boolean bApplyQuotesToAll)

Writes the next line to the file.

Parameters:

aNextLine - A collection of Strings where each entry represents a single cell.

bApplyQuotesToAll - true if all values are to be quoted. false applies quotes only to values which contain the separator, escape, quote or new line characters.

writeNext

public void writeNext(@Nullable
             Iterable<String> aNextLine,
             boolean bApplyQuotesToAll)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

bApplyQuotesToAll - true if all values are to be quoted. false applies quotes only to values which contain the separator, escape, quote or new line characters.

writeNext

public void writeNext(@Nullable
             Iterable<String> aNextLine)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

writeNext

public void writeNext(@Nullable
             String[] aNextLine,
             boolean bApplyQuotesToAll)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

bApplyQuotesToAll - true if all values are to be quoted. false applies quotes only to values which contain the separator, escape, quote or new line characters.

writeNext

public void writeNext(@Nullable
             String... aNextLine)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

writeNext

public void writeNext(@Nullable
             String[] aNextLine,
             @Nonnegative
             int nOfs,
             @Nonnegative
             int nLength,
             boolean bApplyQuotesToAll)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

nOfs - Array Offset. Must be ≥ 0.

nLength - Array Length. Must be ≥ 0.

bApplyQuotesToAll - true if all values are to be quoted. false applies quotes only to values which contain the separator, escape, quote or new line characters.

writeNext

public void writeNext(@Nullable
             String[] aNextLine,
             @Nonnegative
             int nOfs,
             @Nonnegative
             int nLength)

Writes the next line to the file.

Parameters:

aNextLine - a string array with each comma-separated element as a separate entry.

nOfs - Array Offset. Must be ≥ 0.

nLength - Array Length. Must be ≥ 0.

stringContainsSpecialCharacters

protected boolean stringContainsSpecialCharacters(@Nonnull
                                      String sLine)

checks to see if the line contains special characters.

Parameters:

sLine - - element of data to check for special characters.

Returns:

true if the line contains the quote, escape, separator, newline or return.

getEscapedText

@Nonnull
protected StringBuilder getEscapedText(@Nonnull
                                   String sNextElement)

Processes all the characters in a line.

Parameters:

sNextElement - element to process.

Returns:

a StringBuilder with the elements data.

flush

public void flush()
           throws IOException

Flush underlying stream to writer.

Specified by:

flush in interface Flushable

Throws:

IOException - if bad things happen

close

public void close()
           throws IOException

Close the underlying stream writer flushing any buffered content.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException - if bad things happen

checkError

public boolean checkError()

Checks to see if the there has been an error in the printstream.

Returns:

true if the print stream has encountered an error, either on the underlying output stream or during a format conversion.

flushQuietly

public void flushQuietly()

flushes the writer without throwing any exceptions.