oracle.apps.fnd.applcore.oaext.model
Class OATemporaryKeyFactory

java.lang.Object
  oracle.apps.fnd.applcore.oaext.model.OATemporaryKeyFactory

public class OATemporaryKeyFactory
extends java.lang.Object

used to generate Temporary Keys for an OAEntityImpl. these temporary keys are unique within a transaction, and are used as the key for newly-created entities until a permanent key is set on them. The sequence of keys is returned from the getTemporaryKey() method. There are three different kinds of attributes in the primary key:

• the varying attribute: there is always exactly one attribute guaranteed to change in value each time getTemporaryKey() is called. The OATemporaryKeyFactory chooses which key attribute will be the varying attribute, based on the types of the attributes, number attribute take precedence, then date attributes, then string attributes.
• mandatory attributes: there are zero or more attributes which are not the varying attribute and which are mandatory (i.e. NOT NULL) as specified by the isMandatory method of the AttributeDef. For these attributes, we simply invent some non-null value with each invocation of getNextAttributeList.
• non-mandatory attributes: these are any other attributes in the key, which are neither the varying attribute nor mandatory attributes. These attributes are simply populated with null values with each invocation of getTemporaryKey().

Field Summary

static int	INCREMENT_DATES_BY_DAY Increment dates by a day each time.
static int	INCREMENT_DATES_BY_SECOND Increment dates by a second each time.
static java.lang.String	RCS_ID RCS_ID.

Constructor Summary

OATemporaryKeyFactory(oracle.jbo.server.DBTransaction transaction, oracle.jbo.server.EntityDefImpl eoDef)
Constructs a temporary key factory for the given entity type within the specified transaction.

Method Summary

oracle.jbo.domain.Raw	generateGUID() Returns a randomly generated Raw object using sys_guid().
int	getDateIncrement() Gets how dates are incremented.
oracle.jbo.AttributeList	getTemporaryKey() Returns an auto-generated temporary key for the entity type specified in the constructor of this factory.
void	setDateIncrement(int inc) Determines how dates are incremented.

Methods inherited from class java.lang.Object

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

Field Detail

RCS_ID

public static final java.lang.String RCS_ID

RCS_ID.

See Also:

Constant Field Values

INCREMENT_DATES_BY_SECOND

public static final int INCREMENT_DATES_BY_SECOND

Increment dates by a second each time.

See Also:

Constant Field Values

INCREMENT_DATES_BY_DAY

public static final int INCREMENT_DATES_BY_DAY

Increment dates by a day each time.

See Also:

Constant Field Values

Constructor Detail

OATemporaryKeyFactory

public OATemporaryKeyFactory(oracle.jbo.server.DBTransaction transaction,
                             oracle.jbo.server.EntityDefImpl eoDef)

Constructs a temporary key factory for the given entity type within the specified transaction.

Parameters:

transaction - the current transaction object.

eoDef - the entity definition object to create the temporary key for.

Method Detail

setDateIncrement

public void setDateIncrement(int inc)

Determines how dates are incremented. The default is INCREMENT_DATES_BY_DAY.

Parameters:

inc - date increments. Possible values are: INCREMENT_DATES_BY_SECOND, INCREMENT_DATES_BY_DAY.

getDateIncrement

public int getDateIncrement()

Gets how dates are incremented.

Returns:

date increments. Possible values are: INCREMENT_DATES_BY_SECOND, INCREMENT_DATES_BY_DAY.

getTemporaryKey

public oracle.jbo.AttributeList getTemporaryKey()

Returns an auto-generated temporary key for the entity type specified in the constructor of this factory. The values of the the attributes of the key are guarenteed to be unique within the transaction.

Returns:

an attribute list object of name/value pairs representing the created temporary key.

generateGUID

public oracle.jbo.domain.Raw generateGUID()

Returns a randomly generated Raw object using sys_guid().

Returns:

returns a randomly generated Raw object.