|
Business Components | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
oracle.jbo.domain.Number
This class provides a lightweight wrapper for oracle.sql.NUMBER, the Java representation of the NUMBER database type. This wrapper allows an instance of the oracle.sql.NUMBER to be used as a domain object. The intent of many of the methods in this class is to wrap the corresponding method in the oracle.sql.NUMBER class such that it returns an instance of an oracle.jbo.domain.Number object.
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.
Number
objects consist of data (a byte array)
and a Domain type code.
Domain numbers extend SQL characters by being convertable to
JDBC values.
Constructor Summary |
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 . |
Method Summary |
Type | Method |
---|---|
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. |
NUMBER |
cos()
Calculates the cosine of this . |
NUMBER |
cosh()
Calculates the hyperbolic cosine of this . |
NUMBER |
decrement()
Subtracts 1 from this . |
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. |
static CustomDatumFactory |
getCustomDatumFactory()
Internal: Applications should not invoke this method. |
java.lang.Object |
getData()
Internal: Applications should not invoke this method. Converts this to a JDBC object. |
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 |
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(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(NUMBER n)
Multiplies this by another number. |
NUMBER |
negate()
Calculates 0 - this . |
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(oracle.jbo.domain.DomainOwnerInterface owner,
oracle.jbo.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(OracleConnection conn)
Internal: Applications should not invoke this method. |
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 . |
Constructor Detail |
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.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.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.public Number(java.math.BigInteger value) throws java.sql.SQLException
Number
Domain object from a
BigInteger
.value
- an arbitrarily integer.SQLException
- on overflow.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.public Number(java.lang.String value) throws java.sql.SQLException
Number
Domain object from a
Java String
.value
- a textual representation of a BigDecimal
.java.sql.SQLException
- on over/underflow of the exponent
or on overflow of the mantissa, or if the string does not represent a
valid number.public Number(boolean value)
Number
Domain object from a Boolean
.value
- true
or false
.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.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.Method Detail |
public static CustomDatumFactory getCustomDatumFactory()
Initializes the Number
Domain.
This method is invoked when JBO is initialized.
CustomDatumFactory
for the
Number
Domain.public Datum toDatum(OracleConnection conn) throws java.sql.SQLException
Converts this Number
Domain object back into an
SQL NUMBER
object.
conn
- Not used.Datum
containing NUMBER
object.SQLException
- Never.public java.lang.Object getData()
this
to a JDBC object.public void setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object ctx)
public java.lang.String toString()
this
to a fixed-point number presented as a string.public boolean equals(java.lang.Object other)
this
for equality with another object.
The argument is converted to a Number
object, if necessary.other
- an arbitrary Object
.true
if conversion was successful and the converted
argument is identical to this
.public int hashCode()
this
.public long longValue()
public int intValue()
public short shortValue()
public byte byteValue()
public java.math.BigInteger bigIntegerValue()
public java.math.BigDecimal bigDecimalValue()
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 add(NUMBER n)
this
.n
- an SQL number.Number
object.java.sql.SQLException
- if the Java implementation is not available.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(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
.Number
object.SQLException
- if the Java implementation is not available.public NUMBER acos()
this
.Number
object.public NUMBER asin()
this
.Number
object.public NUMBER atan()
this
.Number
object.public Number atan2(Number x)
atan(this, x)
.x
- an SQL number.Number
object.public NUMBER atan2(NUMBER x)
atan(this, x)
.x
- an SQL number.Number
object.java.sql.SQLException
- if the Java implementation is not available.public NUMBER ceil()
this
.Number
object.public int compareTo(int n)
n
- input Oracle Numberpublic int compareTo(double n)
n
- input Oracle Numberpublic NUMBER cos()
this
.Number
object.public NUMBER cosh()
this
.Number
object.public NUMBER decrement()
1
from this
.Number
object.public NUMBER div(NUMBER n)
this
by another number.n
- an SQL number.Number
object.public NUMBER exp()
e
to the power of this
.Number
object.public NUMBER floatingPointRound(int precision)
this
to a specified precision.precision
- the number of significant decimal places.Number
object.public NUMBER floor()
this
.Number
object.public NUMBER increment()
1
to this
.Number
object.public NUMBER ln()
this
.Number
object.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 log(NUMBER base)
this
to the specified base
.base
- an SQL number.Number
object.public Number mod(Number n)
this/n
.base
- an SQL number.Number
object.public Number mod(double n)
this/n
.base
- an SQL number.Number
object.public Number mod(int n)
this/n
.base
- an SQL number.Number
object.public NUMBER mod(NUMBER n)
this/n
.base
- an SQL number.Number
object.public NUMBER mul(NUMBER n)
this
by another number.n
- an SQL number.Number
object.public NUMBER negate()
0 - this
.Number
object.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
.exp
- a Java 32-bit integer.Number
object.public NUMBER pow(NUMBER exp)
this
to the power of exp
.exp
- a Java 32-bit integer.Number
object.public NUMBER round(int decimal_place)
this
to a specified precision.decimal_place
- the number of significant decimal places.public NUMBER scale(int left, int right, boolean[] big)
this
to a specified precision, and tests for excessive
magnitude.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.digits
- a Java int.public NUMBER sin()
this
.Number
object.public NUMBER sinh()
this
.Number
object.public NUMBER sqroot()
this
.Number
object.public NUMBER sub(NUMBER n)
this
.n
- an SQL number.Number
object.public NUMBER tan()
this
.Number
object.public NUMBER tanh()
this
.Number
object.public NUMBER truncate(int decimal_place)
this
.decimal_place
- a Java integer.Number
object.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
|
Business Components | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |