com.davisor.data
Class BigIntegerType

java.lang.Object
  java.text.Format
      com.davisor.data.Type
          com.davisor.data.LocaleType
              com.davisor.data.FormatType
                  com.davisor.data.SimpleNumberType
                      com.davisor.data.BigIntegerType

All Implemented Interfaces:

java.lang.Cloneable, java.util.Comparator, com.davisor.core.Dupable, NumberType, java.io.Serializable

public class BigIntegerType

extends SimpleNumberType

BigIntegerType defines a data type that supports arbitrary precision integer data.

Since:

JDK1.3

See Also:

BigIntegerData, Serialized Form

Nested Class Summary

Nested classes inherited from class java.text.Format

java.text.Format.Field

Field Summary

static BigIntegerType	DEFAULT Default big integer type.
static java.lang.String	TYPENAME Type name ("BIGINT").

Fields inherited from class com.davisor.data.FormatType

M_pattern, M_sample

Fields inherited from class com.davisor.data.LocaleType

DEFAULT_LOCALE, M_locale

Fields inherited from class com.davisor.data.Type

METADATA_GROUP, METADATA_NAME, METADATA_PARENT, METADATA_SUBCHANNELS

Constructor Summary

	BigIntegerType() Default constructor.
	BigIntegerType(BigIntegerType bit) Copy constructor.
	BigIntegerType(java.lang.String dataName) Creates a new default type with no identity.
	BigIntegerType(java.lang.String dataName, java.lang.String id, java.util.Map metaData, java.util.Locale locale, java.lang.String pattern, java.lang.Object sample) Creates a new big integer type.
	BigIntegerType(java.lang.String dataName, java.lang.String id, java.lang.String format) Creates a new named big integer number data type with the given decimal format pattern.
protected	BigIntegerType(java.lang.String typeName, java.lang.String dataName, java.lang.String id, java.util.Map metaData, java.util.Locale locale, java.lang.String pattern, java.lang.Object sample) Creates a new big integer type.

Method Summary

java.math.BigInteger	decode(java.lang.Number numberValue) Converts a number to a big integer value.
java.math.BigInteger	decode(java.lang.String stringValue, java.text.ParsePosition status) Converts a string to an big integer value.
com.davisor.core.Dupable	dup() Makes a deep copy of this object.
java.lang.String	encode(java.math.BigInteger value) Converts an integer to a string value.
boolean	equals(java.lang.Object o) Tests if this object is equal with another object.
int	getSQLCode() Gets the SQL type code, as defined by java.sql.Types.
java.lang.Class	getValueClass() Gets value container class.
DataValue	toData(java.sql.CallableStatement statement, int column) Converts a callable statement variable to a data value.
DataValue	toData(java.lang.Object objectValue) Converts an object to a data value.
DataValue	toData(java.sql.ResultSet resultSet, int column) Converts a result set column value to a data value.
DataValue	toData(java.lang.String stringValue, java.text.ParsePosition status) Converts a string to a data value.
DataValue	zero() Gets the zero data value for this type.

Methods inherited from class com.davisor.data.SimpleNumberType

byteValue, byteValue, createFormatter, doubleValue, doubleValue, floatValue, floatValue, intValue, intValue, longValue, longValue, numberValue, shortValue, shortValue, stringValue, stringValue, stringValue, stringValue, stringValue, stringValue, stringValue

Methods inherited from class com.davisor.data.FormatType

clearFormatter, getFormat, getFormatter, getPattern, getSample, hashCode, setFormat, setFormat, setLocale, setPattern, setSample

Methods inherited from class com.davisor.data.LocaleType

getLocale, setLocale

Methods inherited from class com.davisor.data.Type

ceil, check, check, compare, create, create, create, create, create, dup, floor, format, getCompatibility, getDataName, getId, getID, getMetaData, getMetaData, getSpecs, getSQLName, getSQLName, getTypeName, isNull, parseObject, register, register, setDataName, setId, setID, setMetaData, setMetaData, setSpecs, toString, toXML, xmlEnd, xmlStart

Methods inherited from class java.text.Format

clone, format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT

public static final BigIntegerType DEFAULT

Default big integer type.

TYPENAME

public static final java.lang.String TYPENAME

Type name ("BIGINT").

See Also:

Constant Field Values

Constructor Detail

BigIntegerType

public BigIntegerType()

Default constructor.

BigIntegerType

public BigIntegerType(BigIntegerType bit)

Copy constructor.

BigIntegerType

public BigIntegerType(java.lang.String dataName)

Creates a new default type with no identity.

Parameters:

dataName - data name (may be null)

BigIntegerType

public BigIntegerType(java.lang.String dataName,
                      java.lang.String id,
                      java.lang.String format)

Creates a new named big integer number data type with the given decimal format pattern.

This is the constructor the SQL type mapper Type.create(Integer,String,String,String) method will call to create a type that matches given SQL type.

Parameters:

dataName - data name (may be null)

id - type identity (may be null)

format - decimal format pattern (may be null)

See Also:

FormatType.setFormat(java.util.Locale, java.lang.String)

BigIntegerType

public BigIntegerType(java.lang.String dataName,
                      java.lang.String id,
                      java.util.Map metaData,
                      java.util.Locale locale,
                      java.lang.String pattern,
                      java.lang.Object sample)

