org.apache.derbyTesting.functionTests.tests.jdbc4

Class UnsupportedVetter

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.UnsupportedVetter

All Implemented Interfaces:

junit.framework.Test

public class UnsupportedVetter
extends BaseJDBCTestCase

JUnit test which checks that only expected methods throw SQLFeatureNotSupporteException. As currently compiled, this class does not object to a handful of mandatory LOB-supporting methods which Derby does not implement. You can expose these methods by setting the STRICT_ENFORCEMENT constant to true.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UnsupportedVetter.Exclusions Describes all of the methods for an interface which are allowed to raise SQLFeatureNotSupportedException.
static class	UnsupportedVetter.FD Method descriptor for mandatory methods which we know Derby does not implement.
static class	UnsupportedVetter.MD Method descriptor for optional methods which Derby does not have to implement.
static class	UnsupportedVetter.MethodSortable Used for sorting methods, which don't come back from Class.getMethods() in a deterministic order.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Hashtable<java.lang.Class,java.util.HashSet<java.lang.reflect.Method>>	excludableMap
private static UnsupportedVetter.Exclusions[]	rawExcludables
private boolean	savedVerbosity
static java.lang.String	SQL_PACKAGE_NAME
private static boolean	STRICT_ENFORCEMENT

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

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
UnsupportedVetter() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
private void	connectionWorkhorse(java.sql.Connection conn, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private 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 java.lang.Object	getNullValueForType(java.lang.Class type) Returns a null value compatible with the class.
private void	initializeExcludableMap(java.util.HashSet<java.lang.String> vanishedMethodList)
private boolean	isExcludable(java.lang.reflect.Method method)
private static UnsupportedVetter.MD	makeMD(java.lang.String methodName, java.lang.String[] argClassNames, boolean requiredAtThisLevel)
private void	printNotUnderstoodList(java.util.HashSet<java.lang.String> notUnderstoodList)
private void	printUnsupportedList(java.util.HashSet<java.lang.String> unsupportedList)
private void	printVanishedMethodList(java.util.HashSet<java.lang.String> vanishedMethodList)
private void	recordUnexpectedError(java.lang.Object candidate, java.lang.Class iface, java.lang.reflect.Method method, java.util.HashSet<java.lang.String> notUnderstoodList, java.lang.Throwable cause)
protected void	setUp()
private java.lang.reflect.Method[]	sortMethods(java.lang.Class iface)
static junit.framework.Test	suite()
protected void	tearDown() Tear down this fixture, sub-classes should call super.tearDown().
void	testSupportedMethods() Find all methods in this framework which raise SQLFeatureNotSupportedException.
private void	vetConnectionPooledDataSource(java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetDataSource(java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetInterfaceMethods(java.lang.Object candidate, java.lang.Class iface, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetInterfaces(java.lang.Object candidate, java.lang.Class myClass, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetLargeObjects(java.sql.Connection conn, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetMethod(java.lang.Object candidate, java.lang.Class iface, java.lang.reflect.Method method, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetObject(java.lang.Object candidate, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetSavepoint(java.sql.Connection conn, java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)
private void	vetXADataSource(java.util.HashSet<java.lang.String> unsupportedList, java.util.HashSet<java.lang.String> notUnderstoodList)

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, 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, toString

Methods inherited from class java.lang.Object

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

Field Detail

SQL_PACKAGE_NAME

public static final java.lang.String SQL_PACKAGE_NAME

See Also:

Constant Field Values

STRICT_ENFORCEMENT

private static final boolean STRICT_ENFORCEMENT

See Also:

Constant Field Values

rawExcludables

private static UnsupportedVetter.Exclusions[] rawExcludables

excludableMap

private static java.util.Hashtable<java.lang.Class,java.util.HashSet<java.lang.reflect.Method>> excludableMap

savedVerbosity

private boolean savedVerbosity

Constructor Detail

UnsupportedVetter

public UnsupportedVetter()

Creates a new instance.

Method Detail

makeMD

private static UnsupportedVetter.MD makeMD(java.lang.String methodName,
                                           java.lang.String[] argClassNames,
                                           boolean requiredAtThisLevel)

testSupportedMethods

public void testSupportedMethods()
                          throws java.lang.Exception

Find all methods in this framework which raise SQLFeatureNotSupportedException.

Throws:

java.lang.Exception

vetDataSource

private void vetDataSource(java.util.HashSet<java.lang.String> unsupportedList,
                           java.util.HashSet<java.lang.String> notUnderstoodList)
                    throws java.lang.Exception

Throws:

java.lang.Exception

vetConnectionPooledDataSource

private void vetConnectionPooledDataSource(java.util.HashSet<java.lang.String> unsupportedList,
                                           java.util.HashSet<java.lang.String> notUnderstoodList)
                                    throws java.lang.Exception

Throws:

java.lang.Exception

vetXADataSource

private void vetXADataSource(java.util.HashSet<java.lang.String> unsupportedList,
                             java.util.HashSet<java.lang.String> notUnderstoodList)
                      throws java.lang.Exception

Throws:

java.lang.Exception

connectionWorkhorse

private void connectionWorkhorse(java.sql.Connection conn,
                                 java.util.HashSet<java.lang.String> unsupportedList,
                                 java.util.HashSet<java.lang.String> notUnderstoodList)
                          throws java.lang.Exception

Throws:

java.lang.Exception

vetSavepoint

private void vetSavepoint(java.sql.Connection conn,
                          java.util.HashSet<java.lang.String> unsupportedList,
                          java.util.HashSet<java.lang.String> notUnderstoodList)
                   throws java.lang.Exception

Throws:

java.lang.Exception

vetLargeObjects

private void vetLargeObjects(java.sql.Connection conn,
                             java.util.HashSet<java.lang.String> unsupportedList,
                             java.util.HashSet<java.lang.String> notUnderstoodList)
                      throws java.lang.Exception

Throws:

java.lang.Exception

initializeExcludableMap

private void initializeExcludableMap(java.util.HashSet<java.lang.String> vanishedMethodList)
                              throws java.lang.Exception

Throws:

java.lang.Exception

vetObject

private void vetObject(java.lang.Object candidate,
                       java.util.HashSet<java.lang.String> unsupportedList,
                       java.util.HashSet<java.lang.String> notUnderstoodList)
                throws java.lang.Exception

Throws:

java.lang.Exception

vetInterfaces

private void vetInterfaces(java.lang.Object candidate,
                           java.lang.Class myClass,
                           java.util.HashSet<java.lang.String> unsupportedList,
                           java.util.HashSet<java.lang.String> notUnderstoodList)
                    throws java.lang.Exception

Throws:

java.lang.Exception

vetInterfaceMethods

private void vetInterfaceMethods(java.lang.Object candidate,
                                 java.lang.Class iface,
                                 java.util.HashSet<java.lang.String> unsupportedList,
                                 java.util.HashSet<java.lang.String> notUnderstoodList)
                          throws java.lang.Exception

Throws:

java.lang.Exception

sortMethods

private java.lang.reflect.Method[] sortMethods(java.lang.Class iface)
                                        throws java.lang.Exception

Throws:

java.lang.Exception

vetMethod

private void vetMethod(java.lang.Object candidate,
                       java.lang.Class iface,
                       java.lang.reflect.Method method,
                       java.util.HashSet<java.lang.String> unsupportedList,
                       java.util.HashSet<java.lang.String> notUnderstoodList)
                throws java.lang.Exception

Throws:

java.lang.Exception

recordUnexpectedError

private void recordUnexpectedError(java.lang.Object candidate,
                                   java.lang.Class iface,
                                   java.lang.reflect.Method method,
                                   java.util.HashSet<java.lang.String> notUnderstoodList,
                                   java.lang.Throwable cause)
                            throws java.lang.Exception

Throws:

java.lang.Exception

isExcludable

private boolean isExcludable(java.lang.reflect.Method method)
                      throws java.lang.Exception

Throws:

java.lang.Exception

getNullArguments

private 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 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

printUnsupportedList

private void printUnsupportedList(java.util.HashSet<java.lang.String> unsupportedList)

printVanishedMethodList

private void printVanishedMethodList(java.util.HashSet<java.lang.String> vanishedMethodList)

printNotUnderstoodList

private void printNotUnderstoodList(java.util.HashSet<java.lang.String> notUnderstoodList)

setUp

protected void setUp()

Overrides:

setUp in class junit.framework.TestCase

tearDown

protected void tearDown()
                 throws java.lang.Exception

Description copied from class: BaseJDBCTestCase

Tear down this fixture, sub-classes should call super.tearDown(). This cleanups & closes the connection if it is open and any statement objects returned through the utility methods.

Overrides:

tearDown in class BaseJDBCTestCase

Throws:

java.lang.Exception

suite

public static junit.framework.Test suite()