org.apache.derbyTesting.functionTests.tests.jdbc4

Class ConnectionTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.junit.BaseJDBCTestCase

org.apache.derbyTesting.functionTests.tests.jdbc4.ConnectionTest

All Implemented Interfaces:

junit.framework.Test

public class ConnectionTest
extends BaseJDBCTestCase

Tests for the JDBC 4.0 specific methods in the connection object(s). Which connection implementation is tested, depends on what connection object the BaseJDBCTestCase.getConnection()-method returns. Currently, the property derbyTesting.xa.single can be set to true to test the XA connection object, which happens to be the same as the one used for poooled connections. The connection returned also depends on which framework is being used.

Field Summary

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

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
ConnectionTest(java.lang.String name) Create a test with the given name.

Method Summary

Modifier and Type	Method and Description
private static junit.framework.TestSuite	clientSuite(java.lang.String name) Create suite containing client-only tests.
void	embeddedCreateBlob() Tests the Embedded implementation for the createBlob method.
void	embeddedCreateClob() Tests the Embedded implementation for the createClob method.
private static junit.framework.TestSuite	embeddedSuite(java.lang.String name) Create suite containing embedded-only tests.
static junit.framework.Test	suite() Create a test suite containing tests for a JDB connection.
void	testCreateArrayNotImplemented()
void	testCreateNClobNotImplemented()
void	testCreateSQLXMLNotImplemented()
void	testCreateStructNotImplemented()
void	testGetClientInfo()
void	testGetClientInfoString()
void	testGetTypeMapReturnsAsExpected() Tests that getTypeMap() returns the input map
void	testGetTypeMapReturnsEmptyMap() Tests that getTypeMap() returns an empty map when no type map has been installed.
void	testIsValidImplemented() Tests that isValid is implemented and returns true for the connection.
void	testIsWrapperReturnsFalse()
void	testIsWrapperReturnsTrue()
void	testSetClientInfoProperties()
void	testSetClientInfoString()
void	testUnwrapInvalid()
void	testUnwrapValid()
void	xtestIsValidWithTimeout() Tests that isValid times out when expected.

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

ConnectionTest

public ConnectionTest(java.lang.String name)

Create a test with the given name.

Parameters:

name - name of the test.

Method Detail

embeddedCreateBlob

public void embeddedCreateBlob()
                        throws java.sql.SQLException

Tests the Embedded implementation for the createBlob method. The Embedded server does'nt currently have the set methods implemented. Hence the create methods cannot be tested by inserting data into the empty LOB object. Here we do a simple test of checking that the length of the LOB object is 0.

Throws:

java.sql.SQLException - upon failure in the createBlob or the length methods.

embeddedCreateClob

public void embeddedCreateClob()
                        throws java.sql.SQLException

Tests the Embedded implementation for the createClob method. The Embedded server does'nt currently have the set methods implemented. Hence the create methods cannot be tested by inserting data into the empty LOB object. Here we do a simple test of checking that the length of the LOB object is 0.

Throws:

java.sql.SQLException - upon failure in the createClob or the length methods.

testCreateArrayNotImplemented

public void testCreateArrayNotImplemented()
                                   throws java.sql.SQLException

Throws:

java.sql.SQLException

testCreateNClobNotImplemented

public void testCreateNClobNotImplemented()
                                   throws java.sql.SQLException

Throws:

java.sql.SQLException

testCreateSQLXMLNotImplemented

public void testCreateSQLXMLNotImplemented()
                                    throws java.sql.SQLException

Throws:

java.sql.SQLException

testCreateStructNotImplemented

public void testCreateStructNotImplemented()
                                    throws java.sql.SQLException

Throws:

java.sql.SQLException

testGetClientInfo

public void testGetClientInfo()
                       throws java.sql.SQLException

Throws:

java.sql.SQLException

testGetClientInfoString

public void testGetClientInfoString()
                             throws java.sql.SQLException

Throws:

java.sql.SQLException

testIsValidImplemented

public void testIsValidImplemented()
                            throws java.sql.SQLException

Tests that isValid is implemented and returns true for the connection. This test is very limited but is tested for all connection types. A more complete test of isValid is found in the ConnectionMethodsTest.java test that is run for embedded and network client connections.

Throws:

java.sql.SQLException

xtestIsValidWithTimeout

public void xtestIsValidWithTimeout()
                             throws java.sql.SQLException

Tests that isValid times out when expected. This test will need a modification to the source code; activate the commented out Thread.sleep(2000) (2 seconds) in DRDAConnThread.ProcessCommands, case CodePoint.OPNQRY To activate the test, remove the extra 'x' before building

Throws:

java.sql.SQLException

testGetTypeMapReturnsEmptyMap

public void testGetTypeMapReturnsEmptyMap()
                                   throws java.sql.SQLException

Tests that getTypeMap() returns an empty map when no type map has been installed.

Throws:

java.sql.SQLException - if an error occurs

testGetTypeMapReturnsAsExpected

public void testGetTypeMapReturnsAsExpected()
                                     throws java.sql.SQLException

Tests that getTypeMap() returns the input map

Throws:

java.sql.SQLException - if an error occurs

testIsWrapperReturnsFalse

public void testIsWrapperReturnsFalse()
                               throws java.sql.SQLException

Throws:

java.sql.SQLException

testIsWrapperReturnsTrue

public void testIsWrapperReturnsTrue()
                              throws java.sql.SQLException

Throws:

java.sql.SQLException

testSetClientInfoProperties

public void testSetClientInfoProperties()
                                 throws java.sql.SQLException

Throws:

java.sql.SQLException

testSetClientInfoString

public void testSetClientInfoString()
                             throws java.sql.SQLException

Throws:

java.sql.SQLException

testUnwrapValid

public void testUnwrapValid()
                     throws java.sql.SQLException

Throws:

java.sql.SQLException

testUnwrapInvalid

public void testUnwrapInvalid()
                       throws java.sql.SQLException

Throws:

java.sql.SQLException

clientSuite

private static junit.framework.TestSuite clientSuite(java.lang.String name)

Create suite containing client-only tests.

embeddedSuite

private static junit.framework.TestSuite embeddedSuite(java.lang.String name)

Create suite containing embedded-only tests.

suite

public static junit.framework.Test suite()

Create a test suite containing tests for a JDB connection. In addition, separate suites for embedded- and client-only are added when appropriate.