Package com.univocity.parsers.common.fields

Class FieldConversionMapping

java.lang.Object

com.univocity.parsers.common.fields.FieldConversionMapping

All Implemented Interfaces:

Cloneable

public class FieldConversionMapping
extends Object
implements Cloneable

A class for mapping field selections to sequences of Conversion objects

Field Summary

Fields

Modifier and Type	Field	Description
private Map<Integer,List<Conversion<?,?>>>	conversionsByIndex	This is the final sequence of conversions applied to each index in a record.
private List<FieldSelector>	conversionSequence	This list contains the sequence of conversions applied to sets of fields over multiple calls.
private AbstractConversionMapping<Integer>	convertAllMapping
private static final Conversion[]	EMPTY_CONVERSION_ARRAY
private AbstractConversionMapping<Enum>	fieldEnumConversionMapping
private AbstractConversionMapping<Integer>	fieldIndexConversionMapping
private AbstractConversionMapping<String>	fieldNameConversionMapping
int[]	validatedIndexes
private Map<Integer,List<ValidatedConversion>>	validationsByIndex

Constructor Summary

Constructors

Constructor	Description
FieldConversionMapping()

Method Summary

Modifier and Type	Method	Description
Object	applyConversions(int index, String stringValue, boolean[] convertedFlags)	Applies a sequence of conversions associated with a String value parsed from a given index.
void	applyConversionsOnAllFields(Conversion<String,?>... conversions)	Applies a sequence of conversions on all fields.
FieldSet<Enum>	applyConversionsOnFieldEnums(Conversion<String,?>... conversions)	Applies a sequence of conversions on a selection of enumerations that represent fields
FieldSet<Integer>	applyConversionsOnFieldIndexes(Conversion<String,?>... conversions)	Applies a sequence of conversions on a selection of field indexes
FieldSet<String>	applyConversionsOnFieldNames(Conversion<String,?>... conversions)	Applies a sequence of conversions on a selection of field name
FieldConversionMapping	clone()
void	executeValidations(int index, Object value)	Applies any validations associated with a field at a given index in a record
Conversion[]	getConversions(int index, Class<?> expectedType)	Returns the sequence of conversions to be applied at a given column index
void	prepareExecution(boolean writing, String[] values)	Prepares the conversions registered in this object to be executed against a given sequence of fields
Object	reverseConversions(boolean executeInReverseOrder, int index, Object value, boolean[] convertedFlags)	Applies a sequence of conversions associated with an Object value at a given index in a record.

Methods inherited from class java.lang.Object

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

Field Details

EMPTY_CONVERSION_ARRAY

private static final Conversion[] EMPTY_CONVERSION_ARRAY

validatedIndexes

public int[] validatedIndexes

conversionSequence

private List<FieldSelector> conversionSequence

This list contains the sequence of conversions applied to sets of fields over multiple calls.

It is shared by fieldNameConversionMapping, fieldIndexConversionMapping and convertAllMapping.

Every time the user associates a sequence of conversions to a field, conversionSequence list will receive the FieldSelector.

fieldNameConversionMapping

private AbstractConversionMapping<String> fieldNameConversionMapping

fieldIndexConversionMapping

private AbstractConversionMapping<Integer> fieldIndexConversionMapping

fieldEnumConversionMapping

private AbstractConversionMapping<Enum> fieldEnumConversionMapping

convertAllMapping

private AbstractConversionMapping<Integer> convertAllMapping

conversionsByIndex

private Map<Integer,List<Conversion<?,?>>> conversionsByIndex

This is the final sequence of conversions applied to each index in a record. It is populated when prepareExecution(boolean, String[]) is invoked.

validationsByIndex

private Map<Integer,List<ValidatedConversion>> validationsByIndex

Constructor Details

FieldConversionMapping

public FieldConversionMapping()

Method Details

prepareExecution

public void prepareExecution(boolean writing,
 String[] values)

Prepares the conversions registered in this object to be executed against a given sequence of fields

Parameters:

writing - flag indicating whether a writing process is being initialized.

values - The field sequence that identifies how records will be organized.

This is generally the sequence of headers in a record, but it might be just the first parsed row from a given input (as field selection by index is allowed).

applyConversionsOnAllFields

public void applyConversionsOnAllFields(Conversion<String,?>... conversions)

Applies a sequence of conversions on all fields.

Parameters:

conversions - the sequence of conversions to be applied

applyConversionsOnFieldIndexes

public FieldSet<Integer> applyConversionsOnFieldIndexes(Conversion<String,?>... conversions)

Applies a sequence of conversions on a selection of field indexes

Parameters:

conversions - the sequence of conversions to be applied

Returns:

a selector of column indexes.

applyConversionsOnFieldNames

public FieldSet<String> applyConversionsOnFieldNames(Conversion<String,?>... conversions)

Applies a sequence of conversions on a selection of field name

Parameters:

conversions - the sequence of conversions to be applied

Returns:

a selector of column names.

applyConversionsOnFieldEnums

public FieldSet<Enum> applyConversionsOnFieldEnums(Conversion<String,?>... conversions)

Applies a sequence of conversions on a selection of enumerations that represent fields

Parameters:

conversions - the sequence of conversions to be applied

Returns:

a selector of enumerations.

executeValidations

public void executeValidations(int index,
 Object value)

Applies any validations associated with a field at a given index in a record

Parameters:

index - The index of parsed value in a record

value - The value of the record at the given index

reverseConversions

public Object reverseConversions(boolean executeInReverseOrder,
 int index,
 Object value,
 boolean[] convertedFlags)

Applies a sequence of conversions associated with an Object value at a given index in a record.

Parameters:

executeInReverseOrder - flag to indicate whether or not the conversion sequence must be executed in reverse order

index - The index of parsed value in a record

value - The value in a record

convertedFlags - an array of flags that indicate whether a conversion occurred. Used to determine whether or not a default conversion by type (specified with ConversionProcessor.convertType(Class, Conversion[])) should be applied.

Returns:

the Object resulting from a sequence of conversions against the original value.

applyConversions

public Object applyConversions(int index,
 String stringValue,
 boolean[] convertedFlags)

Applies a sequence of conversions associated with a String value parsed from a given index.

Parameters:

index - The index of parsed value in a record

stringValue - The parsed value in a record

convertedFlags - an array of flags that indicate whether a conversion occurred. Used to determine whether or not a default conversion by type (specified with ConversionProcessor.convertType(Class, Conversion[])) should be applied.

Returns:

the Object produced by a sequence of conversions against the original String value.

getConversions

public Conversion[] getConversions(int index,
 Class<?> expectedType)

Returns the sequence of conversions to be applied at a given column index

Parameters:

index - the index of the column where the conversions should be executed

expectedType - the type resulting from the conversion sequence.

Returns:

the sequence of conversions to be applied at a given column index

clone

public FieldConversionMapping clone()

Overrides:

clone in class Object