org.supercsv.prefs

Class CsvPreference.Builder

java.lang.Object

org.supercsv.prefs.CsvPreference.Builder

Enclosing class:

CsvPreference

public static class CsvPreference.Builder
extends Object

Builds immutable CsvPreference instances. The builder pattern allows for additional preferences to be added in the future.

Constructor Summary

Constructors

Constructor and Description
CsvPreference.Builder(char quoteChar, int delimiterChar, String endOfLineSymbols) Constructs a Builder with the mandatory preference values.
CsvPreference.Builder(CsvPreference preference) Constructs a Builder with all of the values from an existing CsvPreference instance.

Method Summary

Methods

Modifier and Type	Method and Description
CsvPreference	build() Builds the CsvPreference instance.
CsvPreference.Builder	surroundingSpacesNeedQuotes(boolean surroundingSpacesNeedQuotes) Flag indicating whether spaces at the beginning or end of a cell should be ignored if they're not surrounded by quotes (applicable to both reading and writing CSV).

Methods inherited from class java.lang.Object

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

Constructor Detail

CsvPreference.Builder

public CsvPreference.Builder(CsvPreference preference)

Constructs a Builder with all of the values from an existing CsvPreference instance. Useful if you want to base your preferences off one of the existing CsvPreference constants.

Parameters:

preference - the existing preference

CsvPreference.Builder

public CsvPreference.Builder(char quoteChar,
                     int delimiterChar,
                     String endOfLineSymbols)

Constructs a Builder with the mandatory preference values.

Parameters:

quoteChar - matching pairs of this character are used to escape columns containing the delimiter

delimiterChar - the character separating each column

endOfLineSymbols - one or more symbols terminating the line, e.g. "\n". Only used for writing.

Throws:

IllegalArgumentException - if quoteChar and delimiterChar are the same character

NullPointerException - if endOfLineSymbols is null

Method Detail

surroundingSpacesNeedQuotes

public CsvPreference.Builder surroundingSpacesNeedQuotes(boolean surroundingSpacesNeedQuotes)

Flag indicating whether spaces at the beginning or end of a cell should be ignored if they're not surrounded by quotes (applicable to both reading and writing CSV). The default is false, as spaces "are considered part of a field and should not be ignored" according to RFC 4180.

Parameters:

surroundingSpacesNeedQuotes - flag indicating whether spaces at the beginning or end of a cell should be ignored if they're not surrounded by quotes

Returns:

the updated Builder

build

public CsvPreference build()

Builds the CsvPreference instance.

Returns:

the immutable CsvPreference instance