Package cdc.util.csv

Class CsvWriter

java.lang.Object

cdc.util.csv.CsvWriter

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

public class CsvWriter
extends java.lang.Object
implements java.io.Flushable, java.io.Closeable

Utility used to write CSV files.

Cell separator can be controlled.
End of line can be controlled.
Escaping end multi line cells are supported.

Author:

Damien Carbonne

Field Summary

Fields

Modifier and Type	Field	Description
static char	DEFAULT_SEPARATOR	The default separator that should be used.

Constructor Summary

Constructors

Constructor	Description
CsvWriter(java.io.File file)
CsvWriter(java.io.File file, boolean append)
CsvWriter(java.io.File file, java.lang.String charset)
CsvWriter(java.io.File file, java.lang.String charset, boolean append)	Creates a CSvWriter from a file.
CsvWriter(java.io.PrintStream s)	Creates a CSvWriter from a PrintStream.
CsvWriter(java.io.PrintStream s, java.lang.String charset)	Creates a CSvWriter from a PrintStream.
CsvWriter(java.io.Writer writer)	Create a CsvWriter from a writer.
CsvWriter(java.lang.String filename)
CsvWriter(java.lang.String filename, boolean append)
CsvWriter(java.lang.String filename, java.lang.String charset)
CsvWriter(java.lang.String filename, java.lang.String charset, boolean append)	Creates a CSvWriter from a file name.

Method Summary

Modifier and Type	Method	Description
void	close()
void	flush()
java.lang.String	getLineSeparator()
char	getSeparator()
void	setLineSeparator(java.lang.String sep)	Sets the line separator to use.
void	setSeparator(char sep)	Sets the cell separator.
void	write(boolean value)	Writes a boolean cell.
void	write(boolean forceEscape, java.lang.String... values)	Writes an array of String cells and controls their escaping.
void	write(byte value)	Writes a byte cell.
void	write(double value)	Writes a double cell.
void	write(float value)	Writes a float cell.
void	write(int value)	Writes an int cell.
void	write(long value)	Writes a long cell.
void	write(short value)	Writes a short cell.
<E extends java.lang.Enum<E>> void	write(E value)	Writes an enum cell.
void	write(java.lang.CharSequence value)	Writes a CharSequence cell, escaping it if necessary.
void	write(java.lang.CharSequence value, boolean forceEscape)	Writes a CharSequence cell and controls its escaping.
void	write(java.lang.String value)	Writes a String cell, escaping it if necessary.
void	write(java.lang.String... values)	Writes an array of String cells, escaping them if necessary.
void	write(java.lang.String value, boolean forceEscape)	Writes a String cell and controls its escaping.
void	write(java.util.Collection<java.lang.String> values)	Writes a collection of String cells, escaping them if necessary.
void	write(java.util.Collection<java.lang.String> values, boolean forceEscape)	Writes a collection of String cells and controls their escaping.
void	writeln()	Writes the line separator (moves to next line).
void	writeln(boolean forceEscape, java.lang.String... values)	Writes an array of String cells, controlling their escaping, then moves to next line.
void	writeln(java.lang.String... values)	Writes an array of String cells, escaping if necessary, then moves to next line.
void	writeln(java.util.Collection<java.lang.String> values)	Writes a collection of cells, escaping them if necessary, then moves to next line.
void	writeln(java.util.Collection<java.lang.String> values, boolean forceEscape)	Writes a collection of String cells, controlling their escaping, then moves to next line.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SEPARATOR

public static final char DEFAULT_SEPARATOR

The default separator that should be used.

See Also:

Constant Field Values

Constructor Detail

CsvWriter

public CsvWriter(java.io.Writer writer)

Create a CsvWriter from a writer.

Parameters:

writer - The writer.

CsvWriter

public CsvWriter(java.io.PrintStream s,
                 java.lang.String charset)

Creates a CSvWriter from a PrintStream.

Buffering is used.

Parameters:

s - The PrintStream.

charset - The charset name.

CsvWriter

public CsvWriter(java.io.PrintStream s)

Creates a CSvWriter from a PrintStream.

Buffering is used.

Parameters:

s - The PrintStream.

CsvWriter

public CsvWriter(java.lang.String filename,
                 java.lang.String charset,
                 boolean append)
          throws java.io.IOException

Creates a CSvWriter from a file name.

Buffering is used.

Parameters:

filename - The file name.

charset - The charset name.

append - If true, then bytes will be written to the end of the file rather than the beginning.

Throws:

java.io.IOException - When an IO error occurs.

CsvWriter

public CsvWriter(java.lang.String filename,
                 java.lang.String charset)
          throws java.io.IOException

Throws:

java.io.IOException

CsvWriter

public CsvWriter(java.lang.String filename,
                 boolean append)
          throws java.io.IOException

Throws:

java.io.IOException

CsvWriter

