org.apache.derbyTesting.unitTests.store

Class T_Util

java.lang.Object

org.apache.derbyTesting.unitTests.store.T_Util

public class T_Util
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
(package private) org.apache.derby.iapi.services.context.ContextService	csFactory
(package private) org.apache.derby.iapi.services.locks.LockFactory	lFactory
private int	openContainerMode
(package private) org.apache.derby.iapi.store.raw.RawStoreFactory	rsFactory

Constructor Summary

Constructors

Constructor and Description
T_Util(org.apache.derby.iapi.store.raw.RawStoreFactory rsf, org.apache.derby.iapi.services.locks.LockFactory lf, org.apache.derby.iapi.services.context.ContextService csf)

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getStringFromData(java.lang.String data, int stringLen) Return a string of stringLen characters that starts with data and is padded with nulls.
static java.util.Properties	setEncryptionParam(java.util.Properties startParams) Add in encryption parameters to the startParam if "testDataEncryption" is set to a non-null string.
void	setOpenMode(int newMode)
void	t_abort(T_TWC ctx)
void	t_abort(org.apache.derby.iapi.store.raw.Transaction t)
long	t_addContainer(T_TWC ctx, long segmentId)
long	t_addContainer(T_TWC ctx, long segmentId, int pageSize)
long	t_addContainer(T_TWC ctx, long segmentId, int pageSize, int spareSpace, int minimumRecordSize)
long	t_addContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId) Add a new container in the transaction
long	t_addContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId, int pageSize) Add a new container in the transaction with a specified page size
long	t_addContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId, int pageSize, int spareSpace, int minimumRecordSize, boolean reusableRecordId) Add a new container in the transaction with specified pageSize, spareSpace, minimumRecordSize, and reusableRecordId
long	t_addContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId, java.util.Properties tableProperties)
org.apache.derby.iapi.store.raw.Page	t_addPage(org.apache.derby.iapi.store.raw.ContainerHandle c) Add a page to a container.
static void	t_checkEmptyPage(org.apache.derby.iapi.store.raw.Page page) Take an empty page and check it does actually seem to be empty.
void	t_checkFetch(org.apache.derby.iapi.store.raw.ContainerHandle c, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data) Fetch a record from a container that is expected to exist using a record handle.
static void	t_checkFetch(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data)
static void	t_checkFetch(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data, int stringLen) Fetch a record that is expected to exist using a record handle.
static void	t_checkFetch(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, T_RawStoreRow row)
static void	t_checkFetchBySlot(org.apache.derby.iapi.store.raw.Page page, int slot, java.lang.String data, boolean deleted, boolean forUpdate)
static void	t_checkFetchCol(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, int colNum, int numCols, java.lang.String data)
static void	t_checkFetchColFromSlot(org.apache.derby.iapi.store.raw.Page page, int slot, int fieldId, org.apache.derby.iapi.types.DataValueDescriptor column, boolean forUpdate, java.lang.String data)
static void	t_checkFetchColFromSlot(org.apache.derby.iapi.store.raw.Page page, int slot, int fieldId, org.apache.derby.iapi.types.DataValueDescriptor column, boolean forUpdate, java.lang.String data, int stringLen)
void	t_checkFetchDeleted(org.apache.derby.iapi.store.raw.ContainerHandle c, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data) Fetch a deleted record from a container using a record handle.
void	t_checkFetchFail(org.apache.derby.iapi.store.raw.ContainerHandle c, org.apache.derby.iapi.store.raw.RecordHandle rh) Check to make sure record is NOT there
static org.apache.derby.iapi.store.raw.RecordHandle	t_checkFetchFirst(org.apache.derby.iapi.store.raw.Page page, java.lang.String data)
static org.apache.derby.iapi.store.raw.RecordHandle	t_checkFetchLast(org.apache.derby.iapi.store.raw.Page page, java.lang.String data)
static org.apache.derby.iapi.store.raw.RecordHandle	t_checkFetchNext(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data)
static org.apache.derby.iapi.store.raw.RecordHandle	t_checkFetchPrevious(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, java.lang.String data)
static void	t_checkFieldCount(org.apache.derby.iapi.store.raw.Page page, int slot, int count)
void	t_checkGetLatchedPage(org.apache.derby.iapi.store.raw.ContainerHandle c, long pageNumber) Check that it's not possible to get a page which is already latched by the same transaction.
void	t_checkInvalidSavePoint(T_TWC ctx, java.lang.String name)
static void	t_checkInvalidSavePoint(org.apache.derby.iapi.store.raw.Transaction t, java.lang.String name) Negative test - check that an invalid savepoint is detected.
void	t_checkNullLockCount(org.apache.derby.iapi.store.raw.Transaction t)
static void	t_checkPageNumber(org.apache.derby.iapi.store.raw.Page page, long pageNumber)
static void	t_checkRecordCount(org.apache.derby.iapi.store.raw.Page page, int count, int nonDeleted)
void	t_checkStringLengthFetch(org.apache.derby.iapi.store.raw.Page page, int slot, int expectedLength) Check to make sure a row (possibly with overflow) is of the correct length
void	t_checkUpdateCol(org.apache.derby.iapi.store.raw.Page page, org.apache.derby.iapi.store.raw.RecordHandle rh, int colNum, int numCols, java.lang.String data) Using sparse representation: Update a column of a record and check resulting value.
void	t_close(T_TWC ctx)
void	t_commit(T_TWC ctx)
void	t_commit(org.apache.derby.iapi.store.raw.Transaction t)
void	t_dropContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId, long containerId) Drop a container
void	t_genRandomFile(java.lang.String fileName, java.lang.String mode, int size) Lazy people's random file generator: Generate a random file with specified name and file size
org.apache.derby.iapi.store.raw.Page	t_getLastPage(org.apache.derby.iapi.store.raw.ContainerHandle c) Get the last page in a container.
org.apache.derby.iapi.store.raw.Page	t_getPage(org.apache.derby.iapi.store.raw.ContainerHandle c, long pageNumber) Get a specific page in a container.
org.apache.derby.iapi.store.raw.RecordHandle	t_insert(org.apache.derby.iapi.store.raw.ContainerHandle c, T_RawStoreRow row) Insert a record on the last page, if the row doesn't fit on the last page create a new page and insert there.
static org.apache.derby.iapi.store.raw.RecordHandle	t_insert(org.apache.derby.iapi.store.raw.Page page, T_RawStoreRow row) Call page.insert() and ensure that the return record handle is not null.
static org.apache.derby.iapi.store.raw.RecordHandle	t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page, int slot, T_RawStoreRow row) Call page.insert() and ensure that the return record handle is not null.
static org.apache.derby.iapi.store.raw.RecordHandle	t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page, int slot, T_RawStoreRow row, byte insertFlag) Call page.insert() and ensure that the return record handle is not null.
static org.apache.derby.iapi.store.raw.RecordHandle	t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page, int slot, T_RawStoreRow row, byte insertFlag, int overflowThreshold) Call page.insert() and ensure that the return record handle is not null.
org.apache.derby.iapi.store.raw.ContainerHandle	t_openContainer(T_TWC ctx, long segmentId, long containerId, boolean forUpdate)
org.apache.derby.iapi.store.raw.ContainerHandle	t_openContainer(org.apache.derby.iapi.store.raw.Transaction t, long segmentId, long containerId, boolean forUpdate) Open a container.
static void	t_readOnlySlotOutOfRange(org.apache.derby.iapi.store.raw.Page page, int slot)
void	t_removePage(org.apache.derby.iapi.store.raw.ContainerHandle c, org.apache.derby.iapi.store.raw.Page p) Remove a page from a container.
org.apache.derby.iapi.store.raw.Transaction	t_startGlobalTransaction(int format_id, byte[] global_id, byte[] branch_id)
org.apache.derby.iapi.store.raw.Transaction	t_startInternalTransaction()
org.apache.derby.iapi.store.raw.Transaction	t_startTransaction()
T_TWC	t_startTransactionWithContext()
void	t_update(org.apache.derby.iapi.store.raw.ContainerHandle c, org.apache.derby.iapi.store.raw.RecordHandle rh, T_RawStoreRow row) Update a record.
static void	t_updateSlotOutOfRange(org.apache.derby.iapi.store.raw.Page page, int slot)
static void	t_wait(int milliSecond) Make this thread wait a bit, probably for post commit to finish

