|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object oracle.sql.Datum oracle.sql.NUMBER oracle.jbo.domain.Number
public class Number
This class extends oracle.sql.NUMBER, Oracle's Java representation of the NUMBER database type. This class 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.
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 | |
---|---|
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.String |
toString()
For testing purposes only: converts this to a fixed-point number presented as a string. |
NUMBER |
truncate(int decimal_place)
Truncates this . |
Methods inherited from class oracle.sql.NUMBER |
---|
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 |
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 |
Methods inherited from interface oracle.jbo.domain.KeyAttributeInterface |
---|
getBytes, setBytes |
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.
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 exponent
NumberFormatException
- 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.Method Detail |
---|
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.
toDatum
in interface ORAData
conn
- OracleConnection
Not used.
Datum
containing NUMBER
object.
SQLException
- Never.
java.sql.SQLException
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.
equals
in class Datum
other
- an arbitrary Object
.
true
if conversion was successful and the converted
argument is identical to this
.public int hashCode()
hashCode
in class java.lang.Object
this
.public long longValue()
longValue
in class NUMBER
public int intValue()
intValue
in class NUMBER
public short shortValue()
shortValue
in class NUMBER
public byte byteValue()
byteValue
in class NUMBER
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 add(NUMBER n)
this
.
add
in class NUMBER
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 number
Number
object.public Number subtract(int n)
this
.
n
- a int number
Number
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(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
.
abs
in class NUMBER
Number
object.
SQLException
- if the Java implementation is not available.public NUMBER acos()
this
.
acos
in class NUMBER
Number
object.public NUMBER asin()
this
.
asin
in class NUMBER
Number
object.public NUMBER atan()
this
.
atan
in class NUMBER
Number
object.public Number atan2(Number x)
atan(this, x)
.
x
- an SQL number.
Number
object.public NUMBER atan2(NUMBER x)
atan(this, x)
.
atan2
in class NUMBER
x
- an SQL number.
Number
object.
java.sql.SQLException
- if the Java implementation is not available.public NUMBER ceil()
this
.
ceil
in class NUMBER
Number
object.public int compareTo(int n)
n
- input Oracle Number
public int compareTo(java.lang.Object n)
compareTo
in interface java.lang.Comparable
public int compareTo(double n)
n
- input Oracle Number
public NUMBER cos()
this
.
cos
in class NUMBER
Number
object.public NUMBER cosh()
this
.
cosh
in class NUMBER
Number
object.public NUMBER decrement()
1
from this
.
decrement
in class NUMBER
Number
object.public NUMBER div(NUMBER n)
this
by another number.
div
in class NUMBER
n
- an SQL number.
Number
object.public NUMBER div(java.lang.Number n)
public NUMBER exp()
e
to the power of this
.
exp
in class NUMBER
Number
object.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
.
floor
in class NUMBER
Number
object.public NUMBER increment()
1
to this
.
increment
in class NUMBER
Number
object.public NUMBER ln()
this
.
ln
in class NUMBER
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
.
log
in class NUMBER
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 mod(NUMBER n)
this/n
.
mod
in class NUMBER
n
- an SQL number.
Number
object.public NUMBER mul(NUMBER n)
this
by another number.
mul
in class NUMBER
n
- an SQL number.
Number
object.public NUMBER mul(java.lang.Number n)
public NUMBER negate()
0 - this
.
negate
in class NUMBER
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
.
pow
in class NUMBER
exp
- a Java 32-bit integer.
Number
object.public NUMBER pow(NUMBER exp)
this
to the power of exp
.
pow
in class NUMBER
exp
- a Java 32-bit integer.
Number
object.public NUMBER round(int decimal_place)
this
to a specified precision.
round
in class NUMBER
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.
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
object
SQLException
- 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.
shift
in class NUMBER
digits
- a Java int.
public NUMBER sin()
this
.
sin
in class NUMBER
Number
object.public NUMBER sinh()
this
.
sinh
in class NUMBER
Number
object.public NUMBER sqroot()
this
.
sqroot
in class NUMBER
Number
object.public NUMBER sub(NUMBER n)
this
.
sub
in class NUMBER
n
- an SQL number.
Number
object.public NUMBER minus(NUMBER n)
public NUMBER minus(java.lang.Number n)
public NUMBER tan()
this
.
tan
in class NUMBER
Number
object.public NUMBER tanh()
this
.
tanh
in class NUMBER
Number
object.public NUMBER truncate(int decimal_place)
this
.
truncate
in class NUMBER
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
java.sql.SQLException
|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |