com.univocity.parsers.common.fields

Class FieldConversionMapping

java.lang.Object

com.univocity.parsers.common.fields.FieldConversionMapping

public class FieldConversionMapping
extends java.lang.Object

A class for mapping field selections to sequences of Conversion objects

Author:

uniVocity Software Pty Ltd - parsers@univocity.com

Constructor Summary

Constructors

Constructor and Description
FieldConversionMapping()

Method Summary

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

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

Constructor Detail

FieldConversionMapping

public FieldConversionMapping()

Method Detail

prepareExecution

public void prepareExecution(boolean writing,
                             java.lang.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<java.lang.String,?>... conversions)

Applies a sequence of conversions on all fields.

Parameters:

conversions - the sequence of conversions to be applied

applyConversionsOnFieldIndexes

public FieldSet<java.lang.Integer> applyConversionsOnFieldIndexes(Conversion<java.lang.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<java.lang.String> applyConversionsOnFieldNames(Conversion<java.lang.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<java.lang.Enum> applyConversionsOnFieldEnums(Conversion<java.lang.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.

reverseConversions

public java.lang.Object reverseConversions(boolean executeInReverseOrder,
                                           int index,
                                           java.lang.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 java.lang.Object applyConversions(int index,
                                         java.lang.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,
                                   java.lang.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