net.sf.mmm.util.lang.base.datatype.descriptor

Class AbstractDatatypeDescriptor<T>

java.lang.Object

net.sf.mmm.util.lang.base.datatype.descriptor.AbstractDatatypeDescriptor<T>

Type Parameters:

T - is the generic type of the described Datatype.

All Implemented Interfaces:

DatatypeDescriptor<T>

Direct Known Subclasses:

DatatypeDescriptorAtomicJavaDatatype, DatatypeDescriptorDate, DatatypeDescriptorEnum, DatatypeDescriptorLocalDate, DatatypeDescriptorSimpleDatatype

public abstract class AbstractDatatypeDescriptor<T>
extends Object
implements DatatypeDescriptor<T>

This is the abstract base implementation of DatatypeDescriptor.

Since:

6.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
private Class<T>	datatype
private int	requiredSegmentCount The number of segments that are required.
private List<DatatypeSegmentDescriptor<T,?>>	segmentDescriptorList

Constructor Summary

Constructors

Constructor and Description
AbstractDatatypeDescriptor(Class<T> datatype, DatatypeSegmentDescriptor<T,?>... segmentDescriptors) The constructor.

Method Summary

Modifier and Type	Method and Description
T	create(Object... segments) This method creates a new instance of the described datatype from the individual segments.
protected abstract T	doCreate(Object... segments) Called from create(Object...) after input validation has been performed.
Class<T>	getDatatype()
Object	getSegment(T datatypeInstance, int index) Gets a single segment of the given Datatype.
List<DatatypeSegmentDescriptor<T,?>>	getSegmentDescriptors() Gets the List of DatatypeSegmentDescriptors the described datatype is composed of.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

datatype

private final Class<T> datatype

See Also:

getDatatype()

segmentDescriptorList

private final List<DatatypeSegmentDescriptor<T,?>> segmentDescriptorList

See Also:

getSegmentDescriptors()

requiredSegmentCount

private final int requiredSegmentCount

The number of segments that are required.

Constructor Detail

AbstractDatatypeDescriptor

@SafeVarargs
public AbstractDatatypeDescriptor(Class<T> datatype,
                                                DatatypeSegmentDescriptor<T,?>... segmentDescriptors)

The constructor.

Parameters:

datatype - - see getDatatype().

segmentDescriptors - - see getSegmentDescriptors().

Method Detail

getDatatype

public Class<T> getDatatype()

Specified by:

getDatatype in interface DatatypeDescriptor<T>

Returns:

the Class reflecting the Datatype described by this object.

getSegmentDescriptors

public List<DatatypeSegmentDescriptor<T,?>> getSegmentDescriptors()

Gets the List of DatatypeSegmentDescriptors the described datatype is composed of.
E.g. a LocalDate is composed out of three segments all of the type Integer: year, month, and day.

Specified by:

getSegmentDescriptors in interface DatatypeDescriptor<T>

Returns:

the List of DatatypeSegmentDescriptors.

getSegment

public Object getSegment(T datatypeInstance,
                         int index)

Gets a single segment of the given Datatype.

Specified by:

getSegment in interface DatatypeDescriptor<T>

Parameters:

datatypeInstance - is the Datatype instance to disassemble.

index - is the index of the segment to retrieve. Has to correspond to the list index of segment descriptors.

Returns:

the atomic value of the requested segment. Has to correspond to DatatypeSegmentDescriptor.getType().

See Also:

DatatypeDescriptor.getSegmentDescriptors()

create

public T create(Object... segments)

This method creates a new instance of the described datatype from the individual segments.

Specified by:

create in interface DatatypeDescriptor<T>

Parameters:

segments - are the segment values in the order given by DatatypeDescriptor.getSegmentDescriptors(). Optional segments may be omitted (from the end of the list). The type of each segment has to match the corresponding segment type.

Returns:

the new datatype instance.

doCreate

protected abstract T doCreate(Object... segments)

Called from create(Object...) after input validation has been performed. Implement this method and do not worry about null values, wrong array size, etc.

Parameters:

segments - are the segment values.

Returns:

the new datatype instance.

toString

public String toString()

Overrides:

toString in class Object