public CsvWriter(java.lang.String filename)
          throws java.io.IOException

Throws:

java.io.IOException

CsvWriter

public CsvWriter(java.io.File file,
                 java.lang.String charset,
                 boolean append)
          throws java.io.IOException

Creates a CSvWriter from a file.

Buffering is used.

Parameters:

file - The file.

charset - The charset name.

append - If true, then bytes will be written to the end of the file rather than the beginning.

Throws:

java.io.IOException - When an IO error occurs.

CsvWriter

public CsvWriter(java.io.File file,
                 java.lang.String charset)
          throws java.io.IOException

Throws:

java.io.IOException

CsvWriter

public CsvWriter(java.io.File file,
                 boolean append)
          throws java.io.IOException

Throws:

java.io.IOException

CsvWriter

public CsvWriter(java.io.File file)
          throws java.io.IOException

Throws:

java.io.IOException

Method Detail

getSeparator

public char getSeparator()

Returns:

The used cell separator.

setSeparator

public void setSeparator(char sep)

Sets the cell separator.

Parameters:

sep - The separator.

getLineSeparator

public java.lang.String getLineSeparator()

Returns:

The used line separator.

setLineSeparator

public void setLineSeparator(java.lang.String sep)

Sets the line separator to use.

Parameters:

sep - The line separator.

writeln

public void writeln()
             throws java.io.IOException

Writes the line separator (moves to next line).

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(java.lang.CharSequence value,
                  boolean forceEscape)
           throws java.io.IOException

Writes a CharSequence cell and controls its escaping.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

forceEscape - If true, cell is escaped. If false, cell is escaped if necessary.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(java.lang.CharSequence value)
           throws java.io.IOException

Writes a CharSequence cell, escaping it if necessary.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(java.lang.String value,
                  boolean forceEscape)
           throws java.io.IOException

Writes a String cell and controls its escaping.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

forceEscape - If true, cell is escaped. If false, cell is escaped if necessary.

Throws:

java.io.IOException - When an IO error occurs.

write

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

Writes a String cell, escaping it if necessary.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(java.util.Collection<java.lang.String> values,
                  boolean forceEscape)
           throws java.io.IOException

Writes a collection of String cells and controls their escaping.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

values - The cells.

forceEscape - If true, all cells are escaped. If false, each cell is escaped if necessary.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(java.util.Collection<java.lang.String> values)
           throws java.io.IOException

Writes a collection of String cells, escaping them if necessary.

If necessary, a cell separator is first appended.
A cell separator is inserted between consecutive cells.
Cells are escaped if necessary.

Parameters:

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

writeln

public void writeln(java.util.Collection<java.lang.String> values,
                    boolean forceEscape)
             throws java.io.IOException

Writes a collection of String cells, controlling their escaping, then moves to next line.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

values - The cells.

forceEscape - If true, all cells are escaped. If false, each cell is escaped if necessary.

Throws:

java.io.IOException - When an IO error occurs.

writeln

public void writeln(java.util.Collection<java.lang.String> values)
             throws java.io.IOException

Writes a collection of cells, escaping them if necessary, then moves to next line.

If necessary, a cell separator is first appended.
A cell separator is inserted between consecutive cells.
Cells are escaped if necessary.

Parameters:

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(boolean forceEscape,
                  java.lang.String... values)
           throws java.io.IOException

Writes an array of String cells and controls their escaping.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

forceEscape - If true, all cells are escaped. If false, each cell is escaped if necessary.

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

write

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

Writes an array of String cells, escaping them if necessary.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

writeln

public void writeln(boolean forceEscape,
                    java.lang.String... values)
             throws java.io.IOException

Writes an array of String cells, controlling their escaping, then moves to next line.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

forceEscape - If true, all cells are escaped. If false, each cell is escaped if necessary.

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

writeln

public void writeln(java.lang.String... values)
             throws java.io.IOException

Writes an array of String cells, escaping if necessary, then moves to next line.

If necessary, a cell separator is first appended. A cell separator is inserted between consecutive cells.

Parameters:

values - The cells.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(boolean value)
           throws java.io.IOException

Writes a boolean cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(long value)
           throws java.io.IOException

Writes a long cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(int value)
           throws java.io.IOException

Writes an int cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(short value)
           throws java.io.IOException

Writes a short cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(byte value)
           throws java.io.IOException

Writes a byte cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(double value)
           throws java.io.IOException

Writes a double cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public void write(float value)
           throws java.io.IOException

Writes a float cell.

If necessary, a cell separator is first appended.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

write

public <E extends java.lang.Enum<E>> void write(E value)
                                         throws java.io.IOException

Writes an enum cell.

If necessary, a cell separator is first appended.

Type Parameters:

E - The enum type.

Parameters:

value - The cell.

Throws:

java.io.IOException - When an IO error occurs.

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException