com.opencsv

Class CSVReaderBuilder

java.lang.Object

com.opencsv.CSVReaderBaseBuilder<CSVReader>

com.opencsv.CSVReaderBuilder

public class CSVReaderBuilder
extends CSVReaderBaseBuilder<CSVReader>

Builder for creating a CSVReader.

This should be the preferred method of creating a Reader as there are so many possible values to be set it is impossible to have constructors for all of them and keep backwards compatibility with previous constructors.
final CSVParser parser =
new CSVParserBuilder()
.withSeparator('\t')
.withIgnoreQuotations(true)
.build();
final CSVReader reader =
new CSVReaderBuilder(new StringReader(csv))
.withSkipLines(1)
.withCSVParser(parser)
.build();


See Also:

CSVReader

Field Summary

Fields inherited from class com.opencsv.CSVReaderBaseBuilder

errorLocale, icsvParser, keepCR, lineValidatorAggregator, multilineLimit, nullFieldIndicator, reader, rowProcessor, rowValidatorAggregator, skipLines, verifyReader

Constructor Summary

Constructors

Constructor and Description
CSVReaderBuilder(Reader reader) Sets the reader to an underlying CSV source.

Method Summary

Modifier and Type	Method and Description
CSVReader	build() Creates the CSVReader.
CSVReaderBuilder	withCSVParser(ICSVParser icsvParser) Sets the parser to use to parse the input.
CSVReaderBuilder	withErrorLocale(Locale errorLocale) Sets the locale for all error messages.
CSVReaderBuilder	withFieldAsNull(CSVReaderNullFieldIndicator indicator) Checks to see if it should treat a field with two separators, two quotes, or both as a null field.
CSVReaderBuilder	withKeepCarriageReturn(boolean keepCR) Sets if the reader will keep or discard carriage returns.
CSVReaderBuilder	withLineValidator(LineValidator lineValidator) Adds a LineValidator to the CSVReader.
CSVReaderBuilder	withMultilineLimit(int multilineLimit) Sets the maximum number of lines allowed in a multiline record.
CSVReaderBuilder	withRowProcessor(RowProcessor rowProcessor) Adds a RowProcessor to the CSVReader.
CSVReaderBuilder	withRowValidator(RowValidator rowValidator) Adds a RowValidator to the CSVReader.
CSVReaderBuilder	withSkipLines(int skipLines) Sets the number of lines to skip before reading.
CSVReaderBuilder	withVerifyReader(boolean verifyReader) Checks to see if the CSVReader should verify the reader state before reads or not.

Methods inherited from class com.opencsv.CSVReaderBaseBuilder

getCsvParser, getErrorLocale, getLineValidatorAggregator, getMultilineLimit, getOrCreateCsvParser, getReader, getRowValidatorAggregator, getSkipLines, isVerifyReader, keepCarriageReturn

Methods inherited from class java.lang.Object

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

Constructor Detail

CSVReaderBuilder

public CSVReaderBuilder(Reader reader)

Sets the reader to an underlying CSV source.

Parameters:

reader - The reader to an underlying CSV source.

Method Detail

withSkipLines

public CSVReaderBuilder withSkipLines(int skipLines)

Sets the number of lines to skip before reading.

Parameters:

skipLines - The number of lines to skip before reading.

Returns:

this

withCSVParser

public CSVReaderBuilder withCSVParser(ICSVParser icsvParser)

Sets the parser to use to parse the input.

Parameters:

icsvParser - The parser to use to parse the input.

Returns:

this

build

public CSVReader build()

Creates the CSVReader.

Specified by:

build in class CSVReaderBaseBuilder<CSVReader>

Returns:

The CSVReader based on the set criteria.

withKeepCarriageReturn

public CSVReaderBuilder withKeepCarriageReturn(boolean keepCR)

Sets if the reader will keep or discard carriage returns.

Parameters:

keepCR - True to keep carriage returns, false to discard.

Returns:

this

withVerifyReader

public CSVReaderBuilder withVerifyReader(boolean verifyReader)

Checks to see if the CSVReader should verify the reader state before reads or not.

This should be set to false if you are using some form of asynchronous reader (like readers created by the java.nio.* classes).

The default value is true.

Parameters:

verifyReader - True if CSVReader should verify reader before each read, false otherwise.

Returns:

this

withFieldAsNull

public CSVReaderBuilder withFieldAsNull(CSVReaderNullFieldIndicator indicator)

Checks to see if it should treat a field with two separators, two quotes, or both as a null field.

Parameters:

indicator - CSVReaderNullFieldIndicator set to what should be considered a null field.

Returns:

this

withMultilineLimit

public CSVReaderBuilder withMultilineLimit(int multilineLimit)

Sets the maximum number of lines allowed in a multiline record. More than this number in one record results in an IOException.

Parameters:

multilineLimit - No more than this number of lines is allowed in a single input record. The default is CSVReader.DEFAULT_MULTILINE_LIMIT.

Returns:

this

withErrorLocale

public CSVReaderBuilder withErrorLocale(Locale errorLocale)

Sets the locale for all error messages.

Parameters:

errorLocale - Locale for error messages

Returns:

this

Since:

4.0

withLineValidator

public CSVReaderBuilder withLineValidator(LineValidator lineValidator)

Adds a LineValidator to the CSVReader. Multiple LineValidators can be added with multiple calls.

Parameters:

lineValidator - LineValidator to inject.

Returns:

this

Since:

5.0

withRowValidator

public CSVReaderBuilder withRowValidator(RowValidator rowValidator)

Adds a RowValidator to the CSVReader. Multiple RowValidators can be added with multiple calls.

Parameters:

rowValidator - RowValidator to inject

Returns:

this

Since:

5.0

withRowProcessor

public CSVReaderBuilder withRowProcessor(RowProcessor rowProcessor)

Adds a RowProcessor to the CSVReader. Only a single RowProcessor can be added so multiple calls will overwrite the previously set RowProcessor.

Parameters:

rowProcessor - RowProcessor to inject

Returns:

this

Since:

5.0