|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.6.0) E13403-07 |
|||||||||
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.
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 |
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 final boolean equals(DBObjectID id)
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
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 ID
public 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 object
public static DBObjectID findOriginalID(TemporaryObjectID id)
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.6.0) E13403-07 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |