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	skipComments(CommentMatcher commentMatcher) Enables the skipping of comments.
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).
CsvPreference.Builder	useEncoder(CsvEncoder encoder) Uses a custom CsvEncoder to escape CSV for writing.
CsvPreference.Builder	useQuoteMode(QuoteMode quoteMode) Uses a custom QuoteMode to determine if surrounding quotes should be applied when writing (only applicable if a column doesn't contain any special characters and wouldn't otherwise be quoted).

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

Since:

2.0.0

skipComments

public CsvPreference.Builder skipComments(CommentMatcher commentMatcher)

Enables the skipping of comments. You can supply your own comment matcher or use one of the predefined ones: CommentStartsWith or CommentMatches

Parameters:

commentMatcher - the comment matcher to use

Returns:

the updated Builder

Throws:

NullPointerException - if commentMatcher is null

Since:

2.1.0

useEncoder

public CsvPreference.Builder useEncoder(CsvEncoder encoder)

Uses a custom CsvEncoder to escape CSV for writing.

Parameters:

encoder - the custom encoder

Returns:

the updated Builder

Throws:

NullPointerException - if encoder is null

Since:

2.1.0

useQuoteMode

public CsvPreference.Builder useQuoteMode(QuoteMode quoteMode)

Uses a custom QuoteMode to determine if surrounding quotes should be applied when writing (only applicable if a column doesn't contain any special characters and wouldn't otherwise be quoted). You can supply your own quote mode or use one of the predefined ones: AlwaysQuoteMode or ColumnQuoteMode

Parameters:

quoteMode - the quote mode

Returns:

the updated Builder

Throws:

NullPointerException - if quoteMode is null

Since:

2.1.0

build

public CsvPreference build()

Builds the CsvPreference instance.

Returns:

the immutable CsvPreference instance