Module de.siegmar.fastcsv

Package de.siegmar.fastcsv.writer

Class CsvWriter

java.lang.Object

de.siegmar.fastcsv.writer.CsvWriter

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public final class CsvWriter
extends Object
implements Closeable, Flushable

This is the main class for writing CSV data.

Example use:

 try (CsvWriter csv = CsvWriter.builder().build(file)) {
     csv.writeRecord("Hello", "world");
 }

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CsvWriter.CsvWriterBuilder	This builder is used to create configured instances of CsvWriter.
final class	CsvWriter.CsvWriterRecord	This class is used to write a record field by field.

Field Summary

Fields

Modifier and Type	Field	Description
private final char	commentCharacter
private int	currentLineNo
private final char[]	emptyFieldValue
private final char	fieldSeparator
private final LineDelimiter	lineDelimiter
private final char[]	lineDelimiterChars
private boolean	openRecordWriter
private final char	quoteCharacter
private final QuoteStrategy	quoteStrategy
private final Writable	writer

Constructor Summary

Constructors

Constructor	Description
CsvWriter(Writable writer, char fieldSeparator, char quoteCharacter, char commentCharacter, QuoteStrategy quoteStrategy, LineDelimiter lineDelimiter)

Method Summary

Modifier and Type	Method	Description
static CsvWriter.CsvWriterBuilder	builder()	Creates a CsvWriter.CsvWriterBuilder instance used to configure and create instances of this class.
void	close()
private boolean	containsControlCharacter(String value, int fieldIdx, int length)
private CsvWriter	endRecord()
void	flush()
String	toString()
private void	validateNoOpenRecord()
CsvWriter	writeComment(String comment)	Writes a comment line and new line character(s) at the end.
private void	writeCommentInternal(String comment)
private static void	writeEscaped(Writable w, String value, char quoteChar)
private void	writeFragment(String comment, int i, int startPos)
private void	writeInternal(String value, int fieldIdx)
CsvWriter.CsvWriterRecord	writeRecord()	Starts a new record.
CsvWriter	writeRecord(Iterable<String> values)	Writes a complete line - one or more fields and new line character(s) at the end.
CsvWriter	writeRecord(String... values)	Writes a complete line - one or more fields and new line character(s) at the end.

Methods inherited from class java.lang.Object

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

Field Details

writer

private final Writable writer

fieldSeparator

private final char fieldSeparator

quoteCharacter

private final char quoteCharacter

commentCharacter

private final char commentCharacter

quoteStrategy

private final QuoteStrategy quoteStrategy

lineDelimiter

private final LineDelimiter lineDelimiter

currentLineNo

private int currentLineNo

lineDelimiterChars

private final char[] lineDelimiterChars

emptyFieldValue

private final char[] emptyFieldValue

openRecordWriter

private boolean openRecordWriter

Constructor Details

CsvWriter

CsvWriter(Writable writer,
 char fieldSeparator,
 char quoteCharacter,
 char commentCharacter,
 QuoteStrategy quoteStrategy,
 LineDelimiter lineDelimiter)

Method Details

builder

public static CsvWriter.CsvWriterBuilder builder()

Creates a CsvWriter.CsvWriterBuilder instance used to configure and create instances of this class.

Returns:

CsvWriterBuilder instance with default settings.

writeRecord

public CsvWriter writeRecord(Iterable<String> values)

Writes a complete line - one or more fields and new line character(s) at the end.

Parameters:

values - the fields to write (null values are handled as empty strings, if not configured otherwise (QuoteStrategies.EMPTY)).

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

See Also:

• writeRecord(String...)

writeRecord

public CsvWriter writeRecord(String... values)

Writes a complete line - one or more fields and new line character(s) at the end.

Parameters:

values - the fields to write (null values are handled as empty strings, if not configured otherwise (QuoteStrategies.EMPTY))

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

See Also:

• writeRecord(Iterable)

writeRecord

public CsvWriter.CsvWriterRecord writeRecord()

Starts a new record.

This method is used to write a record field by field. The record is ended by calling CsvWriter.CsvWriterRecord.endRecord().

Returns:

CsvWriterRecord instance to write fields to.

Throws:

IllegalStateException - if a record is already started

See Also:

• writeRecord(String...)
• writeRecord(Iterable)

validateNoOpenRecord

private void validateNoOpenRecord()

writeInternal

private void writeInternal(String value,
 int fieldIdx)
                    throws IOException

Throws:

IOException

containsControlCharacter

private boolean containsControlCharacter(String value,
 int fieldIdx,
 int length)

writeEscaped

private static void writeEscaped(Writable w,
 String value,
 char quoteChar)
                          throws IOException

Throws:

IOException

writeComment

public CsvWriter writeComment(String comment)

Writes a comment line and new line character(s) at the end.

Note that comments are not part of the CSV standard and may not be supported by all readers.

Parameters:

comment - the comment to write. The comment character (configured by CsvWriter.CsvWriterBuilder.commentCharacter(char)) is automatically prepended. Empty or null values results in a line only consisting of the comment character. If the argument comment contains line break characters (CR, LF), multiple comment lines will be written, terminated with the line break character configured by CsvWriter.CsvWriterBuilder.lineDelimiter(LineDelimiter).

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

writeCommentInternal

private void writeCommentInternal(String comment)
                           throws IOException

Throws:

IOException

writeFragment

private void writeFragment(String comment,
 int i,
 int startPos)
                    throws IOException

Throws:

IOException

endRecord

private CsvWriter endRecord()
                     throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object