Methods inherited from class java.lang.Object

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

Field Detail

rsFactory

org.apache.derby.iapi.store.raw.RawStoreFactory rsFactory

lFactory

org.apache.derby.iapi.services.locks.LockFactory lFactory

csFactory

org.apache.derby.iapi.services.context.ContextService csFactory

openContainerMode

private int openContainerMode

Constructor Detail

T_Util

public T_Util(org.apache.derby.iapi.store.raw.RawStoreFactory rsf,
              org.apache.derby.iapi.services.locks.LockFactory lf,
              org.apache.derby.iapi.services.context.ContextService csf)

Method Detail

setOpenMode

public void setOpenMode(int newMode)

t_checkNullLockCount

public void t_checkNullLockCount(org.apache.derby.iapi.store.raw.Transaction t)
                          throws T_Fail

Throws:

T_Fail

t_checkPageNumber

public static void t_checkPageNumber(org.apache.derby.iapi.store.raw.Page page,
                                     long pageNumber)
                              throws T_Fail

Throws:

T_Fail

t_checkRecordCount

public static void t_checkRecordCount(org.apache.derby.iapi.store.raw.Page page,
                                      int count,
                                      int nonDeleted)
                               throws T_Fail,
                                      org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFieldCount

public static void t_checkFieldCount(org.apache.derby.iapi.store.raw.Page page,
                                     int slot,
                                     int count)
                              throws T_Fail,
                                     org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetch

