org.apache.derbyTesting.functionTests.tests.derbynet

Class ShutDownDBWhenNSShutsDownTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.junit.BaseJDBCTestCase

org.apache.derbyTesting.functionTests.tests.derbynet.ShutDownDBWhenNSShutsDownTest

All Implemented Interfaces:

junit.framework.Test

public class ShutDownDBWhenNSShutsDownTest
extends BaseJDBCTestCase

Derby-1274 - Network Server should shutdown the databases it has booted when started from the command line. Tests that the network server will shutdown the databases it has booted when started from the command line and that it will not shut down the databases when started from the API.

Field Summary

Fields inherited from class org.apache.derbyTesting.junit.BaseTestCase

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
ShutDownDBWhenNSShutsDownTest(java.lang.String name) Creates a new instance of ShutDownDBWhenNSShutsDownTest

Method Summary

Modifier and Type	Method and Description
private void	createDatabase()
private boolean	fileExists(java.lang.String fileName)
private void	scenarioEngineShutdownDoesNotTakeDownNS(boolean loadEmbeddedDriver) Test that a shutdown of the engine does not take down the network server.
private void	shutdownServerCheckDBShutDown(boolean dbShutDown) Checks whether the server shuts down causes the databases it has booted to be shut down.
static junit.framework.Test	suite() Only run the fixtures in network server mode as that's what they are testing.
void	testDatabasesShutDownWhenNSShutdownAPI() Test that the NetworkServer does not shut down the databases it has booted when started from the API.
void	testEngineShutdownDoesNotTakeDownNSAutoReload() Test the scenario from scenarioEngineShutdownDoesNotTakeDownNS relying on the network server to reloading the embedded driver after the network server has shutdown.
void	testEngineShutdownDoesNotTakeDownNSManualReload() Test the scenario from scenarioEngineShutdownDoesNotTakeDownNS reloading the embedded driver after the network server has shutdown.
void	XXtestDatabasesShutDownWhenNSShutdown() Test that the NetworkServer shuts down the databases it has booted when started from the command line, and that it does not shut down the databases it has booted when started from the API.

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

assertCallError, assertCheckTable, assertCompileError, assertEquals, assertEquals, assertEquals, assertEquivalentDataType, assertErrorCode, assertGetIntError, assertNextError, assertPreparedStatementError, assertSQLExceptionEquals, assertSQLState, assertSQLState, assertStatementError, assertStatementError, assertStatementError, assertStatementError, assertStatementErrorUnordered, assertTableRowCount, assertUpdateCount, assertUpdateCount, assertWarning, checkAllConsistency, checkEstimatedRowCount, closeStatement, commit, createStatement, createStatement, createStatement, dropTable, dropTable, dropView, dropView, emptyStatementCache, getClientTransactionID, getConnection, getDatabaseProperty, getLastSQLException, initializeConnection, openConnection, openDefaultConnection, openDefaultConnection, openDefaultConnection, openUserConnection, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, rollback, runBare, runBareOverridable, runScript, runScript, runSQLCommands, setAutoCommit, tearDown, usingDB2Client, usingDerbyNetClient, usingEmbedded

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

alarm, assertDirectoryDeleted, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertExecJavaCmdAsExpected, assertLaunchedJUnitTestMethod, assertLaunchedJUnitTestMethod, assertSecurityManager, assertThrowableEquals, currentDirectory, execJavaCmd, execJavaCmd, fail, getClassVersionMajor, getEmmaJar, getFailureFolder, getFilesWith, getJavaExecutableName, getSystemProperty, getTestConfiguration, getTestResource, hasInterruptibleIO, isCVM, isIBMJVM, isJ9Platform, isJava5, isJava7, isJava8, isPhoneME, isPlatform, isSunJVM, isWindowsPlatform, openTestResource, println, printStackTrace, readProcessOutput, removeDirectory, removeDirectory, removeFiles, removeSystemProperty, runsWithEmma, runsWithJaCoCo, setSystemProperty, sleep, sleepAtLeastOneTick, traceit

Methods inherited from class junit.framework.TestCase

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, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runTest, setName, setUp, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ShutDownDBWhenNSShutsDownTest

public ShutDownDBWhenNSShutsDownTest(java.lang.String name)

Creates a new instance of ShutDownDBWhenNSShutsDownTest

Method Detail

suite

public static junit.framework.Test suite()

Only run the fixtures in network server mode as that's what they are testing.

testEngineShutdownDoesNotTakeDownNSManualReload

public void testEngineShutdownDoesNotTakeDownNSManualReload()
                                                     throws java.lang.Exception

Test the scenario from scenarioEngineShutdownDoesNotTakeDownNS reloading the embedded driver after the network server has shutdown.

Throws:

java.lang.Exception

testEngineShutdownDoesNotTakeDownNSAutoReload

public void testEngineShutdownDoesNotTakeDownNSAutoReload()
                                                   throws java.lang.Exception

Test the scenario from scenarioEngineShutdownDoesNotTakeDownNS relying on the network server to reloading the embedded driver after the network server has shutdown.

Throws:

java.lang.Exception

scenarioEngineShutdownDoesNotTakeDownNS

private void scenarioEngineShutdownDoesNotTakeDownNS(boolean loadEmbeddedDriver)
                                              throws java.lang.Exception

Test that a shutdown of the engine does not take down the network server. Before DERBY-1326 was fixed, shutting down the engine would leave the network server in an inconsistent state which could make clients hang infinitely.

Throws:

java.lang.Exception

testDatabasesShutDownWhenNSShutdownAPI

public void testDatabasesShutDownWhenNSShutdownAPI()
                                            throws java.lang.Exception

Test that the NetworkServer does not shut down the databases it has booted when started from the API. This fixture must be run with a clientServerDecorator().

Throws:

java.lang.Exception

XXtestDatabasesShutDownWhenNSShutdown

public void XXtestDatabasesShutDownWhenNSShutdown()
                                           throws java.lang.Exception

Test that the NetworkServer shuts down the databases it has booted when started from the command line, and that it does not shut down the databases it has booted when started from the API.

Throws:

java.lang.Exception

shutdownServerCheckDBShutDown

private void shutdownServerCheckDBShutDown(boolean dbShutDown)
                                    throws java.lang.Exception

Checks whether the server shuts down causes the databases it has booted to be shut down. Creates a database and shuts down the server. If the server was started from the command line the database should be shut down. If the server was started from the api the database should not be shut down. If the database has been shut down the db.lck file should not exist.

Parameters:

dbShutDown - Indicates whether the database should have been shut down.

Throws:

java.lang.Exception

fileExists

private boolean fileExists(java.lang.String fileName)
                    throws java.lang.Exception

Throws:

java.lang.Exception

createDatabase

private void createDatabase()
                     throws java.sql.SQLException

Throws:

java.sql.SQLException