org.castor.ddlgen
Interface KeyGeneratorFactory

All Known Implementing Classes:

Db2SequenceKeyGeneratorFactory, HighLowKeyGeneratorFactory, HsqlSequenceKeyGeneratorFactory, IdentityKeyGeneratorFactory, MaxKeyGeneratorFactory, OracleSequenceKeyGeneratorFactory, PostgresqlSequenceKeyGeneratorFactory, SapdbSequenceKeyGeneratorFactory, SequenceKeyGeneratorFactory, UUIDKeyGeneratorFactory

public interface KeyGeneratorFactory

Interface to be implemented by all key generator factories.

Since:

1.1

Version:

$Revision: 8993 $ $Date: 2011-08-02 01:28:52 +0200 (Di, 02 Aug 2011) $

Author:

Le Duc Bao, Ralf Joachim

Method Summary

KeyGenerator	createKeyGenerator() Create a default key generator instance with the algorithm the factory is responsible for.
KeyGenerator	createKeyGenerator(KeyGeneratorDef definition) Create a key generator instance from the given definition with the algorithm the factory is responsible for.
String	getAlgorithmName() Get name of key generator algorithm.
boolean	hasMandatoryParameters() Does the algorithm has mandatory parameters and therefore requires a key generator definition in mapping file?

Method Detail

getAlgorithmName

String getAlgorithmName()

Get name of key generator algorithm.

Returns:

Name of key generator algorithm.

hasMandatoryParameters

boolean hasMandatoryParameters()

Does the algorithm has mandatory parameters and therefore requires a key generator definition in mapping file?

Returns:

true if algorithm has mandatory parameters and therefore requires a key generator definition in mapping file. false if algorithm does not require parameters or has only optional parameters.

createKeyGenerator

KeyGenerator createKeyGenerator()
                                throws GeneratorException

Create a default key generator instance with the algorithm the factory is responsible for. This is only possible for those algorithms that do not require mandatory parameters.

Returns:

A default key generator instance with the algorithm the factory is responsible for.

Throws:

GeneratorException - If creation of default key generator is not possible due to required mandatory parameters.

createKeyGenerator

KeyGenerator createKeyGenerator(KeyGeneratorDef definition)
                                throws GeneratorException

Create a key generator instance from the given definition with the algorithm the factory is responsible for.

Parameters:

definition - The definition to initialize the key generator.

Returns:

A key generator instance initialized with given definition with the algorithm the factory is responsible for.

Throws:

GeneratorException - If failed to create a key generator instance.