com.bea.p13n.util.jdbc
Class SequencerFactory

java.lang.Object
  com.bea.p13n.util.jdbc.SequencerFactory

public final class SequencerFactory

extends Object

This class implements the Singleton design pattern for obtaining database sequencers. A single instance of a Sequencer exists to create sequence numbers. The sequence numbers are backed by a database, but blocks of sequence numbers are cached in the Sequencer instance.

This factory creates and maintains Sequencer instances so that multiple calls to one of the createSequencer methods with the same arguments will return the same reusable instance.

See Also:

Sequencer

Method Summary

static Sequencer	createSequencer(String sequenceName) Returns the singleton Sequencer for the given sequence name backed by the sequencer's default data source.
static Sequencer	createSequencer(String sequenceName, long cacheSize) Returns the singleton Sequencer for the given sequence name and the given cache size.

Methods inherited from class java.lang.Object

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

Method Detail

createSequencer

public static Sequencer createSequencer(String sequenceName)

Returns the singleton Sequencer for the given sequence name backed by the sequencer's default data source. A Sequencer is created if needed, but if one has already been created then that instance is returned.

The sequencer expects a DataSource named "weblogic.jdbc.jts.SequencerPool" which must be associated with a non-XA connection pool.

The default cache size for this sequencer is 2000. So the Sequencer will only need to access the database every 2000 calls to getNext().

Note that if a new sequencer is created for the first time, it will not interact with the database until the first call to getNext() on the returned Sequencer. Therefore, if you have an invalid DataSource object or the sequenceName is not a valid key for the database (i.e. is too long or contains characters the database can't handle), then you may see SQLExceptions on the first call to getNext().

Parameters:

sequenceName - The name of the managed sequence. This name is used as the primary key (row name) in the database. The sequence name may not be null or an empty string.

Returns:

singleton named Sequencer

createSequencer

public static Sequencer createSequencer(String sequenceName,
                                        long cacheSize)

Returns the singleton Sequencer for the given sequence name and the given cache size. A Sequencer is created if needed, but if one has already been created then that instance is returned.

Parameters:

sequenceName - The name of the managed sequence. This name is used as the primary key (row name) in the database. The sequence name may not be null or an empty string.

Returns:

singleton named Sequencer with the given cacheSize

See Also:

createSequencer(java.lang.String)