public class Number extends NUMBER implements NativeTypeDomainInterface, java.lang.Comparable, KeyAttributeInterface, ORAData, OracleData, java.io.Serializable
The oracle.jbo.domain.Number domain class is the Java representation of the underlying database type that you must use if you want to exploit the domain feature of Business Components for Java.
BUILD_DATE, TRACE
Constructor and Description |
---|
Number()
Creates a
Number Domain object representing zero. |
Number(java.math.BigDecimal value)
Creates a
Number Domain object from a
BigDecimal . |
Number(java.math.BigInteger value)
Creates a
Number Domain object from a
BigInteger . |
Number(boolean value)
Creates a
Number Domain object from a Boolean . |
Number(byte value)
Creates a
Number Domain object from a byte . |
Number(byte[] value)
Internal: Applications should not invoke this method.
|
Number(double value)
Creates a
Number Domain object from an double . |
Number(java.lang.Double value)
Creates a
Number Domain object from an Double object. |
Number(float value)
Creates a
Number Domain object from an float . |
Number(int value)
Creates a
Number Domain object from an int . |
Number(long value)
Creates a
Number Domain object from an long . |
Number(java.lang.Long value)
Creates a
Number Domain object from an Long object. |
Number(Number value)
Creates a
Number identical to an
existing Number . |
Number(NUMBER value)
Creates a
Number Domain object from an SQL
NUMBER . |
Number(java.lang.Object value)
Creates a
Number Domain object from an arbitrary
Object . |
Number(short value)
Creates a
Number Domain object from an short . |
Number(java.lang.String value)
Creates a
Number Domain object from a
Java String . |
Number(java.lang.String value,
int precision)
Creates a
Number Domain object from a
Java String . |
Modifier and Type | Method and Description |
---|---|
NUMBER |
abs()
Finds the absolute value of
this . |
NUMBER |
acos()
Calculates the arc cosine of
this . |
Number |
add(double n)
Adds another number to
this . |
Number |
add(int n)
Adds another number to
this . |
Number |
add(Number n)
Adds another number to
this . |
NUMBER |
add(NUMBER n)
Adds another number to
this . |
NUMBER |
asin()
Calculates the arc sine of
this . |
NUMBER |
atan()
Calculates the arc tangent of
this . |
Number |
atan2(Number x)
Calculates
atan(this, x) . |
NUMBER |
atan2(NUMBER x)
Calculates
atan(this, x) . |
java.math.BigDecimal |
bigDecimalValue()
Calls NUMBER.bigDecimalValue() to convert internal Oracle Number into a Java
BigDecimal.
|
java.math.BigInteger |
bigIntegerValue()
Calls NUMBER.bigIntegerValue() to convert internal Oracle Number to a Java BigInteger.
|
byte |
byteValue()
Calls NUMBER.byteValue() to convert internal Oracle Number to a Java byte.
|
NUMBER |
ceil()
Finds the ceiling of
this . |
int |
compareTo(double n)
Returns -1 if NUMBER is less than n, 0 if NUMBER and n are equal (==),
1 if NUMBER is greater than n.
|
int |
compareTo(int n)
Returns -1 if NUMBER is less than n, 0 if NUMBER and n are equal (==),
1 if NUMBER is greater than n.
|
int |
compareTo(java.lang.Object n) |
NUMBER |
cos()
Calculates the cosine of
this . |
NUMBER |
cosh()
Calculates the hyperbolic cosine of
this . |
NUMBER |
decrement()
Subtracts
1 from this . |
NUMBER |
div(java.lang.Number n) |
NUMBER |
div(NUMBER n)
Divides
this by another number. |
Number |
divide(double n)
Divides
this by another number. |
Number |
divide(int n)
Divides
this by another number. |
Number |
divide(Number n)
Divides
this by another number. |
NUMBER |
divide(NUMBER n)
Divides
this by another number. |
boolean |
equals(java.lang.Object other)
Tests
this for equality with another object. |
NUMBER |
exp()
Raises
e to the power of this . |
NUMBER |
floatingPointRound(int precision)
Rounds
this to a specified precision. |
NUMBER |
floor()
Finds the floor of
this . |
static NUMBER |
formattedTextToNumber(java.lang.String num,
java.lang.String fmt,
java.lang.String lang)
Interprets a string as a number.
|
java.math.BigDecimal |
getBigDecimalValue()
Return a this domain's value as BigDecimal
This method may be used to access the value for this domain in EL-expressions.
|
java.lang.Object |
getData()
Internal: Applications should not invoke this method.
Converts
this to a JDBC object. |
java.lang.Object |
getNativeObject() |
static ORADataFactory |
getORADataFactory()
Internal: Applications should not invoke this method.
|
double |
getValue()
Return a this domain's value as double
This method may be used to access the value for this domain in EL-expressions.
|
int |
hashCode()
Computes the hash code.
|
NUMBER |
increment()
Adds
1 to this . |
int |
intValue()
Calls NUMBER.intValue() to convert internal Oracle Number to a Java int.
|
NUMBER |
ln()
Calculates the natural logarithm of
this . |
Number |
log(double base)
Calculates the log of
this to the specified base . |
Number |
log(int base)
Calculates the log of
this to the specified base . |
Number |
log(Number base)
Calculates the log of
this to the specified base . |
NUMBER |
log(NUMBER base)
Calculates the log of
this to the specified base . |
long |
longValue()
Calls NUMBER.longValue() to convert internal Oracle Number to a Java long.
|
static void |
main(java.lang.String[] argv)
Internal: Applications should not invoke this method.
|
NUMBER |
minus(java.lang.Number n)
Calls subtract
|
NUMBER |
minus(NUMBER n) |
Number |
mod(double n)
Calculates the remainder of
this/n . |
Number |
mod(int n)
Calculates the remainder of
this/n . |
Number |
mod(Number n)
Calculates the remainder of
this/n . |
NUMBER |
mod(NUMBER n)
Calculates the remainder of
this/n . |
NUMBER |
mul(java.lang.Number n)
Calls multiply
|
NUMBER |
mul(NUMBER n)
Multiplies
this by another number. |
Number |
multiply(double n)
Multiplies
this by another number. |
Number |
multiply(int n)
Multiplies
this by another number. |
Number |
multiply(Number n)
Multiplies
this by another number. |
Number |
multiply(java.lang.Number n) |
NUMBER |
multiply(NUMBER n)
Multiplies
this by another number. |
NUMBER |
negate()
Calculates
0 - this . |
Number |
plus(Number n)
Calls add
|
Number |
plus(java.lang.Number n)
Calls add
|
NUMBER |
pow(int exp)
Raises
this to the power of exp . |
Number |
pow(Number exp)
Raises
this to the power of exp . |
NUMBER |
pow(NUMBER exp)
Raises
this to the power of exp . |
NUMBER |
round(int decimal_place)
Rounds
this to a specified precision. |
NUMBER |
scale(int left,
int right,
boolean[] big)
Rounds
this to a specified precision, and tests for excessive
magnitude. |
void |
setContext(DomainOwnerInterface owner,
Transaction trans,
java.lang.Object ctx)
Internal: Applications should not invoke this method.
|
NUMBER |
shift(int digits)
Shift
this a specified number of decimal places. |
short |
shortValue()
Calls NUMBER.shortValue() to convert internal Oracle Number to a Java short.
|
NUMBER |
sin()
Calculates the sine of
this . |
NUMBER |
sinh()
Calculates the hyperbolic sine of
this . |
NUMBER |
sqroot()
Calculates the square root of
this . |
NUMBER |
sub(NUMBER n)
Subtracts another number from
this . |
Number |
subtract(double n)
Subtracts another number from
this . |
Number |
subtract(int n)
Subtracts another number from
this . |
Number |
subtract(Number n)
Subtracts another number from
this . |
NUMBER |
subtract(NUMBER n)
Subtracts another number from
this . |
NUMBER |
tan()
Calculates the tangent of
this . |
NUMBER |
tanh()
Calculates the hyperbolic tangent of
this . |
static NUMBER |
textToPrecisionNumber(java.lang.String num,
boolean precflag,
int preclen,
boolean scaleflag,
int scalelen,
java.lang.String lang)
Converts a string to a number with specified precision.
|
Datum |
toDatum(java.sql.Connection conn)
Internal: Applications should not invoke this method.
|
java.lang.Object |
toJDBCObject(java.sql.Connection connection) |
java.lang.String |
toString()
For testing purposes only: converts
this to a fixed-point number presented as a string. |
NUMBER |
truncate(int decimal_place)
Truncates
this . |
booleanValue, compareTo, doubleValue, e, floatValue, isConvertibleTo, isInf, isInt, isNegInf, isPosInf, isValid, isZero, ln10, makeJdbcArray, negInf, pi, posInf, sign, stringValue, toBigDecimal, toBigInteger, toBoolean, toByte, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toBytes, toDouble, toFloat, toFormattedText, toInt, toJdbc, toLong, toShort, toString, toText, zero
asciiStreamValue, binaryStreamValue, bytesEqual, characterStreamValue, compareBytes, dateValue, getBytes, getConnectionDuringExceptionHandling, getLength, getStream, isNull, setBytes, setShareBytes, shareBytes, stringValue, timestampValue, timestampValue, timeValue, timeValue, toClass
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
getBytes, setBytes
public Number()
Number
Domain object representing zero.
Use one of the NullValue()
constructors to create
a null Number
object.public Number(byte[] value)
Creates a Number
Domain object from the given byte array.
value
- a value returned by a previous call to
getBytes()
on an SQL object compatable with
Number
.public Number(byte value)
Number
Domain object from a byte
.value
- an 8-bit signed integer.public Number(int value)
Number
Domain object from an int
.value
- a 32-bit signed integer.public Number(java.lang.Long value)
Number
Domain object from an Long
object.value
- a 32-bit floating-point value.public Number(long value)
Number
Domain object from an long
.value
- a 64-bit signed integer.public Number(short value)
Number
Domain object from an short
.value
- a 16-bit signed integer.public Number(float value)
Number
Domain object from an float
.value
- a 32-bit floating-point value.public Number(double value) throws java.sql.SQLException
Number
Domain object from an double
.value
- a 64-bit floating-point value.SQLException
- on over/underflow of the exponent
or on overflow of the mantissa.java.sql.SQLException
public Number(java.lang.Double value) throws java.sql.SQLException
Number
Domain object from an Double
object.value
- a 64-bit floating-point value.SQLException
- on over/underflow of the exponent
or on overflow of the mantissa.java.sql.SQLException
public Number(java.math.BigDecimal value) throws java.sql.SQLException
Number
Domain object from a
BigDecimal
.
Limitations:
BigDecimal
distinguishes between 0 and -0.
This information will be lost in the conversion.
value
- an arbitrarily precise floating-point value.SQLException
- on over/underflow of the exponent
or on overflow of the mantissa.java.sql.SQLException
public Number(java.math.BigInteger value) throws java.sql.SQLException
Number
Domain object from a
BigInteger
.value
- an arbitrarily integer.SQLException
- on overflow.java.sql.SQLException
public Number(java.lang.String value, int precision) throws java.sql.SQLException
Number
Domain object from a
Java String
.value
- a textual representation of a fixed-point number.precision
- the maximum length of the string.SQLException
- on overflow.NumberFormatException
- if value does not represent a
valid BigDecimal
value.java.sql.SQLException
public Number(java.lang.String value) throws java.sql.SQLException
Number
Domain object from a
Java String
.value
- a textual representation of a BigDecimal
.SQLException
- on over/underflow of the exponentNumberFormatException
- if value does not represent a
valid BigDecimal
value.java.sql.SQLException
public Number(boolean value)
Number
Domain object from a Boolean
.value
- true
or false
.
The instance is 0
if value
is false
,
or 1
otherwise.public Number(java.lang.Object value) throws java.sql.SQLException
Number
Domain object from an arbitrary
Object
.
One of the other constructors for Number
is invoked,
depending on the type of the argument.value
- an arbitrary object.SQLException
- if the called method fails,
or if the argument's type is not recognized.NumberFormatException
- if value does not represent a
valid BigDecimal
value.java.sql.SQLException
public Number(Number value)
Number
identical to an
existing Number
.value
- a Number
Domain object.SQLException
- never.public Number(NUMBER value)
Number
Domain object from an SQL
NUMBER
.value
- a NUMBER
SQL object.SQLException
- never.public static ORADataFactory getORADataFactory()
Initializes the Number
Domain.
This method is invoked when JBO is initialized.
ORADataFactory
for the
Number
Domain.public Datum toDatum(java.sql.Connection conn) throws java.sql.SQLException
Converts this Number
Domain object back into an
SQL NUMBER
object.
public java.math.BigDecimal getBigDecimalValue()
public java.lang.Object getNativeObject()
getNativeObject
in interface NativeTypeDomainInterface
public double getValue()
public java.lang.Object getData()
this
to a JDBC object.getData
in interface DomainInterface
public void setContext(DomainOwnerInterface owner, Transaction trans, java.lang.Object ctx)
setContext
in interface DomainInterface
public java.lang.String toString()
this
to a fixed-point number presented as a string.toString
in class java.lang.Object
public boolean equals(java.lang.Object other)
this
for equality with another object.
The argument is converted to a Number
object, if necessary.public int hashCode()
hashCode
in class java.lang.Object
this
.public long longValue()
public int intValue()
public short shortValue()
shortValue
in class NUMBER
public byte byteValue()
public java.math.BigInteger bigIntegerValue()
bigIntegerValue
in class NUMBER
public java.math.BigDecimal bigDecimalValue()
bigDecimalValue
in class NUMBER
public Number add(Number n)
this
.n
- an SQL number.Number
object.public Number add(double n)
this
.n
- an SQL number.Number
object.public Number add(int n)
this
.n
- an SQL number.Number
object.public Number subtract(Number n)
this
.n
- an SQL number.Number
object.public Number subtract(double n)
this
.n
- a double numberNumber
object.public Number subtract(int n)
this
.n
- a int numberNumber
object.public NUMBER subtract(NUMBER n)
this
.n
- an SQL number.Number
object.public Number multiply(Number n)
this
by another number.n
- an SQL number.Number
object.public Number multiply(java.lang.Number n)
public Number plus(java.lang.Number n)
public Number multiply(double n)
this
by another number.n
- an SQL number.Number
object.public Number multiply(int n)
this
by another number.n
- an SQL number.Number
object.public NUMBER multiply(NUMBER n)
this
by another number.n
- an SQL number.Number
object.public Number divide(Number n)
this
by another number.n
- an SQL number.Number
object.public Number divide(double n)
this
by another number.n
- an SQL number.Number
object.public Number divide(int n)
this
by another number.n
- an SQL number.Number
object.public NUMBER divide(NUMBER n)
this
by another number.n
- an SQL number.Number
object.public NUMBER abs()
this
.public NUMBER acos()
this
.public NUMBER asin()
this
.public NUMBER atan()
this
.public Number atan2(Number x)
atan(this, x)
.x
- an SQL number.Number
object.public NUMBER ceil()
this
.public int compareTo(int n)
n
- input Oracle Numberpublic int compareTo(java.lang.Object n)
compareTo
in interface java.lang.Comparable
public int compareTo(double n)
n
- input Oracle Numberpublic NUMBER cos()
this
.public NUMBER cosh()
this
.public NUMBER decrement()
1
from this
.public NUMBER div(java.lang.Number n)
public NUMBER exp()
e
to the power of this
.public NUMBER floatingPointRound(int precision)
this
to a specified precision.floatingPointRound
in class NUMBER
precision
- the number of significant decimal places.Number
object.public NUMBER floor()
this
.public NUMBER increment()
1
to this
.public NUMBER ln()
this
.public Number log(Number base)
this
to the specified base
.base
- an SQL number.Number
object.public Number log(double base)
this
to the specified base
.base
- an SQL number.Number
object.public Number log(int base)
this
to the specified base
.base
- an SQL number.Number
object.public Number mod(Number n)
this/n
.n
- an SQL number.Number
object.public Number mod(double n)
this/n
.n
- an SQL number.Number
object.public Number mod(int n)
this/n
.n
- an SQL number.Number
object.public NUMBER mul(java.lang.Number n)
public NUMBER negate()
0 - this
.public Number pow(Number exp)
this
to the power of exp
.exp
- an SQL number.Number
object.public NUMBER pow(int exp)
this
to the power of exp
.public NUMBER round(int decimal_place)
this
to a specified precision.public NUMBER scale(int left, int right, boolean[] big)
this
to a specified precision, and tests for excessive
magnitude.scale
in class NUMBER
left
- the maximum number of decimal digits allowed to the left of the
decimal point. If this limit is exceeded
big
is set, but digits are not truncated.right
- the maximum number of decimal digits allowed to the right of the
decimal point. The result is rounded to this precision.
When this parameter is negative digits to the
right of the decimal are forced to zero.big
- a flag set to true
only if the number of
digits left of the decimal exceeds left
.Number
objectSQLException
- if the Java implementation is not available.public NUMBER shift(int digits)
this
a specified number of decimal places.
Positive values shift right, negative values shift left.public NUMBER sin()
this
.public NUMBER sinh()
this
.public NUMBER sqroot()
this
.public NUMBER minus(java.lang.Number n)
public NUMBER tan()
this
.public NUMBER tanh()
this
.public NUMBER truncate(int decimal_place)
this
.public static NUMBER formattedTextToNumber(java.lang.String num, java.lang.String fmt, java.lang.String lang)
num
- a string representing a numeric value.fmt
- a format string [see "Oracle 8 Server Concepts
Manual" or "CORE User's Guide Appendix D"]lang
- the NLS language the conversion is to be
performed in. If null the default language is used.Number
object.public static NUMBER textToPrecisionNumber(java.lang.String num, boolean precflag, int preclen, boolean scaleflag, int scalelen, java.lang.String lang)
num
- a string representing a numeric value.precflag
- a flag indicating that precision restriction
should be applied.preclen
- the maximum number of the decimal digits the
result may have, subject to the scale requirement.
This argument is ignored if precflag
is false
.
If the number of digits would otherwise exceed preclen
the number will be rounded.scaleflag
- a flag indicating that the scale restriction should
be applied.scalelen
- the maximum number of decimal places allowed
to the right of the decimal point. Negative values are allowed.
This argument is ignored if scaleflag
is false
.
This argument takes precedence over preclen
.
If precision is specified but scale is not, the
scale is assumed to be 0.lang
- the NLS language the conversion is to be
performed in. If null the default language is used.Number
object.public static void main(java.lang.String[] argv) throws java.sql.SQLException
java.sql.SQLException
public java.lang.Object toJDBCObject(java.sql.Connection connection) throws java.sql.SQLException
toJDBCObject
in interface OracleData
java.sql.SQLException