org.eclipse.persistence.sequencing

Class NativeSequence

java.lang.Object

org.eclipse.persistence.sequencing.Sequence

org.eclipse.persistence.sequencing.StandardSequence

org.eclipse.persistence.sequencing.QuerySequence

org.eclipse.persistence.sequencing.NativeSequence

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class NativeSequence
extends QuerySequence

Purpose: Define a database's native sequencing mechanism.

Description Many databases have built in support for sequencing. This can be a SEQUENCE object such as in Oracle, or a auto-incrementing column such as the IDENTITY field in Sybase. For an auto-incrementing column the preallocation size is always 1. For a SEQUENCE object the preallocation size must match the SEQUENCE objects "increment by".

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NativeSequence()
NativeSequence(boolean shouldUseIdentityIfPlatformSupports)
NativeSequence(java.lang.String name) Create a new sequence with the name.
NativeSequence(java.lang.String name, boolean shouldUseIdentityIfPlatformSupports)
NativeSequence(java.lang.String name, int size) Create a new sequence with the name and sequence pre-allocation size.
NativeSequence(java.lang.String name, int size, boolean shouldUseIdentityIfPlatformSupports)
NativeSequence(java.lang.String name, int size, int initialValue)
NativeSequence(java.lang.String name, int size, int initialValue, boolean shouldUseIdentityIfPlatformSupports)

Method Summary

Methods

Modifier and Type	Method and Description
ValueReadQuery	buildSelectQueryForIdentity(java.lang.String seqName, java.lang.Integer size) INTERNAL: Returns query used to read back the value generated by Identity.
boolean	equals(java.lang.Object obj)
boolean	isNative()
void	onConnect() INTERNAL:
void	onDisconnect() INTERNAL:
void	setShouldUseIdentityIfPlatformSupports(boolean shouldUseIdentityIfPlatformSupports)
boolean	shouldUseIdentityIfPlatformSupports()

Methods inherited from class org.eclipse.persistence.sequencing.QuerySequence

getSelectQuery, getUpdateQuery, setSelectQuery, setShouldAcquireValueAfterInsert, setShouldSelectBeforeUpdate, setShouldSkipUpdate, setShouldUseTransaction, setUpdateQuery, shouldAcquireValueAfterInsert, shouldSelectBeforeUpdate, shouldSkipUpdate, shouldUseTransaction

Methods inherited from class org.eclipse.persistence.sequencing.StandardSequence

getGeneratedValue, getGeneratedVector, setInitialValue

Methods inherited from class org.eclipse.persistence.sequencing.Sequence

clone, equalNameAndSize, getDatasourcePlatform, getGeneratedValue, getGeneratedVector, getInitialValue, getName, getPreallocationSize, getQualified, getQualifier, isConnected, isCustomQualifier, isTable, isUnaryTable, onConnect, onDisconnect, setName, setPreallocationSize, setQualifier, setShouldAlwaysOverrideExistingValue, shouldAlwaysOverrideExistingValue, shouldAlwaysOverrideExistingValue, shouldUsePreallocation, toString

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NativeSequence

public NativeSequence()

NativeSequence

public NativeSequence(boolean shouldUseIdentityIfPlatformSupports)

NativeSequence

public NativeSequence(java.lang.String name)

Create a new sequence with the name.

NativeSequence

public NativeSequence(java.lang.String name,
              boolean shouldUseIdentityIfPlatformSupports)

NativeSequence

public NativeSequence(java.lang.String name,
              int size)

Create a new sequence with the name and sequence pre-allocation size.

NativeSequence

public NativeSequence(java.lang.String name,
              int size,
              boolean shouldUseIdentityIfPlatformSupports)

NativeSequence

public NativeSequence(java.lang.String name,
              int size,
              int initialValue)

NativeSequence

public NativeSequence(java.lang.String name,
              int size,
              int initialValue,
              boolean shouldUseIdentityIfPlatformSupports)

Method Detail

isNative

public boolean isNative()

Overrides:

isNative in class Sequence

setShouldUseIdentityIfPlatformSupports

public void setShouldUseIdentityIfPlatformSupports(boolean shouldUseIdentityIfPlatformSupports)

shouldUseIdentityIfPlatformSupports

public boolean shouldUseIdentityIfPlatformSupports()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class QuerySequence

onConnect

public void onConnect()

INTERNAL:

Overrides:

onConnect in class QuerySequence

onDisconnect

public void onDisconnect()

INTERNAL:

Overrides:

onDisconnect in class QuerySequence

buildSelectQueryForIdentity

public ValueReadQuery buildSelectQueryForIdentity(java.lang.String seqName,
                                         java.lang.Integer size)

INTERNAL: Returns query used to read back the value generated by Identity. In case the other version of this method (taking no parameters) returns null, this method is called every time identity NativeSequence reads. If the platform supportsIdentity then (at least) one of buildSelectQueryForIdentity methods should return non-null query.