Creates a new big integer type.

Parameters:

dataName - data name (may be null)

id - type identity (may be null)

metaData - type meta data map (may be null)

locale - type locale (may be null)

pattern - format pattern (may be null)

sample - format sample (may be null)

BigIntegerType

protected BigIntegerType(java.lang.String typeName,
                         java.lang.String dataName,
                         java.lang.String id,
                         java.util.Map metaData,
                         java.util.Locale locale,
                         java.lang.String pattern,
                         java.lang.Object sample)

Creates a new big integer type.

Parameters:

typeName - type name

dataName - data name (may be null)

id - type identity (may be null)

metaData - type meta data map (may be null)

locale - type locale (may be null)

pattern - format pattern (may be null)

sample - format sample (may be null)

Method Detail

dup

public com.davisor.core.Dupable dup()

Makes a deep copy of this object.

Specified by:

dup in interface com.davisor.core.Dupable

Specified by:

dup in class Type

equals

public boolean equals(java.lang.Object o)

Tests if this object is equal with another object.

BigInteger types are equal if their super-classes are.

Specified by:

equals in interface java.util.Comparator

Overrides:

equals in class FormatType

See Also:

Compare.equals(Object,Object)

getSQLCode

public int getSQLCode()

Gets the SQL type code, as defined by java.sql.Types.

Overrides:

getSQLCode in class Type

Returns:

Types.VARCHAR.

getValueClass

public java.lang.Class getValueClass()

Gets value container class.

Overrides:

getValueClass in class FormatType

toData

public DataValue toData(java.sql.CallableStatement statement,
                        int column)
                 throws InvalidDataException,
                        java.sql.SQLException

Converts a callable statement variable to a data value.

Gets statement big integer value, and returns a corresponding BigIntegerData value.

Overrides:

toData in class Type

Parameters:

statement - statement holding the data value to be converted

column - SQL column index for the data value to be converted

Returns:

a data value object corresponding to given object value

Throws:

InvalidDataException - if given object value could not be parsed

java.sql.SQLException - if a SQL error occurs

See Also:

toData(Object), toData(ResultSet,int), toData(String,ParsePosition), BigIntegerData

toData

public DataValue toData(java.lang.Object objectValue)
                 throws InvalidDataException

Converts an object to a data value.

Number objects are converted directly, other objects are converted first to strings, then to enumerated values.

Overrides:

toData in class Type

Parameters:

objectValue - data object (may be null)

Returns:

a data value object corresponding to given object value

Throws:

InvalidDataException - if given object value could not be parsed

See Also:

toData(CallableStatement,int), toData(ResultSet,int), toData(String,ParsePosition), BigIntegerData

toData

public DataValue toData(java.lang.String stringValue,
                        java.text.ParsePosition status)
                 throws InvalidDataException

Converts a string to a data value.

BigInteger type expects the given value to contain a big integer value compatible with current number pattern, and returns a corresponding BigIntegerData value

Specified by:

toData in class Type

Parameters:

stringValue - data string (may be null)

status - parse status (may be null)

Returns:

a data value object corresponding given string value

Throws:

InvalidDataException - if given string value could not be parsed

See Also:

toData(CallableStatement,int), toData(Object), toData(ResultSet,int), BigIntegerData

toData

public DataValue toData(java.sql.ResultSet resultSet,
                        int column)
                 throws InvalidDataException,
                        java.sql.SQLException

Converts a result set column value to a data value.

Gets result set column big integer value, and returns a corresponding BigIntegerData value.

Overrides:

toData in class Type

Parameters:

resultSet - resultSet holding the data value to be converted

column - SQL column index for the data value to be converted

Returns:

a data value object corresponding to given object value

Throws:

InvalidDataException - if given object value could not be parsed

java.sql.SQLException - if a SQL error occurs

See Also:

toData(CallableStatement,int), toData(Object), toData(String,ParsePosition), BigIntegerData

decode

public java.math.BigInteger decode(java.lang.Number numberValue)

Converts a number to a big integer value. If the number is an instance of SimpleNumberValue, the number member value of that instance is converted to BigInteger by calling recursively this method. If the number is a BigInteger, that value is returned. If the number is BigDecimal, a corresponging BigInteger is derived from it. In any other non null case, the long value of given number is converted to BigInteger. If the number is null, null is returned.

Parameters:

numberValue - the value to be converted (may be null)

Returns:

big integer value corresponding to given value (may be null)

See Also:

decode(String,ParsePosition)

decode

public java.math.BigInteger decode(java.lang.String stringValue,
                                   java.text.ParsePosition status)
                            throws InvalidDataException

Converts a string to an big integer value. null or empty string values result a null big integer value.

Parameters:

stringValue - the value to be converted (may be null)

Returns:

big integer value corresponding to given value (may be null)

Throws:

InvalidDataException - if the value cannot be converted

See Also:

decode(Number)

encode

public java.lang.String encode(java.math.BigInteger value)
                        throws InvalidDataException

Converts an integer to a string value.

The current implementation does not support custom formatting.

Parameters:

value - the value to be converted

Throws:

InvalidDataException - if the value cannot be converted

zero

public DataValue zero()

Gets the zero data value for this type.

Overrides:

zero in class SimpleNumberType

Returns:

a new zero value BigIntegerData object sharing this type