Date class is missing in docs

Question

Hi, could anybody give me documentation to the Oracle.jbo.Domain.Date class ?
Why this is not documented?
why give this class with the same name than java.util.Date ? it really turns coding hard:
oracle.jbo.Domain.Date d1 = getMyDate();
java.util.Date d2 = d1.toDate();
it's really disgusting.
null

Answer 1

There is a bug logged regarding the missing javadoc in JDev 3.1. There was documentation for the Date in JDev 3.0. Apparently we missed it somehow. Below is the javadoc from JDev 3.0. Sorry for the long post, but I hope it helps.
oracle.jbo.domain
Class Date
java.lang.Object
|
+--oracle.sql.Datum
|
+--oracle.sql.DATE
|
+--oracle.jbo.domain.Date
public class Date
extends oracle.sql.DATE
implements DomainInterface, oracle.sql.CustomDatum, java.io.Serializable
An encapsulation of Oracle SQL DATE objects as immutable Domain objects.
Date objects consist of data (a byte array) and a Domain type code. Domain dates extend SQL dates by being convertable to and from JDBC values.
Since:
JDevloper 3.0
See Also:
Serialized Form
Fields inherited from class oracle.sql.DATE
BDA, BDAL, BDT, BHR, BHRL, BMN, BMNL, BMO, BMOL, BSC, BSCL, BYR, BYRL, HRZER0, MIZERO, MSD, SEZERO, YR0
Constructor Summary
Date()
Creates a default Date Domain object.
Date(byte[] value)
Internal: Applications should not invoke this method.
Date(Date value)
Creates a Date identical to an existing Date.
Date(java.sql.Date value)
Creates a Date Domain object from a JDBC Date.
Date(oracle.sql.DATE value)
Creates a Date Domain object from an Oracle SQL DATE.
Date(java.lang.Object value)
Creates a Date Domain object from a JDBC Object.
Date(java.lang.String value)
Creates a Date Domain object from a Java String.
Date(java.sql.Time value)
Creates a Date Domain object from a JDBC Time object.
Date(java.sql.Timestamp value)
Creates a Date Domain object from a JDBC Timestamp object.
Method Summary
oracle.sql.DATE addJulianDays(int julianDay, int julianSec)
oracle.sql.DATE addMonths(int months)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
Number diffInMonths(Date date)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
oracle.sql.NUMBER diffInMonths(oracle.sql.DATE date)
boolean equals(java.lang.Object other)
Tests this for equality with another object.
static oracle.sql.DATE fromJulianDays(int julianDay, int julianSec)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
static oracle.sql.DATE fromText(java.lang.String datestr, java.lang.String fmt, java.lang.String lang)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
static oracle.sql.DATE getCurrentDate()
Overrides the Oracle SQL method of the same name to return a Date Domain object.
static oracle.sql.CustomDatumFactory getCustomDatumFactory()
Internal: Applications should not invoke this method.
java.lang.Object getData()
Converts this to a JDBC Timestamp object.
int hashCode()
Computes a hash code for this.
oracle.sql.DATE lastDayOfMonth()
Overrides the Oracle SQL method of the same name to return a Date Domain object.
static void main(java.lang.String[] argv)
Internal: Applications should not invoke this method.
oracle.sql.DATE round(java.lang.String prec)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
oracle.sql.DATE setDayOfWeek(int day)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
oracle.sql.Datum toDatum(oracle.jdbc.driver.OracleConnection conn)
Internal: Applications should not invoke this method.
oracle.sql.NUMBER toNumber()
java.lang.String toString()
Converts this to a textual representation.
oracle.sql.DATE truncate(java.lang.String prec)
Methods inherited from class oracle.sql.DATE
checkValidity, compareTo, dateValue, diffInJulianDays, isConvertibleTo, makeJdbcArray, numberToJulianDays, stringValue, timestampValue, timeValue, toBytes, toBytes, toBytes, toBytes, toBytes, toDate, toJdbc, toJulianDays, toString, toText, toTime, toTimestamp
Methods inherited from class oracle.sql.Datum
asciiStreamValue, bigDecimalValue, binaryStreamValue, booleanValue, byteValue, characterStreamValue, doubleValue, floatValue, getBytes, getLength, getStream, intValue, longValue, setBytes, setShareBytes, shareBytes
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
Constructor Detail
Date
public Date()
Creates a default Date Domain object.
This constructor does not create a null date: use one of the NullValue() constructors.
Date
public Date(byte[] value)
Internal: Applications should not invoke this method.
Creates a Date Domain object from the given byte array.
Parameters:
value - a value returned by a previous call to getBytes() on an SQL object compatable with Date.
Date
public Date(oracle.sql.DATE value)
Creates a Date Domain object from an Oracle SQL DATE.
Parameters:
value - a DATE SQL object.
Date
public Date(Date value)
Creates a Date identical to an existing Date.
Parameters:
value - a Date Domain object.
Date
public Date(java.sql.Date value)
Creates a Date Domain object from a JDBC Date.
Parameters:
value - a DATE SQL object.
Date
public Date(java.sql.Time value)
Creates a Date Domain object from a JDBC Time object.
Parameters:
value - a Time SQL object.
Date
public Date(java.sql.Timestamp value)
Creates a Date Domain object from a JDBC Timestamp object.
Parameters:
value - a Time SQL object.
Date
public Date(java.lang.Object value)
throws java.sql.SQLException
Creates a Date Domain object from a JDBC Object.
Parameters:
value - an Object that is an instance of Date, Time, Timestamp, or String.
Throws:
java.sql.SQLException - if the object is not of one of the recognized classes.
Date
public Date(java.lang.String value)
Creates a Date Domain object from a Java String.
Parameters:
value - a textual representation of a Date.
Method Detail
getCustomDatumFactory
public static oracle.sql.CustomDatumFactory getCustomDatumFactory()
Internal: Applications should not invoke this method.
Initializes the Date Domain.
This method is invoked when JBO is initialized. Applications should not call this method directly.
Returns:
the CustomDatumFactory for the Date Domain.
toDatum
public oracle.sql.Datum toDatum(oracle.jdbc.driver.OracleConnection conn)
throws java.sql.SQLException
Internal: Applications should not invoke this method.
Converts this Date Domain object back into an SQL DATE object.
Specified by:
toDatum in interface oracle.sql.CustomDatum
Parameters:
conn - Not used.
Returns:
A Datum containing DATE object.
Throws:
SQLException - Never.
getData
public java.lang.Object getData()
Converts this to a JDBC Timestamp object.
Specified by:
getData in interface DomainInterface
Tags copied from interface: DomainInterface
Returns:
a formatted value object.
toString
public java.lang.String toString()
Converts this to a textual representation.
Overrides:
toString in class java.lang.Object
equals
public boolean equals(java.lang.Object other)
Tests this for equality with another object. The argument is converted to a Date object, if necessary.
Overrides:
equals in class oracle.sql.Datum
Parameters:
other - an arbitrary Object.
Returns:
true if conversion was successful and the converted argument is identical to this.
hashCode
public int hashCode()
Computes a hash code for this.
Overrides:
hashCode in class java.lang.Object
Returns:
the hash code of this.
addJulianDays
public oracle.sql.DATE addJulianDays(int julianDay,
int julianSec)
Overrides:
addJulianDays in class oracle.sql.DATE
Returns:
a Date Domain object.
addMonths
public oracle.sql.DATE addMonths(int months)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
Overrides:
addMonths in class oracle.sql.DATE
See Also:
"oracle.sql.DATE"
diffInMonths
public Number diffInMonths(Date date)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
See Also:
"oracle.sql.DATE"
diffInMonths
public oracle.sql.NUMBER diffInMonths(oracle.sql.DATE date)
Overrides:
diffInMonths in class oracle.sql.DATE
getCurrentDate
public static oracle.sql.DATE getCurrentDate()
Overrides the Oracle SQL method of the same name to return a Date Domain object.
See Also:
"oracle.sql.DATE"
fromJulianDays
public static oracle.sql.DATE fromJulianDays(int julianDay,
int julianSec)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
See Also:
"oracle.sql.DATE"
fromText
public static oracle.sql.DATE fromText(java.lang.String datestr,
java.lang.String fmt,
java.lang.String lang)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
See Also:
"oracle.sql.DATE"
lastDayOfMonth
public oracle.sql.DATE lastDayOfMonth()
Overrides the Oracle SQL method of the same name to return a Date Domain object.
Overrides:
lastDayOfMonth in class oracle.sql.DATE
See Also:
"oracle.sql.DATE"
round
public oracle.sql.DATE round(java.lang.String prec)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
Overrides:
round in class oracle.sql.DATE
See Also:
"oracle.sql.DATE"
setDayOfWeek
public oracle.sql.DATE setDayOfWeek(int day)
Overrides the Oracle SQL method of the same name to return a Date Domain object.
Overrides:
setDayOfWeek in class oracle.sql.DATE
See Also:
"oracle.sql.DATE"
toNumber
public oracle.sql.NUMBER toNumber()
Overrides:
toNumber in class oracle.sql.DATE
Returns:
a Date Domain object.
truncate
public oracle.sql.DATE truncate(java.lang.String prec)
Overrides:
truncate in class oracle.sql.DATE
Returns:
a Date Domain object.
main
public static void main(java.lang.String[] argv)
throws java.sql.SQLException
Internal: Applications should not invoke this method.-- Brian