public static void t_checkFetch(org.apache.derby.iapi.store.raw.Page page,
                                org.apache.derby.iapi.store.raw.RecordHandle rh,
                                java.lang.String data,
                                int stringLen)
                         throws T_Fail,
                                org.apache.derby.iapi.error.StandardException

Fetch a record that is expected to exist using a record handle. The record has a T_RawStoreRow of 1 column and this column as value as specified by data, which could be null. Calls recordExists() before fetch to ensure that the record is there.

Parameters:

page - the page in question

rh - the record handle

data - the string value that is expected in the row

Throws:

T_Fail - Implementation failed expectation

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.recordExists(org.apache.derby.iapi.store.raw.RecordHandle, boolean)

t_checkFetch

public static void t_checkFetch(org.apache.derby.iapi.store.raw.Page page,
                                org.apache.derby.iapi.store.raw.RecordHandle rh,
                                java.lang.String data)
                         throws T_Fail,
                                org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetch

public void t_checkFetch(org.apache.derby.iapi.store.raw.ContainerHandle c,
                         org.apache.derby.iapi.store.raw.RecordHandle rh,
                         java.lang.String data)
                  throws T_Fail,
                         org.apache.derby.iapi.error.StandardException

Fetch a record from a container that is expected to exist using a record handle. Calls recordExists() before fetch to ensure that the record is there.

Throws:

T_Fail - Implementation failed expectation

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.recordExists(org.apache.derby.iapi.store.raw.RecordHandle, boolean)

t_checkFetchFail

public void t_checkFetchFail(org.apache.derby.iapi.store.raw.ContainerHandle c,
                             org.apache.derby.iapi.store.raw.RecordHandle rh)
                      throws T_Fail,
                             org.apache.derby.iapi.error.StandardException

Check to make sure record is NOT there

Throws:

T_Fail - Implementation failed expectation

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_checkFetchDeleted

public void t_checkFetchDeleted(org.apache.derby.iapi.store.raw.ContainerHandle c,
                                org.apache.derby.iapi.store.raw.RecordHandle rh,
                                java.lang.String data)
                         throws T_Fail,
                                org.apache.derby.iapi.error.StandardException

Fetch a deleted record from a container using a record handle.

Throws:

T_Fail - Implementation failed expectation

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.recordExists(org.apache.derby.iapi.store.raw.RecordHandle, boolean), Page.fetchFromSlot(org.apache.derby.iapi.store.raw.RecordHandle, int, java.lang.Object[], org.apache.derby.iapi.store.raw.FetchDescriptor, boolean)

t_checkFetch

public static void t_checkFetch(org.apache.derby.iapi.store.raw.Page page,
                                org.apache.derby.iapi.store.raw.RecordHandle rh,
                                T_RawStoreRow row)
                         throws T_Fail,
                                org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchCol

public static void t_checkFetchCol(org.apache.derby.iapi.store.raw.Page page,
                                   org.apache.derby.iapi.store.raw.RecordHandle rh,
                                   int colNum,
                                   int numCols,
                                   java.lang.String data)
                            throws T_Fail,
                                   org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchFirst

