Class SQLDecimal
- java.lang.Object
-
- org.apache.derby.iapi.types.DataType
-
- org.apache.derby.iapi.types.NumberDataType
-
- org.apache.derby.iapi.types.SQLDecimal
-
- All Implemented Interfaces:
java.io.Externalizable
,java.io.Serializable
,java.lang.Comparable
,Formatable
,Storable
,TypedFormat
,DataValueDescriptor
,NumberDataValue
,Orderable
,VariableSizeDataValue
public final class SQLDecimal extends NumberDataType implements VariableSizeDataValue
SQLDecimal satisfies the DataValueDescriptor interfaces (i.e., OrderableDataType). It implements a numeric/decimal column, e.g. for * storing a column value; it can be specified when constructed to not allow nulls. Nullability cannot be changed after construction, as it affects the storage size and mechanism.Because OrderableDataType is a subtype of DataType, SQLDecimal can play a role in either a DataType/Row or a OrderableDataType/Row, interchangeably.
We assume the store has a flag for nullness of the value, and simply return a 0-length array for the stored form when the value is null.
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description private static int
BASE_MEMORY_USAGE
private static int
BIG_DECIMAL_MEMORY_USAGE
private byte[]
rawData
See comments for valueprivate int
rawScale
See comments for valueprivate java.math.BigDecimal
value
object state.-
Fields inherited from class org.apache.derby.iapi.types.NumberDataType
MAXLONG_PLUS_ONE, MINLONG_MINUS_ONE
-
Fields inherited from interface org.apache.derby.iapi.types.DataValueDescriptor
UNKNOWN_LOGICAL_LENGTH
-
Fields inherited from interface org.apache.derby.iapi.types.NumberDataValue
MAX_DECIMAL_PRECISION_SCALE, MIN_DECIMAL_DIVIDE_SCALE
-
Fields inherited from interface org.apache.derby.iapi.types.Orderable
ORDER_OP_EQUALS, ORDER_OP_GREATEROREQUALS, ORDER_OP_GREATERTHAN, ORDER_OP_LESSOREQUALS, ORDER_OP_LESSTHAN
-
Fields inherited from interface org.apache.derby.iapi.types.VariableSizeDataValue
IGNORE_PRECISION
-
-
Constructor Summary
Constructors Constructor Description SQLDecimal()
no-arg constructor, required by FormattableSQLDecimal(java.lang.String val)
SQLDecimal(java.math.BigDecimal val)
SQLDecimal(java.math.BigDecimal val, int nprecision, int scale)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description DataValueDescriptor
cloneValue(boolean forceMaterialization)
Clone this DataValueDescriptor.NumberDataValue
divide(NumberDataValue dividend, NumberDataValue divisor, NumberDataValue result)
This method implements the / operator for BigDecimal/BigDecimalNumberDataValue
divide(NumberDataValue dividend, NumberDataValue divisor, NumberDataValue result, int scale)
This method implements the / operator for BigDecimal/BigDecimalint
estimateMemoryUsage()
Estimate the memory usage in bytes of the data value and the overhead of the class.private java.math.BigDecimal
getBigDecimal()
static java.math.BigDecimal
getBigDecimal(DataValueDescriptor value)
Get a BigDecimal representing the value of a DataValueDescriptorboolean
getBoolean()
Gets the value in the data value descriptor as a boolean.byte
getByte()
Gets the value in the data value descriptor as a byte.int
getDecimalValuePrecision()
Return the SQL scale of this value, number of digits after the decimal point, or zero for a whole number.int
getDecimalValueScale()
Return the SQL scale of this value, number of digits after the decimal point, or zero for a whole number.double
getDouble()
If we have a value that is greater than the maximum double, exception is thrown.float
getFloat()
Gets the value in the data value descriptor as a float.int
getInt()
Gets the value in the data value descriptor as a int.int
getLength()
Gets the length of the data value.long
getLong()
Gets the value in the data value descriptor as a long.DataValueDescriptor
getNewNull()
Get a new null value of the same type as this data value.java.lang.Object
getObject()
Gets the value in the data value descriptor as a int.short
getShort()
Gets the value in the data value descriptor as a short.java.lang.String
getString()
Gets the value in the data value descriptor as a String.int
getTypeFormatId()
Return my format identifier.java.lang.String
getTypeName()
Get the SQL name of the datatypeprivate static int
getWholeDigits(java.math.BigDecimal decimalValue)
Calculate the number of digits to the left of the decimal point of the passed in value.int
hashCode()
protected boolean
isNegative()
This method implements the isNegative method.boolean
isNull()
Return whether the value is null or not.NumberDataValue
minus(NumberDataValue result)
This method implements the unary minus operator for double.NumberDataValue
minus(NumberDataValue left, NumberDataValue right, NumberDataValue result)
This method implements the - operator for "decimal - decimal".void
normalize(DataTypeDescriptor desiredType, DataValueDescriptor source)
Normalization method - this method may be called when putting a value into a SQLDecimal, for example, when inserting into a SQLDecimal column.NumberDataValue
plus(NumberDataValue addend1, NumberDataValue addend2, NumberDataValue result)
This method implements the + operator for DECIMAL.void
readExternal(java.io.ObjectInput in)
Note the use of rawData: we reuse the array if the incoming array is the same length or smaller than the array length.void
restoreToNull()
Restore this object to its (SQL)null value.void
setBigDecimal(java.math.BigDecimal theValue)
Only to be called when the application sets a value using BigDecimal through setBigDecimal calls.private void
setCoreValue(double theValue)
private void
setCoreValue(java.math.BigDecimal theValue)
protected void
setFrom(DataValueDescriptor theValue)
Set the value of this DataValueDescriptor based on the value of the specified DataValueDescriptor.void
setInto(java.sql.PreparedStatement ps, int position)
Set the value into a PreparedStatement.(package private) void
setObject(java.lang.Object theValue)
Set the value from a correctly typed BigDecimal object.void
setValue(boolean theValue)
Set the value.void
setValue(double theValue)
Set the value of this DataValueDescriptor to the given double value At DataType level just throws an error lower classes will overridevoid
setValue(float theValue)
Set the value of this DataValueDescriptor to the given float value At DataType level just throws an error lower classes will overridevoid
setValue(int theValue)
Set the value of this DataValueDescriptor to the given int value At DataType level just throws an error lower classes will overridevoid
setValue(long theValue)
Set the value of this DataValueDescriptor to the given long value At DataType level just throws an error lower classes will overridevoid
setValue(java.lang.Number theValue)
Called when setting a DECIMAL value internally or from through a procedure or function.void
setValue(java.lang.String theValue)
WARNING there is no checking to make sure that theValue doesn't exceed the precision/scale of the current SQLDecimal.void
setValueFromResultSet(java.sql.ResultSet resultSet, int colNumber, boolean isNullable)
Set the value based on the value for the specified DataValueDescriptor from the specified ResultSet.void
setWidth(int desiredPrecision, int desiredScale, boolean errorOnTrunc)
Set the precision/scale of the to the desired values.NumberDataValue
times(NumberDataValue left, NumberDataValue right, NumberDataValue result)
This method implements the * operator for "double * double".java.lang.String
toString()
protected int
typeCompare(DataValueDescriptor arg)
Compare this (not null) to a non-null value.int
typePrecedence()
Each built-in type in JSQL has a precedence.int
typeToBigDecimal()
DECIMAL implementation.void
writeExternal(java.io.ObjectOutput out)
Distill the BigDecimal to a byte array and write out: scale (zero or positive) as a byte length of byte array as a byte the byte array-
Methods inherited from class org.apache.derby.iapi.types.NumberDataType
absolute, compare, compare, mod, normalizeDOUBLE, normalizeREAL, normalizeREAL, objectNull, setValue, setValue, sqrt
-
Methods inherited from class org.apache.derby.iapi.types.DataType
checkHostVariable, cloneHolder, coalesce, compare, compare, compareTo, dataTypeConversion, equals, equals, flip, genericSetObject, getBytes, getDate, getStream, getTime, getTimestamp, getTraceString, getTypeName, greaterOrEquals, greaterThan, hasStream, in, invalidFormat, isNotNull, isNullOp, lessOrEquals, lessThan, notEquals, outOfRange, readExternalFromArray, recycle, setInto, setObjectForCast, setToNull, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, throwLangSetMismatch, throwLangSetMismatch
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.apache.derby.iapi.types.DataValueDescriptor
checkHostVariable, cloneHolder, coalesce, compare, compare, equals, getBytes, getDate, getStream, getTime, getTimestamp, getTraceString, greaterOrEquals, greaterThan, hasStream, in, isNotNull, isNullOp, lessOrEquals, lessThan, notEquals, readExternalFromArray, recycle, setInto, setObjectForCast, setToNull, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue
-
-
-
-
Field Detail
-
value
private java.math.BigDecimal value
object state. Note that scale and precision are always determined dynamically from value when it is not null. The field value can be null without the data value being null. In this case the value is stored in rawData and rawScale. This is to allow the minimal amount of work to read a SQLDecimal from disk. Creating the BigDecimal is expensive as it requires allocating three objects, the last two are a waste in the case the row does not qualify or the row will be written out by the sorter before being returned to the application.This means that this field must be accessed for read indirectly through the getBigDecimal() method, and when setting it the rawData field must be set to null.
-
rawData
private byte[] rawData
See comments for value
-
rawScale
private int rawScale
See comments for value
-
BASE_MEMORY_USAGE
private static final int BASE_MEMORY_USAGE
-
BIG_DECIMAL_MEMORY_USAGE
private static final int BIG_DECIMAL_MEMORY_USAGE
-
-
Constructor Detail
-
SQLDecimal
public SQLDecimal()
no-arg constructor, required by Formattable
-
SQLDecimal
public SQLDecimal(java.math.BigDecimal val)
-
SQLDecimal
public SQLDecimal(java.math.BigDecimal val, int nprecision, int scale) throws StandardException
- Throws:
StandardException
-
SQLDecimal
public SQLDecimal(java.lang.String val)
-
-
Method Detail
-
estimateMemoryUsage
public int estimateMemoryUsage()
Description copied from interface:DataValueDescriptor
Estimate the memory usage in bytes of the data value and the overhead of the class.- Specified by:
estimateMemoryUsage
in interfaceDataValueDescriptor
- Returns:
- the estimated memory usage
-
getInt
public int getInt() throws StandardException
Description copied from class:DataType
Gets the value in the data value descriptor as a int. Throws an exception if the data value is not receivable as a int.- Specified by:
getInt
in interfaceDataValueDescriptor
- Overrides:
getInt
in classDataType
- Returns:
- The data value as a int.
- Throws:
StandardException
- thrown on failure to convert
-
getByte
public byte getByte() throws StandardException
Description copied from class:DataType
Gets the value in the data value descriptor as a byte. Throws an exception if the data value is not receivable as a byte.- Specified by:
getByte
in interfaceDataValueDescriptor
- Overrides:
getByte
in classDataType
- Returns:
- The data value as a byte.
- Throws:
StandardException
- thrown on failure to convert
-
getShort
public short getShort() throws StandardException
Description copied from class:DataType
Gets the value in the data value descriptor as a short. Throws an exception if the data value is not receivable as a short.- Specified by:
getShort
in interfaceDataValueDescriptor
- Overrides:
getShort
in classDataType
- Returns:
- The data value as a short.
- Throws:
StandardException
- thrown on failure to convert
-
getLong
public long getLong() throws StandardException
Description copied from class:DataType
Gets the value in the data value descriptor as a long. Throws an exception if the data value is not receivable as a long.- Specified by:
getLong
in interfaceDataValueDescriptor
- Overrides:
getLong
in classDataType
- Returns:
- The data value as a long.
- Throws:
StandardException
- thrown on failure to convert
-
getFloat
public float getFloat() throws StandardException
Description copied from class:DataType
Gets the value in the data value descriptor as a float. Throws an exception if the data value is not receivable as a float.- Specified by:
getFloat
in interfaceDataValueDescriptor
- Overrides:
getFloat
in classDataType
- Returns:
- The data value as a float.
- Throws:
StandardException
- thrown on failure to convert
-
getDouble
public double getDouble() throws StandardException
If we have a value that is greater than the maximum double, exception is thrown. Otherwise, ok. If the value is less than can be represented by a double, ti will get set to the smallest double value.- Specified by:
getDouble
in interfaceDataValueDescriptor
- Overrides:
getDouble
in classDataType
- Returns:
- The data value as a double.
- Throws:
StandardException
- thrown on failure to convert
-
getBigDecimal
private java.math.BigDecimal getBigDecimal()
-
typeToBigDecimal
public int typeToBigDecimal()
DECIMAL implementation. Convert to a BigDecimal using getObject which will return a BigDecimal- Specified by:
typeToBigDecimal
in interfaceDataValueDescriptor
- Overrides:
typeToBigDecimal
in classNumberDataType
- Returns:
- Types.CHAR for String conversion through getString Types.DECIMAL for BigDecimal through getObject or Types.BIGINT for long conversion through getLong
-
getBoolean
public boolean getBoolean()
Description copied from class:DataType
Gets the value in the data value descriptor as a boolean. Throws an exception if the data value is not receivable as a boolean.- Specified by:
getBoolean
in interfaceDataValueDescriptor
- Overrides:
getBoolean
in classDataType
- Returns:
- The data value as a boolean.
-
getString
public java.lang.String getString()
Description copied from interface:DataValueDescriptor
Gets the value in the data value descriptor as a String. Throws an exception if the data value is not a string.- Specified by:
getString
in interfaceDataValueDescriptor
- Returns:
- The data value as a String.
-
getObject
public java.lang.Object getObject()
Description copied from class:DataType
Gets the value in the data value descriptor as a int. Throws an exception if the data value is not receivable as a int.- Specified by:
getObject
in interfaceDataValueDescriptor
- Overrides:
getObject
in classDataType
- Returns:
- The data value as a int.
-
setObject
void setObject(java.lang.Object theValue) throws StandardException
Set the value from a correctly typed BigDecimal object.- Overrides:
setObject
in classNumberDataType
- Throws:
StandardException
-
setFrom
protected void setFrom(DataValueDescriptor theValue) throws StandardException
Description copied from class:DataType
Set the value of this DataValueDescriptor based on the value of the specified DataValueDescriptor.- Overrides:
setFrom
in classDataType
- Parameters:
theValue
- The DataValueDescriptor that holds the value to which we want to set this DataValueDescriptor's value.- Throws:
StandardException
-
getLength
public int getLength()
Description copied from interface:DataValueDescriptor
Gets the length of the data value. The meaning of this is implementation-dependent. For string types, it is the number of characters in the string. For numeric types, it is the number of bytes used to store the number. This is the actual length of this value, not the length of the type it was defined as. For example, a VARCHAR value may be shorter than the declared VARCHAR (maximum) length.- Specified by:
getLength
in interfaceDataValueDescriptor
- Returns:
- The length of the data value
-
getTypeName
public java.lang.String getTypeName()
Description copied from interface:DataValueDescriptor
Get the SQL name of the datatype- Specified by:
getTypeName
in interfaceDataValueDescriptor
- Returns:
- The SQL name of the datatype
-
getTypeFormatId
public int getTypeFormatId()
Return my format identifier.- Specified by:
getTypeFormatId
in interfaceTypedFormat
- Returns:
- The identifier. (A UUID stuffed in an array of 16 bytes).
- See Also:
TypedFormat.getTypeFormatId()
-
isNull
public boolean isNull()
Description copied from interface:Storable
Return whether the value is null or not.- Specified by:
isNull
in interfaceStorable
- Returns:
- true if the value is null and false otherwise.
- See Also:
Storable.isNull()
-
writeExternal
public void writeExternal(java.io.ObjectOutput out) throws java.io.IOException
Distill the BigDecimal to a byte array and write out:- scale (zero or positive) as a byte
- length of byte array as a byte
- the byte array
- Specified by:
writeExternal
in interfacejava.io.Externalizable
- Throws:
java.io.IOException
-
readExternal
public void readExternal(java.io.ObjectInput in) throws java.io.IOException
Note the use of rawData: we reuse the array if the incoming array is the same length or smaller than the array length.- Specified by:
readExternal
in interfacejava.io.Externalizable
- Throws:
java.io.IOException
- See Also:
Externalizable.readExternal(java.io.ObjectInput)
-
restoreToNull
public void restoreToNull()
Description copied from interface:Storable
Restore this object to its (SQL)null value.- Specified by:
restoreToNull
in interfaceStorable
- See Also:
Storable.restoreToNull()
-
typeCompare
protected int typeCompare(DataValueDescriptor arg) throws StandardException
Description copied from class:NumberDataType
Compare this (not null) to a non-null value.- Specified by:
typeCompare
in classNumberDataType
- Throws:
StandardException
- Thrown on error
-
cloneValue
public DataValueDescriptor cloneValue(boolean forceMaterialization)
Description copied from interface:DataValueDescriptor
Clone this DataValueDescriptor. Results in a new object that has the same value as this but can be modified independently.Even though the objects can be modified independently regardless of the value of
forceMaterialization
, both the clone and the original may be dependent on the store state ifforceMaterialization
is set tofalse
. An example is if you need to access the value you just read usingcloneValue
after the current transaction has ended, or after the source result set has been closed.- Specified by:
cloneValue
in interfaceDataValueDescriptor
- Parameters:
forceMaterialization
- any streams representing the data value will be materialized iftrue
, the data value will be kept as a stream if possible iffalse
- Returns:
- A clone of the
DataValueDescriptor
with the same initial value as this. - See Also:
DataValueDescriptor.cloneValue(boolean)
-
getNewNull
public DataValueDescriptor getNewNull()
Description copied from interface:DataValueDescriptor
Get a new null value of the same type as this data value.- Specified by:
getNewNull
in interfaceDataValueDescriptor
- See Also:
DataValueDescriptor.getNewNull()
-
setValueFromResultSet
public void setValueFromResultSet(java.sql.ResultSet resultSet, int colNumber, boolean isNullable) throws java.sql.SQLException
Description copied from interface:DataValueDescriptor
Set the value based on the value for the specified DataValueDescriptor from the specified ResultSet.- Specified by:
setValueFromResultSet
in interfaceDataValueDescriptor
- Parameters:
resultSet
- The specified ResultSet.colNumber
- The 1-based column # into the resultSet.isNullable
- Whether or not the column is nullable (No need to call wasNull() if not)- Throws:
java.sql.SQLException
- Thrown on error- See Also:
DataValueDescriptor.setValueFromResultSet(java.sql.ResultSet, int, boolean)
-
setInto
public final void setInto(java.sql.PreparedStatement ps, int position) throws java.sql.SQLException
Set the value into a PreparedStatement.- Specified by:
setInto
in interfaceDataValueDescriptor
- Overrides:
setInto
in classDataType
- Throws:
java.sql.SQLException
- Error setting value in PreparedStatement
-
setValue
public void setValue(java.lang.String theValue) throws StandardException
WARNING there is no checking to make sure that theValue doesn't exceed the precision/scale of the current SQLDecimal. It is just assumed that the SQLDecimal is supposed to take the precision/scale of the BigDecimalized String.- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- The BigDecimal value to set this DataValueDescriptor to- Throws:
StandardException
- throws NumberFormatException when the String format is not recognized.
-
setValue
public void setValue(double theValue) throws StandardException
Description copied from class:DataType
Set the value of this DataValueDescriptor to the given double value At DataType level just throws an error lower classes will override- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- The value to set this DataValueDescriptor to- Throws:
StandardException
- Thrown on error- See Also:
NumberDataValue.setValue(java.lang.Number)
-
setValue
public void setValue(float theValue) throws StandardException
Description copied from class:DataType
Set the value of this DataValueDescriptor to the given float value At DataType level just throws an error lower classes will override- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- The value to set this DataValueDescriptor to- Throws:
StandardException
- Thrown on error- See Also:
NumberDataValue.setValue(java.lang.Number)
-
setValue
public void setValue(long theValue)
Description copied from class:DataType
Set the value of this DataValueDescriptor to the given long value At DataType level just throws an error lower classes will override- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- The value to set this DataValueDescriptor to- See Also:
NumberDataValue.setValue(java.lang.Number)
-
setValue
public void setValue(int theValue)
Description copied from class:DataType
Set the value of this DataValueDescriptor to the given int value At DataType level just throws an error lower classes will override- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- The value to set this DataValueDescriptor to- See Also:
NumberDataValue.setValue(java.lang.Number)
-
setBigDecimal
public void setBigDecimal(java.math.BigDecimal theValue) throws StandardException
Only to be called when the application sets a value using BigDecimal through setBigDecimal calls.- Specified by:
setBigDecimal
in interfaceDataValueDescriptor
- Overrides:
setBigDecimal
in classNumberDataType
- Parameters:
theValue
- required to be a BigDecimal or null.- Throws:
StandardException
-
setValue
public void setValue(java.lang.Number theValue) throws StandardException
Called when setting a DECIMAL value internally or from through a procedure or function. Handles long in addition to BigDecimal to handle identity being stored as a long but returned as a DECIMAL.- Specified by:
setValue
in interfaceNumberDataValue
- Overrides:
setValue
in classNumberDataType
- Parameters:
theValue
- An Number containing the value to set this NumberDataValue to. Null means set the value to SQL null.- Throws:
StandardException
- Thrown on error- See Also:
NumberDataValue.setValue(java.lang.Number)
-
setValue
public void setValue(boolean theValue)
Description copied from class:DataType
Set the value. At DataType level just throws an error lower classes will override- Specified by:
setValue
in interfaceDataValueDescriptor
- Overrides:
setValue
in classDataType
- Parameters:
theValue
- Contains the boolean value to set this to- See Also:
NumberDataValue.setValue(java.lang.Number)
-
typePrecedence
public int typePrecedence()
Description copied from class:DataType
Each built-in type in JSQL has a precedence. This precedence determines how to do type promotion when using binary operators. For example, float has a higher precedence than int, so when adding an int to a float, the result type is float. The precedence for some types is arbitrary. For example, it doesn't matter what the precedence of the boolean type is, since it can't be mixed with other types. But the precedence for the number types is critical. The SQL standard requires that exact numeric types be promoted to approximate numeric when one operator uses both. Also, the precedence is arranged so that one will not lose precision when promoting a type.- Specified by:
typePrecedence
in interfaceDataValueDescriptor
- Overrides:
typePrecedence
in classDataType
- Returns:
- The precedence of this type.
- See Also:
DataValueDescriptor.typePrecedence()
-
setCoreValue
private void setCoreValue(java.math.BigDecimal theValue)
-
setCoreValue
private void setCoreValue(double theValue)
-
normalize
public void normalize(DataTypeDescriptor desiredType, DataValueDescriptor source) throws StandardException
Normalization method - this method may be called when putting a value into a SQLDecimal, for example, when inserting into a SQLDecimal column. See NormalizeResultSet in execution.Note that truncation is allowed on the decimal portion of a numeric only.
- Specified by:
normalize
in interfaceDataValueDescriptor
- Overrides:
normalize
in classDataType
- Parameters:
desiredType
- The type to normalize the source column tosource
- The value to normalize- Throws:
StandardException
- Thrown for null into non-nullable column, and for truncation error
-
plus
public NumberDataValue plus(NumberDataValue addend1, NumberDataValue addend2, NumberDataValue result) throws StandardException
This method implements the + operator for DECIMAL.- Specified by:
plus
in interfaceNumberDataValue
- Overrides:
plus
in classNumberDataType
- Parameters:
addend1
- One of the addendsaddend2
- The other addendresult
- The result of a previous call to this method, null if not called yet- Returns:
- A SQLDecimal containing the result of the addition
- Throws:
StandardException
- Thrown on error
-
minus
public NumberDataValue minus(NumberDataValue left, NumberDataValue right, NumberDataValue result) throws StandardException
This method implements the - operator for "decimal - decimal".- Specified by:
minus
in interfaceNumberDataValue
- Overrides:
minus
in classNumberDataType
- Parameters:
left
- The value to be subtracted fromright
- The value to be subtractedresult
- The result of a previous call to this method, null if not called yet- Returns:
- A SQLDecimal containing the result of the subtraction
- Throws:
StandardException
- Thrown on error
-
times
public NumberDataValue times(NumberDataValue left, NumberDataValue right, NumberDataValue result) throws StandardException
This method implements the * operator for "double * double".- Specified by:
times
in interfaceNumberDataValue
- Parameters:
left
- The first value to be multipliedright
- The second value to be multipliedresult
- The result of a previous call to this method, null if not called yet- Returns:
- A SQLDecimal containing the result of the multiplication
- Throws:
StandardException
- Thrown on error
-
divide
public NumberDataValue divide(NumberDataValue dividend, NumberDataValue divisor, NumberDataValue result) throws StandardException
This method implements the / operator for BigDecimal/BigDecimal- Specified by:
divide
in interfaceNumberDataValue
- Overrides:
divide
in classNumberDataType
- Parameters:
dividend
- The numeratordivisor
- The denominatorresult
- The result of a previous call to this method, null if not called yet- Returns:
- A SQLDecimal containing the result of the division
- Throws:
StandardException
- Thrown on error
-
divide
public NumberDataValue divide(NumberDataValue dividend, NumberDataValue divisor, NumberDataValue result, int scale) throws StandardException
This method implements the / operator for BigDecimal/BigDecimal- Specified by:
divide
in interfaceNumberDataValue
- Overrides:
divide
in classNumberDataType
- Parameters:
dividend
- The numeratordivisor
- The denominatorresult
- The result of a previous call to this method, null if not called yetscale
- The result scale, if < 0, calculate the scale according to the actual values' sizes- Returns:
- A SQLDecimal containing the result of the division
- Throws:
StandardException
- Thrown on error
-
minus
public NumberDataValue minus(NumberDataValue result) throws StandardException
This method implements the unary minus operator for double.- Specified by:
minus
in interfaceNumberDataValue
- Parameters:
result
- The result of a previous call to this method, null if not called yet- Returns:
- A SQLDecimal containing the result of the division
- Throws:
StandardException
- Thrown on error
-
isNegative
protected boolean isNegative()
This method implements the isNegative method.- Specified by:
isNegative
in classNumberDataType
- Returns:
- A boolean. If this.value is negative, return true. For positive values or null, return false.
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
setWidth
public void setWidth(int desiredPrecision, int desiredScale, boolean errorOnTrunc) throws StandardException
Set the precision/scale of the to the desired values. Used when CASTing. Ideally we'd recycle normalize(), but the use is different.- Specified by:
setWidth
in interfaceVariableSizeDataValue
- Parameters:
desiredPrecision
- the desired precision -- IGNORE_PREICISION if it is to be ignored.desiredScale
- the desired scaleerrorOnTrunc
- throw error on truncation (ignored -- always thrown if we truncate the non-decimal part of the value)- Throws:
StandardException
- Thrown on non-zero truncation if errorOnTrunc is true
-
getDecimalValuePrecision
public int getDecimalValuePrecision()
Return the SQL scale of this value, number of digits after the decimal point, or zero for a whole number. This does not match the return from BigDecimal.scale() since in J2SE 5.0 onwards that can return negative scales.
-
getDecimalValueScale
public int getDecimalValueScale()
Return the SQL scale of this value, number of digits after the decimal point, or zero for a whole number. This does not match the return from BigDecimal.scale() since in J2SE 5.0 onwards that can return negative scales.
-
getBigDecimal
public static java.math.BigDecimal getBigDecimal(DataValueDescriptor value) throws StandardException
Get a BigDecimal representing the value of a DataValueDescriptor- Parameters:
value
- Non-null value to be converted- Returns:
- BigDecimal value
- Throws:
StandardException
- Invalid conversion or out of range.
-
getWholeDigits
private static int getWholeDigits(java.math.BigDecimal decimalValue)
Calculate the number of digits to the left of the decimal point of the passed in value.- Parameters:
decimalValue
- Value to get whole digits from, never null.- Returns:
- number of whole digits.
-
-