org.apache.derbyTesting.functionTests.tests.upgradeTests

Class PhaseChanger

java.lang.Object

junit.framework.Assert

junit.extensions.TestDecorator

junit.extensions.TestSetup

org.apache.derbyTesting.junit.BaseTestSetup

org.apache.derbyTesting.functionTests.tests.upgradeTests.PhaseChanger

All Implemented Interfaces:

junit.framework.Test

final class PhaseChanger
extends BaseTestSetup

Decorator that sets the phase of the upgrade process for a suite of upgrade tests.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.ClassLoader	loader
private int	phase
private java.lang.ClassLoader	previousLoader
private boolean	trace
private java.lang.String	upgradeAttributes
private int[]	version

Fields inherited from class junit.extensions.TestDecorator

fTest

Constructor Summary

Constructors

Constructor and Description
PhaseChanger(junit.framework.Test test, int phase, java.lang.ClassLoader loader, int[] version, boolean useCreateOnUpgrade)

Method Summary

Modifier and Type	Method and Description
private void	clearDerby23ThreadLocals(java.lang.Object contextService) Clear some fields in ContextService to allow the engine to be garbage collected.
private void	clearDerby4895ThreadLocal() Clear a static ThreadLocal field in TableDescriptor so that the engine classes can be garbage collected when they are no longer used.
private static void	clearField(java.lang.Class cls, java.lang.String name, java.lang.Object instance) Clear a field that is possibly private or final.
private void	deregisterDriver() Make sure the JDBC driver in the class loader associated with this version is deregistered.
private java.lang.Object	getDerby23ContextService() Get a handle to the ContextService in the old engine if the version is affected by DERBY-23.
protected void	setUp() Set the phase and boot the database, creating it or upgrading it as required.
protected void	tearDown() Shutdown the database engine and reset the class loader.

Methods inherited from class org.apache.derbyTesting.junit.BaseTestSetup

run

Methods inherited from class junit.extensions.TestDecorator

basicRun, countTestCases, getTest, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, failNotEquals, failNotSame, failSame, format

Methods inherited from class java.lang.Object

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

Field Detail

phase

private final int phase

version

private final int[] version

loader

private java.lang.ClassLoader loader

previousLoader

private java.lang.ClassLoader previousLoader

trace

private boolean trace

upgradeAttributes

private java.lang.String upgradeAttributes

Constructor Detail

PhaseChanger

public PhaseChanger(junit.framework.Test test,
                    int phase,
                    java.lang.ClassLoader loader,
                    int[] version,
                    boolean useCreateOnUpgrade)

Method Detail

setUp

protected void setUp()
              throws java.sql.SQLException

Set the phase and boot the database, creating it or upgrading it as required. The thread context class loader is changed to point to the old jar files if required for the phase.

Overrides:

setUp in class junit.extensions.TestSetup

Throws:

java.sql.SQLException

tearDown

protected void tearDown()
                 throws java.lang.Exception

Shutdown the database engine and reset the class loader.

Overrides:

tearDown in class junit.extensions.TestSetup

Throws:

java.sql.SQLException - if the engine couldn't be stopped

java.lang.Exception

deregisterDriver

private void deregisterDriver()
                       throws java.lang.Exception

Make sure the JDBC driver in the class loader associated with this version is deregistered. This is a workaround for DERBY-2905, which affected Derby 10.2 - 10.7, and it is needed to make the old engine classes eligible for garbage collection.

Throws:

java.lang.Exception

clearDerby4895ThreadLocal

private void clearDerby4895ThreadLocal()
                                throws java.lang.Exception

Clear a static ThreadLocal field in TableDescriptor so that the engine classes can be garbage collected when they are no longer used. This is a workaround for DERBY-4895, which affects Derby 10.5 and 10.6.

Throws:

java.lang.Exception

clearField

private static void clearField(java.lang.Class cls,
                               java.lang.String name,
                               java.lang.Object instance)
                        throws java.lang.Exception

Clear a field that is possibly private or final.

Parameters:

cls - the class in which the field lives

name - the name of the field to clear

instance - the instance whose field should be cleared, or null if the field is static

Throws:

java.lang.Exception

getDerby23ContextService

private java.lang.Object getDerby23ContextService()
                                           throws java.lang.Exception

Get a handle to the ContextService in the old engine if the version is affected by DERBY-23.

Returns:

the ContextService, if this version is affected by DERBY-23, or null otherwise

Throws:

java.lang.Exception

clearDerby23ThreadLocals

private void clearDerby23ThreadLocals(java.lang.Object contextService)
                               throws java.lang.Exception

Clear some fields in ContextService to allow the engine to be garbage collected. This is a workaround for DERBY-23.

Parameters:

contextService - the context service for an engine that has been shut down, or null if this version of the engine doesn't suffer from DERBY-23

Throws:

java.lang.Exception