org.apache.derbyTesting.functionTests.tests.jdbcapi

Class ClosedObjectTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.junit.BaseJDBCTestCase

org.apache.derbyTesting.functionTests.tests.jdbcapi.ClosedObjectTest

All Implemented Interfaces:

junit.framework.Test

public class ClosedObjectTest
extends BaseJDBCTestCase

Test that all methods on ResultSet, Statement, PreparedStatement, CallableStatement and Connection objects throw the appropriate exceptions when the objects are closed.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ClosedObjectTest.CallableStatementObjectDecorator Decorator class for testing methods on a closed callable statement.
private static class	ClosedObjectTest.ConnectionObjectDecorator Decorator class for testing methods on a closed connection.
private static class	ClosedObjectTest.DataSourceDecorator Decorator class used for obtaining connections through a DataSource.
private static class	ClosedObjectTest.ObjectDecorator Abstract decorator class with functionality for obtaining a closed object.
private static class	ClosedObjectTest.PoolDataSourceDecorator Decorator class used for obtaining connections through a ConnectionPoolDataSource.
private static class	ClosedObjectTest.PreparedStatementObjectDecorator Decorator class for testing methods on a closed prepared statement.
private static class	ClosedObjectTest.ResultSetObjectDecorator Decorator class for testing methods on a closed result set.
private static class	ClosedObjectTest.StatementObjectDecorator Decorator class for testing methods on a closed statement.
private static class	ClosedObjectTest.XADataSourceDecorator Decorator class used for obtaining connections through an XADataSource.

Field Summary

Fields

Modifier and Type	Field and Description
private ClosedObjectTest.ObjectDecorator	decorator_ Test decorator which provides a closed object to invoke a method on.
private java.lang.reflect.Method	method_ The method to test.
private java.lang.String	name_ Name of the test.

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

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
ClosedObjectTest(java.lang.reflect.Method method, ClosedObjectTest.ObjectDecorator decorator) Creates a new ClosedObjectTest instance.

Method Summary

Modifier and Type	Method and Description
private static junit.framework.Test	baseSuite(boolean network) Creates the test suite and fills it with tests using DataSource, ConnectionPoolDataSource and XADataSource to obtain objects.
private static void	fillDataSourceSuite(junit.framework.TestSuite suite, ClosedObjectTest.DataSourceDecorator dsDecorator) Fills a test suite which is contained in a DataSourceDecorator with tests for ResultSet, Statement, PreparedStatement, CallableStatement and Connection.
private static void	fillObjectSuite(junit.framework.TestSuite suite, ClosedObjectTest.ObjectDecorator decorator, java.lang.Class iface) Fills a suite with tests for all the methods of an interface.
java.lang.String	getName() Gets the name of the test.
private static java.lang.Object[]	getNullArguments(java.lang.Class[] params) Takes an array of classes and returns an array of objects with null values compatible with the classes.
private static java.lang.Object	getNullValueForType(java.lang.Class type) Returns a null value compatible with the class.
private boolean	isImplemented() Check if the JDBC interface method tested by this test case is actually implemented by the Derby object being tested.
private static junit.framework.Test	poolSuite(java.util.Map dsProps) Creates a suite that tests objects produced by a ConnectionPoolDataSource.
static junit.framework.Test	suite() Creates a suite with all tests in the class.
void	testClosedObjects() Runs a test case.

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, run, run, runTest, setName, setUp, toString

Methods inherited from class java.lang.Object

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

Field Detail

method_

private final java.lang.reflect.Method method_

The method to test.

decorator_

private final ClosedObjectTest.ObjectDecorator decorator_

Test decorator which provides a closed object to invoke a method on.

name_

private java.lang.String name_

Name of the test.

Constructor Detail

ClosedObjectTest

public ClosedObjectTest(java.lang.reflect.Method method,
                        ClosedObjectTest.ObjectDecorator decorator)

Creates a new ClosedObjectTest instance.

Parameters:

method - the method to test

decorator - a decorator which provides a closed object

Method Detail

getName

public java.lang.String getName()

Gets the name of the test.

Overrides:

getName in class junit.framework.TestCase

Returns:

name of the test

testClosedObjects

public void testClosedObjects()
                       throws java.lang.Throwable

Runs a test case. A method is called on a closed object, and it is checked that the appropriate exception is thrown.

Throws:

java.lang.Throwable - if an error occurs

isImplemented

private boolean isImplemented()
                       throws java.lang.NoSuchMethodException

Check if the JDBC interface method tested by this test case is actually implemented by the Derby object being tested.

Throws:

java.lang.NoSuchMethodException

suite

public static junit.framework.Test suite()

Creates a suite with all tests in the class.

baseSuite

private static junit.framework.Test baseSuite(boolean network)

Creates the test suite and fills it with tests using DataSource, ConnectionPoolDataSource and XADataSource to obtain objects.

Parameters:

network - whether or not to run tests with the network client

Returns:

a Test value

Throws:

java.lang.Exception - if an error occurs while building the test suite

poolSuite

private static junit.framework.Test poolSuite(java.util.Map dsProps)

Creates a suite that tests objects produced by a ConnectionPoolDataSource.

Parameters:

dsProps - properties to set on the data source

Returns:

a suite

fillDataSourceSuite

private static void fillDataSourceSuite(junit.framework.TestSuite suite,
                                        ClosedObjectTest.DataSourceDecorator dsDecorator)

Fills a test suite which is contained in a DataSourceDecorator with tests for ResultSet, Statement, PreparedStatement, CallableStatement and Connection.

Parameters:

suite - the test suite to fill

dsDecorator - the decorator for the test suite

fillObjectSuite

private static void fillObjectSuite(junit.framework.TestSuite suite,
                                    ClosedObjectTest.ObjectDecorator decorator,
                                    java.lang.Class iface)

Fills a suite with tests for all the methods of an interface.

Parameters:

suite - the suite to fill

decorator - a decorator for the test (used for obtaining a closed object to test the method on)

iface - the interface which contains the methods to test

getNullArguments

private static java.lang.Object[] getNullArguments(java.lang.Class[] params)

Takes an array of classes and returns an array of objects with null values compatible with the classes. Helper method for converting a parameter list to an argument list.

Parameters:

params - a Class[] value

Returns:

an Object[] value

getNullValueForType

private static java.lang.Object getNullValueForType(java.lang.Class type)

Returns a null value compatible with the class. For instance, return Boolean.FALSE for primitive booleans, 0 for primitive integers and null for non-primitive types.

Parameters:

type - a Class value

Returns:

a null value