Package com.univocity.parsers.common.processor.core

Class AbstractColumnProcessor<T extends Context>

java.lang.Object

com.univocity.parsers.common.processor.core.AbstractColumnProcessor<T>

All Implemented Interfaces:

Processor<T>

Direct Known Subclasses:

ColumnProcessor

public abstract class AbstractColumnProcessor<T extends Context>
extends java.lang.Object
implements Processor<T>

A simple Processor implementation that stores values of columns. Values parsed in each row will be split into columns of Strings. Each column has its own list of values.

At the end of the process, the user can access the lists with values parsed for all columns using the methods getColumnValuesAsList(), getColumnValuesAsMapOfIndexes() and getColumnValuesAsMapOfNames().

Note: Storing the values of all columns may be memory intensive. For large inputs, use a AbstractBatchedColumnProcessor instead

Author:

uniVocity Software Pty Ltd - parsers@univocity.com

See Also:

AbstractParser, Processor, ColumnReader

Constructor Summary

Constructors

Constructor	Description
AbstractColumnProcessor()	Constructs a column processor, pre-allocating room for 1000 rows.
AbstractColumnProcessor(int expectedRowCount)	Constructs a column processor pre-allocating room for the expected number of rows to be processed

Method Summary

Modifier and Type	Method	Description
java.util.List<java.lang.String>	getColumn(int columnIndex)
java.util.List<java.lang.String>	getColumn(java.lang.String columnName)
java.util.List<java.util.List<java.lang.String>>	getColumnValuesAsList()
java.util.Map<java.lang.Integer,java.util.List<java.lang.String>>	getColumnValuesAsMapOfIndexes()
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getColumnValuesAsMapOfNames()
java.lang.String[]	getHeaders()
void	processEnded(T context)	This method will by invoked by the parser once, after the parsing process stopped and all resources were closed.
void	processStarted(T context)	This method will by invoked by the parser once, when it is ready to start processing the input.
void	putColumnValuesInMapOfIndexes(java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> map)
void	putColumnValuesInMapOfNames(java.util.Map<java.lang.String,java.util.List<java.lang.String>> map)
void	rowProcessed(java.lang.String[] row, T context)	Invoked by the parser after all values of a valid record have been processed.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractColumnProcessor

public AbstractColumnProcessor()

Constructs a column processor, pre-allocating room for 1000 rows.

AbstractColumnProcessor

public AbstractColumnProcessor(int expectedRowCount)

Constructs a column processor pre-allocating room for the expected number of rows to be processed

Parameters:

expectedRowCount - the expected number of rows to be processed

Method Detail

processStarted

public void processStarted(T context)

Description copied from interface: Processor

This method will by invoked by the parser once, when it is ready to start processing the input.

Specified by:

processStarted in interface Processor<T extends Context>

Parameters:

context - A contextual object with information and controls over the current state of the parsing process

rowProcessed

public void rowProcessed(java.lang.String[] row,
                         T context)

Description copied from interface: Processor

Invoked by the parser after all values of a valid record have been processed.

Specified by:

rowProcessed in interface Processor<T extends Context>

Parameters:

row - the data extracted by the parser for an individual record. Note that:

• it will never by null.
• it will never be empty unless explicitly configured using CommonSettings.setSkipEmptyLines(boolean)
• it won't contain lines identified by the parser as comments. To disable comment processing set Format.setComment(char) to '\0'

context - A contextual object with information and controls over the current state of the parsing process

processEnded

public void processEnded(T context)

Description copied from interface: Processor

This method will by invoked by the parser once, after the parsing process stopped and all resources were closed.

It will always be called by the parser: in case of errors, if the end of the input us reached, or if the user stopped the process manually using Context.stop().

Specified by:

processEnded in interface Processor<T extends Context>

Parameters:

context - A contextual object with information and controls over the state of the parsing process

getHeaders

public final java.lang.String[] getHeaders()

getColumnValuesAsList

public final java.util.List<java.util.List<java.lang.String>> getColumnValuesAsList()

putColumnValuesInMapOfNames

public final void putColumnValuesInMapOfNames(java.util.Map<java.lang.String,java.util.List<java.lang.String>> map)

putColumnValuesInMapOfIndexes

public final void putColumnValuesInMapOfIndexes(java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> map)

getColumnValuesAsMapOfNames

public final java.util.Map<java.lang.String,java.util.List<java.lang.String>> getColumnValuesAsMapOfNames()

getColumnValuesAsMapOfIndexes

public final java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> getColumnValuesAsMapOfIndexes()

getColumn

public java.util.List<java.lang.String> getColumn(java.lang.String columnName)

getColumn

public java.util.List<java.lang.String> getColumn(int columnIndex)