public class DateColumnImpl extends AbstractColumn<Date> implements Cloneable
DateColumnImpl
extends the OneToOneColumnImpl
with support
for the Date
type and various default or custom date formats.Constructor and Description |
---|
DateColumnImpl(String aKey)
Constructor of the
DateColumnImpl with support for the default
SimpleDateFormat instances as defined in the
DateConsts.DEFAULT_DATE_FORMATS . |
DateColumnImpl(String aKey,
SimpleDateFormat[] aDateFormats)
Constructor of the
DateColumnImpl with support for the provided
SimpleDateFormat instances. |
Modifier and Type | Method and Description |
---|---|
Object |
clone() |
Date |
fromStorageStrings(String[] aStringValues)
A
Column implementation can provide its own text exchange format
for the given objects. |
String |
toPrintable(Date aValue)
A
Column implementation can provide its own printable format of
the given objects; for example a human readable text representation of
the value (or in very specialized cases even enriched with ANSI escape
codes). |
String[] |
toStorageStrings(Date aValue)
A
Column implementation can provide its own text exchange format
for the given objects. |
contains, fromStorageString, get, getKey, getType, remove, toStorageString
public DateColumnImpl(String aKey)
DateColumnImpl
with support for the default
SimpleDateFormat
instances as defined in the
DateConsts.DEFAULT_DATE_FORMATS
. Actually the
ConcurrentDateFormat
is used to be thread safe.aKey
- The key to be used.public DateColumnImpl(String aKey, SimpleDateFormat[] aDateFormats)
DateColumnImpl
with support for the provided
SimpleDateFormat
instances. To avoid multi threading problems,
please wrap your SimpleDateFormat
instances inside
ConcurrentDateFormat
instances, just to be thread safe.aKey
- The key to be used.aDateFormats
- The SimpleDateFormat
instances used for
parsing date strings.public String[] toStorageStrings(Date aValue)
Column
Column
implementation can provide its own text exchange format
for the given objects. This method enables the Column
to convert
a value of the given type to a String
array and via
Column.fromStorageStrings(String[])
back to the value (bijective).
This method supports data sinks (such as Amazon's SimpleDb) which provide
dedicated support for multiple values in a row's entry: In case T is an
array type, then the storage String
representations of the
elements in that array may be placed in dedicated entries of the returned
String
array. In case T is not an array type then the returned
String
array may contain just one value.
In case data sinks (such as relational databases) are to be addressed
which allow only a single value in a row's entry, then the method
Column.toStorageString(Object)
may be used instead.toStorageStrings
in interface Column<Date>
aValue
- the element to be converted to a String
array.String
array representation of the value.public Date fromStorageStrings(String[] aStringValues) throws ParseException
Column
Column
implementation can provide its own text exchange format
for the given objects. This method enables the Column
to convert
a String
array value to a value of the given type and via
Column.toStorageStrings(Object)
back to the String
array
(bijective).
This method supports data sinks (such as Amazon's SimpleDb) which provide
dedicated support for multiple values in a row's entry: In case T is an
array type, then the storage String
representations of the
elements in that array may be placed in dedicated entries of the provided
String
array. In case T is not an array type then the passed
String
array may contain just one value.
In case data sinks (such as relational databases) are to be addressed
which allow only a single value in a row's entry, then the method
#fromStorageString(Object)
may be used instead.fromStorageStrings
in interface Column<Date>
aStringValues
- The value to be converted to a type instance.ParseException
- in case parsing the String
was not
possiblepublic String toPrintable(Date aValue)
Column
Column
implementation can provide its own printable format of
the given objects; for example a human readable text representation of
the value (or in very specialized cases even enriched with ANSI escape
codes). This method enables the Column
to convert a value of the
given type to a human readable text. The human readable text, in
comparison to the method #toString()
(or
#toStorageFormat(Object)
) is not intended to be converted back to
the actual value (not bijective).
This method may be used a Header
instance's method
Header.toPrintable(Record)
.toPrintable
in interface Column<Date>
toPrintable
in class AbstractColumn<Date>
aValue
- the element to be converted to a human readable text.public Object clone() throws CloneNotSupportedException
clone
in class AbstractColumn<Date>
CloneNotSupportedException
Copyright © 2016. All rights reserved.