Interface RecordMetaData
- All Known Implementing Classes:
RecordMetaDataImpl
public interface RecordMetaData
Metadata with information about
Record
s parsed from the input.-
Method Summary
Modifier and TypeMethodDescriptionboolean
containsColumn
(String headerName) Queries whether a given header name exists in theRecord
s parsed from the inputconvertFields
(Conversion... conversions) Associates a sequence ofConversion
s to fields of a given set of field namesconvertFields
(Class<T> enumType, Conversion... conversions) Associates a sequence ofConversion
s to fields of a given set of fieldsconvertIndexes
(Conversion... conversions) Associates a sequence ofConversion
s to fields of a given set of column indexesdefaultValueOf
(int columnIndex) Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)defaultValueOf
(Enum<?> column) Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)defaultValueOf
(String headerName) Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)String[]
headers()
Returns the column names of theRecord
s parsed from the input.int
Returns the index of a given columnint
Returns the index of a given columnString[]
Returns the sequence of headers that have been selected.<T> void
setDefaultValueOfColumns
(T defaultValue, int... columnIndexes) Associates a default value with one or more columns, in case the values contained arenull
<T> void
setDefaultValueOfColumns
(T defaultValue, Enum<?>... columns) Associates a default value with one or more columns, in case the values contained arenull
<T> void
setDefaultValueOfColumns
(T defaultValue, String... headerNames) Associates a default value with one or more columns, in case the values contained arenull
void
setTypeOfColumns
(Class<?> type, int... columnIndexes) Associates a type with one or more column.void
setTypeOfColumns
(Class<?> type, Enum... columns) Associates a type with one or more column.void
setTypeOfColumns
(Class<?> type, String... headerNames) Associates a type with one or more column.Class<?>
typeOf
(int columnIndex) Returns the type associated with a given column, defined with the methodsetTypeOfColumns(type, columns)
Class<?>
Returns the type associated with a given column, defined with the methodsetTypeOfColumns(type, columns)
Class<?>
Returns the type associated with a given column name, defined with the methodsetTypeOfColumns(type, columns)
-
Method Details
-
indexOf
Returns the index of a given column- Parameters:
column
- the column whose index will be returned- Returns:
- index of the given column
-
indexOf
Returns the index of a given column- Parameters:
headerName
- name of the column whose index will be returned- Returns:
- index of the given column
-
typeOf
Returns the type associated with a given column, defined with the methodsetTypeOfColumns(type, columns)
- Parameters:
column
- the column whose type will be returned- Returns:
- the type of the given column
-
typeOf
Returns the type associated with a given column name, defined with the methodsetTypeOfColumns(type, columns)
- Parameters:
headerName
- name of the column whose type will be returned- Returns:
- the type of the given column
-
typeOf
Returns the type associated with a given column, defined with the methodsetTypeOfColumns(type, columns)
- Parameters:
columnIndex
- the position of the column whose type will be returned- Returns:
- the type of the given column
-
setTypeOfColumns
Associates a type with one or more column. This allows the parsed data to be converted automatically to the given type when reading data from aRecord
, e.g.Record.toFieldObjectMap(String...)
will convert the selected field values to their respective types, and then set the result as the values in the map.- Parameters:
type
- the type to associate with a list of columncolumns
- the columns that will be associated with the given type.
-
setTypeOfColumns
Associates a type with one or more column. This allows the parsed data to be converted automatically to the given type when reading data from aRecord
, e.g.Record.toFieldObjectMap(String...)
will convert the selected field values to their respective types, and then set the result as the values in the map.- Parameters:
type
- the type to associate with a list of columnheaderNames
- the columns that will be associated with the given type.
-
setTypeOfColumns
Associates a type with one or more column. This allows the parsed data to be converted automatically to the given type when reading data from aRecord
, e.g.Record.toFieldObjectMap(String...)
will convert the selected field values to their respective types, and then set the result as the values in the map.- Parameters:
type
- the type to associate with a list of columncolumnIndexes
- the columns that will be associated with the given type.
-
setDefaultValueOfColumns
Associates a default value with one or more columns, in case the values contained arenull
- Type Parameters:
T
- type of the default value.- Parameters:
defaultValue
- the value to be used for the given column when the parsed result isnull
columns
- the columns to be associated with a default value.
-
setDefaultValueOfColumns
Associates a default value with one or more columns, in case the values contained arenull
- Type Parameters:
T
- type of the default value.- Parameters:
defaultValue
- the value to be used for the given column when the parsed result isnull
headerNames
- the column names to be associated with a default value.
-
setDefaultValueOfColumns
<T> void setDefaultValueOfColumns(T defaultValue, int... columnIndexes) Associates a default value with one or more columns, in case the values contained arenull
- Type Parameters:
T
- type of the default value.- Parameters:
defaultValue
- the value to be used for the given column when the parsed result isnull
columnIndexes
- the column indexes to be associated with a default value.
-
defaultValueOf
Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)- Parameters:
column
- the column whose default value will be returned- Returns:
- the default value associated with the given column or
null
.
-
defaultValueOf
Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)- Parameters:
headerName
- the column name whose default value will be returned- Returns:
- the default value associated with the given column or
null
.
-
defaultValueOf
Returns the default value associated with a column (defined usingsetDefaultValueOf(Column, Object)
)- Parameters:
columnIndex
- the column index whose default value will be returned- Returns:
- the default value associated with the given column or
null
.
-
convertFields
Associates a sequence ofConversion
s to fields of a given set of fields- Type Parameters:
T
- the enumeration type- Parameters:
enumType
- the type of the enumeration whose values represent headers in the inputRecord
sconversions
- the sequence of conversions to apply- Returns:
- (modifiable) set of fields to be selected and against which the given conversion sequence will be applied.
-
convertFields
Associates a sequence ofConversion
s to fields of a given set of field names- Parameters:
conversions
- the sequence of conversions to apply- Returns:
- (modifiable) set of fields names to be selected and against which the given conversion sequence will be applied.
-
convertIndexes
Associates a sequence ofConversion
s to fields of a given set of column indexes- Parameters:
conversions
- the sequence of conversions to apply- Returns:
- (modifiable) set of column indexes to be selected and against which the given conversion sequence will be applied.
-
headers
String[] headers()Returns the column names of theRecord
s parsed from the input.If the headers are extracted from the input (i.e.
CommonParserSettings.isHeaderExtractionEnabled()
== true), then these values will be returned.If no headers are extracted from the input, then the configured headers in
CommonSettings.getHeaders()
will be returned.- Returns:
- the headers associated with the
Record
s parsed from the input
-
selectedHeaders
String[] selectedHeaders()Returns the sequence of headers that have been selected. If no selection has been made, all available headers will be returned, producing the same output as a call to methodheaders()
.- Returns:
- the sequence of selected headers, or all headers if no selection has been made.
-
containsColumn
Queries whether a given header name exists in theRecord
s parsed from the input- Parameters:
headerName
- name of the header- Returns:
true
if the given header name exists in the input records, otherwisefalse
-