oracle.javatools.db

Class IDPolicy

java.lang.Object

oracle.javatools.db.IDPolicy

Direct Known Subclasses:

IDPolicy.DBLinkIDPolicy, IDPolicy.DefaultIDPolicy, IDPolicy.SameIDPolicy, TemporaryObjectID.TemporaryIDPolicy

public abstract class IDPolicy
extends java.lang.Object

When a DBObject is copied, the copy can optionally use an IDPolicy. An IDPolicy is responsible for managing the IDs of the copied object. Some example policies subclasses are provided, for example:

• IDPolicy.TemporaryIDPolicy - the copy has a temporary object ID pointing back to the original.
• IDPolicy.SameIDPolicy - the copy has the same ID as the original.
• IDPolicy.DefaultIDPolicy - the copy is given a standalone temporary object ID (i.e. it doesn't have an original object set) if the original object had an ID (i.e. it could be being referenced.

After a copy, the Map of original IDs to IDs in the copy is available from the policy.

Since:

11

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IDPolicy.DBLinkIDPolicy
static class	IDPolicy.DefaultIDPolicy IDPolicy that creates a TemporaryObjectID that does NOT point back to the original object for every object that has an ID.
static class	IDPolicy.SameIDPolicy IDPolicy that simply copies the objects ID to the copy.
static class	IDPolicy.TemporaryIDPolicy Deprecated. moved to TemporaryObjectID.TemporaryIDPolicy

Constructor Summary

Constructors

Constructor and Description
IDPolicy()

Method Summary

Modifier and Type	Method and Description
protected void	copyID(DBObject original, DBObject copy) The copyTo implementation on DBObject calls this method to create an ID for the copy, and set it.
java.util.Map<DBObjectID,DBObjectID>	getIDMap() Returns the mapping of original IDs to new IDs for the copy process.
protected abstract DBObjectID	getNewID(DBObject original, DBObject copy) Given the original object, the copy is given an ID depending on the policy.
java.util.Map<DBObjectID,DBObjectID>	getReverseIDMap() Returns the mapping of new IDs to the original object IDs for the copy process.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IDPolicy

public IDPolicy()

Method Detail

copyID

protected final void copyID(DBObject original,
                            DBObject copy)

The copyTo implementation on DBObject calls this method to create an ID for the copy, and set it. This in turn delegates to getNewID(oracle.javatools.db.DBObject, oracle.javatools.db.DBObject) to set the appropriate ID, and then maps the new ID internally.

This method cannot modify the underlying objects.

Parameters:

original -

copy -

getNewID

protected abstract DBObjectID getNewID(DBObject original,
                                       DBObject copy)

Given the original object, the copy is given an ID depending on the policy.

This method cannot modify the underlying objects.

getIDMap

public final java.util.Map<DBObjectID,DBObjectID> getIDMap()

Returns the mapping of original IDs to new IDs for the copy process.

getReverseIDMap

public final java.util.Map<DBObjectID,DBObjectID> getReverseIDMap()

Returns the mapping of new IDs to the original object IDs for the copy process.