|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.3.0) E17493-04 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.javatools.db.TemporaryObjectID
public class TemporaryObjectID
Implementation of the DBObjectID interface for objects that only exist in memory. The Object ID in this case can point directly to the object.
Field Summary |
---|
Fields inherited from interface oracle.javatools.db.DBObjectID |
---|
UNSPECIFIED_TYPE |
Method Summary | |
---|---|
java.lang.Object |
copyTo(java.lang.Object target) Copies the internal state of this object to the specified copy . |
static DBObjectID |
createID(DBObject obj) Creates a new DBObjectID pointing to a specific object. |
static DBObjectID |
createID(DBObject obj, DBObject original) Creates a new DBObjectID pointing to a specific object. |
boolean |
equals(DBObjectID id, boolean strict) Whether the specified id is equivalent to this id. |
boolean |
equals(java.lang.Object obj) |
static DBObjectID |
findOriginalID(TemporaryObjectID id) Finds the original most ID in the given TemporaryObjectID's "original object" heirachy. |
static DBObject |
findOriginalObject(TemporaryObjectID id) Recurses through the original objects id and beyond (if it's another temp id) until it finds an object that has either no id, or an id that isn't a temp id. |
DBObjectID |
getParent() Returns null. |
java.lang.String |
getType() Retrieves the type of object referenced by this id. |
int |
hashCode() |
DBObject |
resolveID() Resolves the id into the object referenced. |
DBObject |
resolveOriginalID() Get the original object which this temporary one was copied from. |
static void |
setID(DBObject obj, boolean recurse) Sets a new TemporaryObjectID on an object. |
java.lang.String |
toString() |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Method Detail |
---|
public java.lang.Object copyTo(java.lang.Object target)
Copyable
this
object to the specified copy
. If copy
is null
, then this method should create a new instance of this
class and proceed to copy the internal state to the newly created object. Generally, only the persistent state of the object should be copied, but whether or not it is appropriate to copy transient properties is at the discretion of the individual implementor.
Regardless of whether the copy occurs to an existing object or to a newly created object, the return value is object to which this
object's state was copied.
There is a standard implementation pattern for the copyTo
method that helps avoid problems that arise when a Copyable
object is subclassed. The pattern is:
The parameter passed into thepublic Object copyTo( Object target ) { final <this_class> copy = target != null ? (<this_class>) target : new <this_class>(); copyToImpl( copy ); return copy; } protected final void copyToImpl( <this_class> copy ) { super.copyToImpl( copy ); // if necessary // put code here for copying the properties of <this_class> }
copyToImpl
method is the same type of this
class. The responsibility of copyToImpl
is to copy the state of this
class through direct access of the fields. The copyToImpl
method should not use getters and setters since these may be overridden, causing the state of this
class to be incompletely copied.copyTo
in interface Copyable
target
- The target object to which the state of this
object should be copied. If target
is null
, then the copyTo
method will return a new instance of this
class.this
object was copied. If the target
was non-null
, then the return value is the same as the target
object that was passed in; otherwise, the return value is a new instance of this
class.public final boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
public boolean equals(DBObjectID id, boolean strict)
DBObjectID
equals
in interface DBObjectID
id
- the DBObjectID being checked for equalitystrict
- whether a strict definition of equality should be used.public static DBObject findOriginalObject(TemporaryObjectID id) throws DBException
DBException
public java.lang.String getType()
DBObjectID
getType
in interface DBObjectID
DBObject.getType()
public DBObjectID getParent()
getParent
in interface DBObjectID
public DBObject resolveID() throws DBException
DBObjectID
resolveID
in interface DBObjectID
DBException
public DBObject resolveOriginalID() throws DBException
DBException
findOriginalObject(oracle.javatools.db.TemporaryObjectID)
public java.lang.String toString()
toString
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object
public static DBObjectID createID(DBObject obj)
obj
- the DBObject referenced by this IDpublic static void setID(DBObject obj, boolean recurse)
obj
- the DBObject referenced by this IDrecurse
- whether to set TemporaryObjectIDs on obj's descendentspublic static DBObjectID createID(DBObject obj, DBObject original)
obj
- the DBObject referenced by this IDoriginal
- the DBObject which has been copied to create the temporary objectpublic static DBObjectID findOriginalID(TemporaryObjectID id)
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.3.0) E17493-04 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |