org.jsefa.csv.annotation

Annotation Type CsvField

@Retention(value=RUNTIME)
@Target(value=FIELD)
public @interface CsvField

CSV field annotation.

Author:

Norman Lahme-Huetig

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
int	pos The position of the field with the following semantic:

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String[]	constraints The constraints to validate.
Class<? extends SimpleTypeConverter>	converterType Specifies the converter type to be used.
String	dataTypeName The name of the data type of the CSV field this annotation describes.
String[]	format The format to be used to construct a SimpleTypeConverter for this field.
SimpleListItem	listItem In case of a simple type list this annotation parameter provides details about the list items.
String	noValue The string to use for describing that no value is given for the CSV field this annotation describes.
QuoteMode	quoteMode The quote mode to use for the CSV field this annotation describes.
boolean	required True, if a value is required; false otherwise.
Class<? extends Validator>	validatorType Specifies the validator type to be used.

Element Detail

pos

public abstract int pos

The position of the field with the following semantic:

If the position of a field A is less than the position of a field B, than field A comes (not necessarily directly) before field B.
The positions of all fields must specify a total order.

dataTypeName

public abstract String dataTypeName

The name of the data type of the CSV field this annotation describes. If not set, it must be determinable from the type of the annotated java field.

It should be explicitly set if the type mapping should not be created from the annotations given in the class of the annotated field. This is useful when mixing explicit type mapping creation with annotation based type mapping creation.

Default:

""

quoteMode

public abstract QuoteMode quoteMode

The quote mode to use for the CSV field this annotation describes.

Default:

org.jsefa.csv.lowlevel.config.QuoteMode.DEFAULT

noValue

public abstract String noValue

The string to use for describing that no value is given for the CSV field this annotation describes.

Default:

"DEFAULT_STRING"

format

public abstract String[] format

The format to be used to construct a SimpleTypeConverter for this field. The SimpleTypeConverter class will be determined using the type of the annotated java field.

Default:

{}

converterType

public abstract Class<? extends SimpleTypeConverter> converterType

Specifies the converter type to be used. In the default case the converter type is determined using the type of the annotated java field.

Default:

org.jsefa.common.annotation.NoConverterType.class

listItem

public abstract SimpleListItem listItem

In case of a simple type list this annotation parameter provides details about the list items.

Default:

@org.jsefa.common.annotation.SimpleListItem

required

public abstract boolean required

True, if a value is required; false otherwise.

Default:

false

validatorType

public abstract Class<? extends Validator> validatorType

Specifies the validator type to be used. In the default case the validator type is determined using the type of the java field with this annotation.

Default:

org.jsefa.common.annotation.NoValidatorType.class

constraints

public abstract String[] constraints

The constraints to validate. Each constraint is a String of the form 'name=value' where name is the name of the constraint and value is its value. The allowed set of constraints depend on the validator type.

Default:

{}