jet.connect

Class DbDecimal

java.lang.Object

jet.connect.DbValue

jet.connect.DbNumber

jet.connect.DbDecimal

All Implemented Interfaces:

jet.util.DbValueable, jet.util.QuickSortableNode

Direct Known Subclasses:

fCurrency

public class DbDecimal
extends DbNumber

The DbDecimal class wraps a value of the type BigDecimal in an object. An object of the type DbDecimal contains a single field whose type is BigDecimal.

In addition, this class provides several methods for converting a DbDecimal to a String or other number types, as well as other constants and methods useed when dealing with a DbDecimal.

Field Summary

Fields

Modifier and Type	Field and Description
BigDecimal	value Deprecated.

Fields inherited from class jet.connect.DbValue

BIGINT_DESC, bNull, CHAR_DESC, CURRENCY_DESC, DATE_DESC, desc, DOUBLE_DESC, INTEGER_DESC, TIME_DESC

Fields inherited from interface jet.util.DbValueable

EQUAL, GREATER, LESS, NULL

Constructor Summary

Constructors

Constructor and Description
DbDecimal() Constructs an uninitialized DbDecimal.
DbDecimal(DbColDesc desc) Constructs an uninitialized DbDecimal.

Method Summary

Modifier and Type	Method and Description
byte	byteValue() Returns the value of this DbDecimal as a byte.
Object	clone() Creates a clone of this DbDecimal object.
double	doubleValue() Returns the value of this DbDecimal as a double.
boolean	equals(DbNumber v) Compares this object to the specified object.
float	floatValue() Returns the value of this DbDecimal as a float.
BigDecimal	get() Returns the value of this DbDecimal as a BigDecimal value.
int	intValue() Returns the value of this DbDecimal as an int.
long	longValue() Returns the value of this DbDecimal as a long value.
void	set(BigDecimal v) Sets a newly allocated DbDecimal object that represents the specified BigDecimal argument.
void	set(JRHierarchicalDataset hds, int col) Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the JRHierarchicalDataset parameter and an index of the column.
void	set(ResultSet rs, int col) Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the ResultSet parameter and an index of the column.
void	setValue(DbNumber v) Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the DbNumber parameter.
void	setValue(String v) Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the String parameter.
short	shortValue() Returns the value of this DbDecimal as a short.
String	toString() Returns a String object representing this DbDecimal's value.
String	toStringValue()

Methods inherited from class jet.connect.DbNumber

compare, compare, compareTo, equals, set

Methods inherited from class jet.connect.DbValue

compareTo, compareTo, compareTo, equals, getColDesc, getDataTimeZone, getPrecision, getScale, getSqlType, isCurrency, isNull, makeDbValue, setColDesc, setfoo, setNull, setValue

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

value

public BigDecimal value

Deprecated.

The field contains the value of this object. Note use get and set to access it instead of accessing it directly.

Constructor Detail

DbDecimal

public DbDecimal()

Constructs an uninitialized DbDecimal. This DbDecimal object is mutable until a nonzero value and the description of the column are set.

DbDecimal

public DbDecimal(DbColDesc desc)

Constructs an uninitialized DbDecimal. This DbDecimal object is mutable until the value is set.

Parameters:

desc - The value to be represented by the DbColDesc object.

Method Detail

get

public BigDecimal get()

Returns the value of this DbDecimal as a BigDecimal value.

set

public void set(BigDecimal v)

Sets a newly allocated DbDecimal object that represents the specified BigDecimal argument. As for scale, uses BigDecimal.ROUND_HALF_UP as default.

Parameters:

v - The BigDecimal value to be represented by the DbDecimal object.

set

public void set(ResultSet rs,
                int col)
         throws SQLException

Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the ResultSet parameter and an index of the column.

Specified by:

set in class DbValue

Parameters:

rs - The ResultSet to be fetched.

col - The index of the column.

Throws:

SQLException - if the ResultSet does not contain the index.

set

public void set(JRHierarchicalDataset hds,
                int col)
         throws SQLException

Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the JRHierarchicalDataset parameter and an index of the column.

Overrides:

set in class DbValue

Parameters:

hds - The JRHierarchicalDataset to be fetched.

col - The index of the column.

Throws:

SQLException - if the ResultSet does not contain the index.

toString

public String toString()

Returns a String object representing this DbDecimal's value. The value is converted to signed decimal representation and returned as a string. If the value is null, it returns "NULL".

Specified by:

toString in class DbValue

Returns:

a string representation of the value of this object in base 10.

clone

public Object clone()

Creates a clone of this DbDecimal object.

Specified by:

clone in interface jet.util.DbValueable

Specified by:

clone in class DbValue

equals

public boolean equals(DbNumber v)

Compares this object to the specified object. The result is true if and only if the argument is not null but a DbDecimal object that contains the same DbNumber value as this object.

Specified by:

equals in class DbNumber

Parameters:

v - The DbNumber object to be compared with.

Returns:

true if the objects are the same, false otherwise.

byteValue

public byte byteValue()

Returns the value of this DbDecimal as a byte.

Specified by:

byteValue in class DbNumber

shortValue

public short shortValue()

Returns the value of this DbDecimal as a short.

Specified by:

shortValue in class DbNumber

intValue

public int intValue()

Returns the value of this DbDecimal as an int.

Specified by:

intValue in class DbNumber

longValue

public long longValue()

Returns the value of this DbDecimal as a long value.

Specified by:

longValue in class DbNumber

floatValue

public float floatValue()

Returns the value of this DbDecimal as a float.

Specified by:

floatValue in class DbNumber

doubleValue

public double doubleValue()

Returns the value of this DbDecimal as a double.

Specified by:

doubleValue in class DbNumber

setValue

public void setValue(DbNumber v)

Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the DbNumber parameter. The DbNumber object will be checked to see if it is null.

Specified by:

setValue in class DbNumber

Parameters:

v - The DbNumber to be converted to a DbDecimal. If it is null, the value will not be set.

setValue

public void setValue(String v)

Sets a newly allocated DbDecimal object that represents the BigDecimal value indicated by the String parameter. The string is converted to a long value in exactly the manner used by constructor method for radix 10.

Specified by:

setValue in class DbValue

Parameters:

v - The String to be converted to a BigDecimal.

toStringValue

public String toStringValue()

Specified by:

toStringValue in class DbValue

Returns:

a string which will represent the value in the DbValue(null flag and value). When compare StringValue from DbValues, we always assume that: the two DbValues have same DbColDesc. Two StringValue equals means the original DbValue equals. Does NOT transfer the compareTo(DbValue v) method. Only comparable dbValue implements this methods. String coding uses Base64.