public static org.apache.derby.iapi.store.raw.RecordHandle t_checkFetchFirst(org.apache.derby.iapi.store.raw.Page page,
                                                                             java.lang.String data)
                                                                      throws T_Fail,
                                                                             org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchNext

public static org.apache.derby.iapi.store.raw.RecordHandle t_checkFetchNext(org.apache.derby.iapi.store.raw.Page page,
                                                                            org.apache.derby.iapi.store.raw.RecordHandle rh,
                                                                            java.lang.String data)
                                                                     throws T_Fail,
                                                                            org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchPrevious

public static org.apache.derby.iapi.store.raw.RecordHandle t_checkFetchPrevious(org.apache.derby.iapi.store.raw.Page page,
                                                                                org.apache.derby.iapi.store.raw.RecordHandle rh,
                                                                                java.lang.String data)
                                                                         throws T_Fail,
                                                                                org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchLast

public static org.apache.derby.iapi.store.raw.RecordHandle t_checkFetchLast(org.apache.derby.iapi.store.raw.Page page,
                                                                            java.lang.String data)
                                                                     throws T_Fail,
                                                                            org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchBySlot

public static void t_checkFetchBySlot(org.apache.derby.iapi.store.raw.Page page,
                                      int slot,
                                      java.lang.String data,
                                      boolean deleted,
                                      boolean forUpdate)
                               throws T_Fail,
                                      org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkFetchColFromSlot

public static void t_checkFetchColFromSlot(org.apache.derby.iapi.store.raw.Page page,
                                           int slot,
                                           int fieldId,
                                           org.apache.derby.iapi.types.DataValueDescriptor column,
                                           boolean forUpdate,
                                           java.lang.String data,
                                           int stringLen)
                                    throws org.apache.derby.iapi.error.StandardException,
                                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_checkFetchColFromSlot

public static void t_checkFetchColFromSlot(org.apache.derby.iapi.store.raw.Page page,
                                           int slot,
                                           int fieldId,
                                           org.apache.derby.iapi.types.DataValueDescriptor column,
                                           boolean forUpdate,
                                           java.lang.String data)
                                    throws org.apache.derby.iapi.error.StandardException,
                                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_checkEmptyPage

public static void t_checkEmptyPage(org.apache.derby.iapi.store.raw.Page page)
                             throws T_Fail,
                                    org.apache.derby.iapi.error.StandardException

Take an empty page and check it does actually seem to be empty.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_readOnlySlotOutOfRange

public static void t_readOnlySlotOutOfRange(org.apache.derby.iapi.store.raw.Page page,
                                            int slot)
                                     throws T_Fail,
                                            org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_updateSlotOutOfRange

public static void t_updateSlotOutOfRange(org.apache.derby.iapi.store.raw.Page page,
                                          int slot)
                                   throws T_Fail,
                                          org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_checkInvalidSavePoint

public static void t_checkInvalidSavePoint(org.apache.derby.iapi.store.raw.Transaction t,
                                           java.lang.String name)
                                    throws T_Fail,
                                           org.apache.derby.iapi.error.StandardException

Negative test - check that an invalid savepoint is detected.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_checkInvalidSavePoint

public void t_checkInvalidSavePoint(T_TWC ctx,
                                    java.lang.String name)
                             throws T_Fail,
                                    org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

t_startTransaction

public org.apache.derby.iapi.store.raw.Transaction t_startTransaction()
                                                               throws org.apache.derby.iapi.error.StandardException,
                                                                      T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_startGlobalTransaction

public org.apache.derby.iapi.store.raw.Transaction t_startGlobalTransaction(int format_id,
                                                                            byte[] global_id,
                                                                            byte[] branch_id)
                                                                     throws org.apache.derby.iapi.error.StandardException,
                                                                            T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_startTransactionWithContext

public T_TWC t_startTransactionWithContext()
                                    throws org.apache.derby.iapi.error.StandardException,
                                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_startInternalTransaction

public org.apache.derby.iapi.store.raw.Transaction t_startInternalTransaction()
                                                                       throws org.apache.derby.iapi.error.StandardException,
                                                                              T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_commit

public void t_commit(org.apache.derby.iapi.store.raw.Transaction t)
              throws org.apache.derby.iapi.error.StandardException,
                     T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_commit

