|
Business Components | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object
|
+--oracle.sql.Datum
|
+--oracle.sql.NUMBER
|
+--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(oracle.sql.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 | |
oracle.sql.NUMBER |
abs()
Finds the absolute value of this. |
oracle.sql.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. |
oracle.sql.NUMBER |
add(oracle.sql.NUMBER n)
Adds another number to this. |
oracle.sql.NUMBER |
asin()
Calculates the arc sine of this. |
oracle.sql.NUMBER |
atan()
Calculates the arc tangent of this. |
Number |
atan2(Number x)
Calculates atan(this, x). |
oracle.sql.NUMBER |
atan2(oracle.sql.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. |
oracle.sql.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. |
oracle.sql.NUMBER |
cos()
Calculates the cosine of this. |
oracle.sql.NUMBER |
cosh()
Calculates the hyperbolic cosine of this. |
oracle.sql.NUMBER |
decrement()
Subtracts 1 from this. |
oracle.sql.NUMBER |
div(oracle.sql.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. |
oracle.sql.NUMBER |
divide(oracle.sql.NUMBER n)
Divides this by another number. |
boolean |
equals(java.lang.Object other)
Tests this for equality with another object. |
oracle.sql.NUMBER |
exp()
Raises e to the power of this. |
oracle.sql.NUMBER |
floatingPointRound(int precision)
Rounds this to a specified precision. |
oracle.sql.NUMBER |
floor()
Finds the floor of this. |
static oracle.sql.NUMBER |
formattedTextToNumber(java.lang.String num,
java.lang.String fmt,
java.lang.String lang)
Interprets a string as a number. |
static oracle.sql.CustomDatumFactory |
getCustomDatumFactory()
Internal: Applications should not invoke this method. |
java.lang.Object |
getData()
Internal: Applications should not invoke this method. Converts this to an Object. |
int |
hashCode()
Computes the hash code. |
oracle.sql.NUMBER |
increment()
Adds 1 to this. |
int |
intValue()
Calls NUMBER.intValue() to convert internal Oracle Number to a Java int. |
oracle.sql.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. |
oracle.sql.NUMBER |
log(oracle.sql.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. |
oracle.sql.NUMBER |
mod(oracle.sql.NUMBER n)
Calculates the remainder of this/n. |
oracle.sql.NUMBER |
mul(oracle.sql.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. |
oracle.sql.NUMBER |
multiply(oracle.sql.NUMBER n)
Multiplies this by another number. |
oracle.sql.NUMBER |
negate()
Calculates 0 - this. |
oracle.sql.NUMBER |
pow(int exp)
Raises this to the power of exp. |
Number |
pow(Number exp)
Raises this to the power of exp. |
oracle.sql.NUMBER |
pow(oracle.sql.NUMBER exp)
Raises this to the power of exp. |
oracle.sql.NUMBER |
round(int decimal_place)
Rounds this to a specified precision. |
oracle.sql.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. |
oracle.sql.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. |
oracle.sql.NUMBER |
sin()
Calculates the sine of this. |
oracle.sql.NUMBER |
sinh()
Calculates the hyperbolic sine of this. |
oracle.sql.NUMBER |
sqroot()
Calculates the square root of this. |
oracle.sql.NUMBER |
sub(oracle.sql.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. |
oracle.sql.NUMBER |
subtract(oracle.sql.NUMBER n)
Subtracts another number from this. |
oracle.sql.NUMBER |
tan()
Calculates the tangent of this. |
oracle.sql.NUMBER |
tanh()
Calculates the hyperbolic tangent of this. |
static oracle.sql.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. |
oracle.sql.Datum |
toDatum(oracle.jdbc.driver.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. |
oracle.sql.NUMBER |
truncate(int decimal_place)
Truncates this. |
| Methods inherited from class oracle.sql.NUMBER |
booleanValue,
compareTo,
doubleValue,
e,
floatValue,
inInitialization,
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 |
| Methods inherited from class oracle.sql.Datum |
asciiStreamValue,
binaryStreamValue,
characterStreamValue,
compareBytes,
dateValue,
getBytes,
getLength,
getStream,
setBytes,
setShareBytes,
shareBytes,
timestampValue,
timeValue |
| Methods inherited from class java.lang.Object |
clone,
finalize,
getClass,
notify,
notifyAll,
wait,
wait,
wait |
| 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.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(oracle.sql.NUMBER value)
Number Domain object from an SQL
NUMBER.value - a NUMBER SQL object.SQLException - never.| Method Detail |
public static oracle.sql.CustomDatumFactory getCustomDatumFactory()
Initializes the Number Domain.
This method is invoked when JBO is initialized.
CustomDatumFactory for the
Number Domain.
public oracle.sql.Datum toDatum(oracle.jdbc.driver.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 an Object.
public void setContext(DomainOwnerInterface owner,
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 oracle.sql.NUMBER add(oracle.sql.NUMBER 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 oracle.sql.NUMBER subtract(oracle.sql.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 oracle.sql.NUMBER multiply(oracle.sql.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 oracle.sql.NUMBER divide(oracle.sql.NUMBER n)
this by another number.n - an SQL number.Number object.public oracle.sql.NUMBER abs()
this.Number object.SQLException - if the Java implementation is not available.public oracle.sql.NUMBER acos()
this.Number object.public oracle.sql.NUMBER asin()
this.Number object.public oracle.sql.NUMBER atan()
this.Number object.public Number atan2(Number x)
atan(this, x).x - an SQL number.Number object.public oracle.sql.NUMBER atan2(oracle.sql.NUMBER x)
atan(this, x).x - an SQL number.Number object.public oracle.sql.NUMBER ceil()
this.Number object.public int compareTo(int n)
n - input Oracle Numberpublic int compareTo(double n)
n - input Oracle Numberpublic oracle.sql.NUMBER cos()
this.Number object.public oracle.sql.NUMBER cosh()
this.Number object.public oracle.sql.NUMBER decrement()
1 from this.Number object.public oracle.sql.NUMBER div(oracle.sql.NUMBER n)
this by another number.n - an SQL number.Number object.public oracle.sql.NUMBER exp()
e to the power of this.Number object.public oracle.sql.NUMBER floatingPointRound(int precision)
this to a specified precision.precision - the number of significant decimal places.Number object.public oracle.sql.NUMBER floor()
this.Number object.public oracle.sql.NUMBER increment()
1 to this.Number object.public oracle.sql.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 oracle.sql.NUMBER log(oracle.sql.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 oracle.sql.NUMBER mod(oracle.sql.NUMBER n)
this/n.base - an SQL number.Number object.public oracle.sql.NUMBER mul(oracle.sql.NUMBER n)
this by another number.n - an SQL number.Number object.public oracle.sql.NUMBER negate()
0 - this.Number object.public Number pow(Number exp)
this to the power of exp.exp - an SQL number.Number object.public oracle.sql.NUMBER pow(int exp)
this to the power of exp.exp - a Java 32-bit integer.Number object.public oracle.sql.NUMBER pow(oracle.sql.NUMBER exp)
this to the power of exp.exp - a Java 32-bit integer.Number object.public oracle.sql.NUMBER round(int decimal_place)
this to a specified precision.decimal_place - the number of significant decimal places.
public oracle.sql.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 oracle.sql.NUMBER shift(int digits)
this a specified number of decimal places.
Positive values shift right, negative values shift left.digits - a Java int.public oracle.sql.NUMBER sin()
this.Number object.public oracle.sql.NUMBER sinh()
this.Number object.public oracle.sql.NUMBER sqroot()
this.Number object.public oracle.sql.NUMBER sub(oracle.sql.NUMBER n)
this.n - an SQL number.Number object.public oracle.sql.NUMBER tan()
this.Number object.public oracle.sql.NUMBER tanh()
this.Number object.public oracle.sql.NUMBER truncate(int decimal_place)
this.decimal_place - a Java integer.Number object.
public static oracle.sql.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 oracle.sql.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 | |||||||||