org.castor.cpa.persistence.sql.keygen

Class UUIDKeyGenerator

java.lang.Object

org.castor.cpa.persistence.sql.keygen.AbstractKeyGenerator

org.castor.cpa.persistence.sql.keygen.AbstractBeforeKeyGenerator

org.castor.cpa.persistence.sql.keygen.UUIDKeyGenerator

All Implemented Interfaces:

KeyGenerator

public final class UUIDKeyGenerator
extends AbstractBeforeKeyGenerator

UUID key generator.

Version:

$Revision: 8632 $ $Date: 2006-04-10 16:39:24 -0600 (Mon, 10 Apr 2006) $

Author:

Thomas Fach, Bruce Snyder, Ralf Joachim

See Also:

UUIDKeyGeneratorFactory

Constructor Summary

Constructors

Constructor and Description
UUIDKeyGenerator(PersistenceFactory factory, int sqlType) Initialize the UUID key generator.

Method Summary

Modifier and Type	Method and Description
Object	generateKey(Connection conn, String tableName, String primKeyName) Generate a new key for the specified table.
boolean	isInSameConnection() Is key generated in the same connection as INSERT? For DURING_INSERT style this method is never called.

Methods inherited from class org.castor.cpa.persistence.sql.keygen.AbstractBeforeKeyGenerator

bindIdentity, buildStatement, executeStatement

Methods inherited from class org.castor.cpa.persistence.sql.keygen.AbstractKeyGenerator

closeSeparateConnection, getSeparateConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

UUIDKeyGenerator

public UUIDKeyGenerator(PersistenceFactory factory,
                        int sqlType)
                 throws MappingException

Initialize the UUID key generator.

Parameters:

factory - Instance of PersistenceFactory to be used.

sqlType - SqlType variable to determine type.

Throws:

MappingException - An exception indicating an invalid mapping error.

Method Detail

generateKey

public Object generateKey(Connection conn,
                          String tableName,
                          String primKeyName)
                   throws PersistenceException

Generate a new key for the specified table. This method is called when a new object is about to be created. In some environments the name of the owner of the object is known, e.g. the principal in a J2EE server. This method is never called for DURING_INSERT key generators.

Parameters:

conn - An open connection within the given transaction

tableName - The table name

primKeyName - The primary key name

Returns:

A new key

Throws:

PersistenceException - An error occured talking to persistent storage

isInSameConnection

public boolean isInSameConnection()

Is key generated in the same connection as INSERT? For DURING_INSERT style this method is never called.

Returns:

{code}True{code} If this instance is in same JDBC Connection.