public void t_commit(T_TWC ctx)
              throws org.apache.derby.iapi.error.StandardException,
                     T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_close

public void t_close(T_TWC ctx)
             throws org.apache.derby.iapi.error.StandardException,
                    T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_abort

public void t_abort(org.apache.derby.iapi.store.raw.Transaction t)
             throws org.apache.derby.iapi.error.StandardException,
                    T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_abort

public void t_abort(T_TWC ctx)
             throws org.apache.derby.iapi.error.StandardException,
                    T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_addContainer

public long t_addContainer(org.apache.derby.iapi.store.raw.Transaction t,
                           long segmentId)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Add a new container in the transaction

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_addContainer

public long t_addContainer(T_TWC ctx,
                           long segmentId)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_addContainer

public long t_addContainer(org.apache.derby.iapi.store.raw.Transaction t,
                           long segmentId,
                           int pageSize)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Add a new container in the transaction with a specified page size

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_addContainer

public long t_addContainer(T_TWC ctx,
                           long segmentId,
                           int pageSize)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_addContainer

public long t_addContainer(org.apache.derby.iapi.store.raw.Transaction t,
                           long segmentId,
                           java.util.Properties tableProperties)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_addContainer

public long t_addContainer(org.apache.derby.iapi.store.raw.Transaction t,
                           long segmentId,
                           int pageSize,
                           int spareSpace,
                           int minimumRecordSize,
                           boolean reusableRecordId)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Add a new container in the transaction with specified pageSize, spareSpace, minimumRecordSize, and reusableRecordId

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_addContainer

public long t_addContainer(T_TWC ctx,
                           long segmentId,
                           int pageSize,
                           int spareSpace,
                           int minimumRecordSize)
                    throws org.apache.derby.iapi.error.StandardException,
                           T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_openContainer

public org.apache.derby.iapi.store.raw.ContainerHandle t_openContainer(org.apache.derby.iapi.store.raw.Transaction t,
                                                                       long segmentId,
                                                                       long containerId,
                                                                       boolean forUpdate)
                                                                throws org.apache.derby.iapi.error.StandardException,
                                                                       T_Fail

Open a container.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_openContainer

public org.apache.derby.iapi.store.raw.ContainerHandle t_openContainer(T_TWC ctx,
                                                                       long segmentId,
                                                                       long containerId,
                                                                       boolean forUpdate)
                                                                throws org.apache.derby.iapi.error.StandardException,
                                                                       T_Fail

Throws:

org.apache.derby.iapi.error.StandardException

T_Fail

t_dropContainer

public void t_dropContainer(org.apache.derby.iapi.store.raw.Transaction t,
                            long segmentId,
                            long containerId)
                     throws org.apache.derby.iapi.error.StandardException,
                            T_Fail

Drop a container

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_getLastPage

public org.apache.derby.iapi.store.raw.Page t_getLastPage(org.apache.derby.iapi.store.raw.ContainerHandle c)
                                                   throws T_Fail,
                                                          org.apache.derby.iapi.error.StandardException

Get the last page in a container. Always returns a valid page or null if there is no page in the container.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_getPage

public org.apache.derby.iapi.store.raw.Page t_getPage(org.apache.derby.iapi.store.raw.ContainerHandle c,
                                                      long pageNumber)
                                               throws T_Fail,
                                                      org.apache.derby.iapi.error.StandardException

Get a specific page in a container. Always returns a valid page.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_addPage

public org.apache.derby.iapi.store.raw.Page t_addPage(org.apache.derby.iapi.store.raw.ContainerHandle c)
                                               throws T_Fail,
                                                      org.apache.derby.iapi.error.StandardException

Add a page to a container.

Throws:

T_Fail - Unexpected behaviour from the API

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_removePage

public void t_removePage(org.apache.derby.iapi.store.raw.ContainerHandle c,
                         org.apache.derby.iapi.store.raw.Page p)
                  throws T_Fail,
                         org.apache.derby.iapi.error.StandardException

Remove a page from a container.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_checkGetLatchedPage

public void t_checkGetLatchedPage(org.apache.derby.iapi.store.raw.ContainerHandle c,
                                  long pageNumber)
                           throws org.apache.derby.iapi.error.StandardException,
                                  T_Fail

Check that it's not possible to get a page which is already latched by the same transaction.

