org.axiondb.types
Class CharacterType

java.lang.Object
  org.axiondb.types.BaseDataType
      org.axiondb.types.CharacterType

All Implemented Interfaces:

Comparator, DataType, DataTypeFactory, Serializable

public class CharacterType

extends BaseDataType

A DataType representing a single char value.

Version:

$Revision: 1.8 $ $Date: 2004/09/09 23:47:42 $

See Also:

Serialized Form

Constructor Summary

CharacterType()

Method Summary

boolean	accepts(Object value) Returns true iff value is null, a Character, or a single character String.
int	compare(Object a, Object b)
Object	convert(Object value) Returns an Character converted from the given value, or throws IllegalArgumentException if the given value isn't acceptable.
protected Comparator	getComparator() This base implementation simply returns a ComparableComparator.
int	getJdbcType() Returns the JDBC type codemost closely matching this type.
int	getPrecision() Value returned by ResultSetMetaData#getPrecisionfor this data type.
String	getPreferredValueClassName() Returns the "normal" type returned by convert(java.lang.Object).
boolean	isCaseSensitive() For character and string-related types, indicates whether type acknowledges case when storing and retrieving values
DataType	makeNewInstance()
Object	read(DataInput in) Instantiate an object of my type from the given DataInput.
Object	successor(Object value) Returns the successor for the given value.
boolean	supportsSuccessor() Returns true if the successor(java.lang.Object)method is supported, false otherwise.
String	toString() Returns "character"
void	write(Object value, DataOutput out) Writes the given value to the given DataOutput.

Methods inherited from class org.axiondb.types.BaseDataType

getColumnDisplaySize, getLiteralPrefix, getLiteralSuffix, getNullableCode, getScale, getSearchableCode, isCurrency, isUnsigned, toBigDecimal, toBigInteger, toBlob, toBoolean, toByte, toByteArray, toClob, toDate, toDouble, toFloat, toInt, toLong, toNumber, toShort, toString, toTime, toTimestamp, toURL

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

equals

Constructor Detail

CharacterType

public CharacterType()

Method Detail

getJdbcType

public int getJdbcType()

Description copied from interface: DataType

Returns the JDBC type codemost closely matching this type.

Specified by:

getJdbcType in interface DataType

Specified by:

getJdbcType in class BaseDataType

Returns:

Types.CHAR

getPreferredValueClassName

public String getPreferredValueClassName()

Description copied from interface: DataType

Returns the "normal" type returned by DataType.convert(java.lang.Object). Returns java.lang.Object if unknown.

Specified by:

getPreferredValueClassName in interface DataType

Overrides:

getPreferredValueClassName in class BaseDataType

See Also:

AxionResultSetMetaData.getColumnClassName(int)

getPrecision

public int getPrecision()

Description copied from interface: DataType

Value returned by ResultSetMetaData#getPrecisionfor this data type.

Specified by:

getPrecision in interface DataType

Overrides:

getPrecision in class BaseDataType

isCaseSensitive

public boolean isCaseSensitive()

Description copied from interface: DataType

For character and string-related types, indicates whether type acknowledges case when storing and retrieving values

Specified by:

isCaseSensitive in interface DataType

Overrides:

isCaseSensitive in class BaseDataType

toString

public String toString()

Returns "character"

Returns:

"character"

accepts

public boolean accepts(Object value)

Returns true iff value is null, a Character, or a single character String.

Specified by:

accepts in interface DataType

Specified by:

accepts in class BaseDataType

supportsSuccessor

public boolean supportsSuccessor()

Description copied from interface: DataType

Returns true if the DataType.successor(java.lang.Object)method is supported, false otherwise.

Specified by:

supportsSuccessor in interface DataType

Overrides:

supportsSuccessor in class BaseDataType

successor

public Object successor(Object value)
                 throws IllegalArgumentException

Description copied from interface: DataType

Returns the successor for the given value. For example, the successor of the integer 1 is 2.

Specified by:

successor in interface DataType

Overrides:

successor in class BaseDataType

Throws:

IllegalArgumentException

convert

public Object convert(Object value)
               throws IllegalArgumentException

Returns an Character converted from the given value, or throws IllegalArgumentException if the given value isn't acceptable.

Specified by:

convert in interface DataType

Specified by:

convert in class BaseDataType

Throws:

IllegalArgumentException

read

public Object read(DataInput in)
            throws IOException

Description copied from interface: DataType

Instantiate an object of my type from the given DataInput. The next sequence of bytes to be read from the DataInput will have been written by DataType.write(java.lang.Object, java.io.DataOutput).

Specified by:

read in interface DataType

Specified by:

read in class BaseDataType

Throws:

IOException

See Also:

write(java.lang.Object, java.io.DataOutput)

write

public void write(Object value,
                  DataOutput out)
           throws IOException

Writes the given value to the given DataOutput. Null values are written as Character.MIN_VALUE, false. Character.MIN_VALUE values are written as Character.MIN_VALUE, true. All other values are written directly.

Specified by:

write in interface DataType

Specified by:

write in class BaseDataType

Parameters:

value - the value to write, which must be acceptable

Throws:

IOException

makeNewInstance

public DataType makeNewInstance()

Specified by:

makeNewInstance in interface DataTypeFactory

Specified by:

makeNewInstance in class BaseDataType

compare

public int compare(Object a,
                   Object b)

Specified by:

compare in interface Comparator

Overrides:

compare in class BaseDataType

getComparator

protected Comparator getComparator()

Description copied from class: BaseDataType

This base implementation simply returns a ComparableComparator.

Overrides:

getComparator in class BaseDataType