Parameters:

c - a container handle

pageNumber - the page number to check

Throws:

org.apache.derby.iapi.error.StandardException - if an unexpected error occurs

T_Fail - if the test fails

t_insert

public static org.apache.derby.iapi.store.raw.RecordHandle t_insert(org.apache.derby.iapi.store.raw.Page page,
                                                                    T_RawStoreRow row)
                                                             throws T_Fail,
                                                                    org.apache.derby.iapi.error.StandardException

Call page.insert() and ensure that the return record handle is not null. This assumes the caller has called spaceForInsert.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.insert(java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, byte, int)

t_insertAtSlot

public static org.apache.derby.iapi.store.raw.RecordHandle t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page,
                                                                          int slot,
                                                                          T_RawStoreRow row)
                                                                   throws T_Fail,
                                                                          org.apache.derby.iapi.error.StandardException

Call page.insert() and ensure that the return record handle is not null. This assumes the caller has called spaceForInsert.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.insert(java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, byte, int)

t_insertAtSlot

public static org.apache.derby.iapi.store.raw.RecordHandle t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page,
                                                                          int slot,
                                                                          T_RawStoreRow row,
                                                                          byte insertFlag)
                                                                   throws T_Fail,
                                                                          org.apache.derby.iapi.error.StandardException

Call page.insert() and ensure that the return record handle is not null. This assumes the caller has called spaceForInsert.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.insert(java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, byte, int)

t_insertAtSlot

public static org.apache.derby.iapi.store.raw.RecordHandle t_insertAtSlot(org.apache.derby.iapi.store.raw.Page page,
                                                                          int slot,
                                                                          T_RawStoreRow row,
                                                                          byte insertFlag,
                                                                          int overflowThreshold)
                                                                   throws T_Fail,
                                                                          org.apache.derby.iapi.error.StandardException

Call page.insert() and ensure that the return record handle is not null. This assumes the caller has called spaceForInsert.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.insert(java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, byte, int)

t_insert

public org.apache.derby.iapi.store.raw.RecordHandle t_insert(org.apache.derby.iapi.store.raw.ContainerHandle c,
                                                             T_RawStoreRow row)
                                                      throws T_Fail,
                                                             org.apache.derby.iapi.error.StandardException

Insert a record on the last page, if the row doesn't fit on the last page create a new page and insert there.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.insert(java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, byte, int)

t_update

public void t_update(org.apache.derby.iapi.store.raw.ContainerHandle c,
                     org.apache.derby.iapi.store.raw.RecordHandle rh,
                     T_RawStoreRow row)
              throws T_Fail,
                     org.apache.derby.iapi.error.StandardException

Update a record.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.updateAtSlot(int, java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet)

t_checkUpdateCol

public void t_checkUpdateCol(org.apache.derby.iapi.store.raw.Page page,
                             org.apache.derby.iapi.store.raw.RecordHandle rh,
                             int colNum,
                             int numCols,
                             java.lang.String data)
                      throws T_Fail,
                             org.apache.derby.iapi.error.StandardException

Using sparse representation: Update a column of a record and check resulting value.

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

See Also:

Page.updateAtSlot(int, java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet)

t_checkStringLengthFetch

public void t_checkStringLengthFetch(org.apache.derby.iapi.store.raw.Page page,
                                     int slot,
                                     int expectedLength)
                              throws T_Fail,
                                     org.apache.derby.iapi.error.StandardException

Check to make sure a row (possibly with overflow) is of the correct length

Throws:

T_Fail - Record handle returned is null.

org.apache.derby.iapi.error.StandardException - Unexpected exception from the implementation

t_genRandomFile

public void t_genRandomFile(java.lang.String fileName,
                            java.lang.String mode,
                            int size)
                     throws T_Fail

Lazy people's random file generator: Generate a random file with specified name and file size

Throws:

T_Fail - Record handle returned is null.

getStringFromData

public static java.lang.String getStringFromData(java.lang.String data,
                                                 int stringLen)

Return a string of stringLen characters that starts with data and is padded with nulls.

t_wait

public static void t_wait(int milliSecond)

Make this thread wait a bit, probably for post commit to finish

setEncryptionParam

public static java.util.Properties setEncryptionParam(java.util.Properties startParams)

Add in encryption parameters to the startParam if "testDataEncryption" is set to a non-null string.