org.apache.derbyTesting.functionTests.tests.management

Class JDBCMBeanTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.junit.BaseJDBCTestCase

org.apache.derbyTesting.functionTests.tests.management.MBeanTest

org.apache.derbyTesting.functionTests.tests.management.JDBCMBeanTest

All Implemented Interfaces:

junit.framework.Test

public class JDBCMBeanTest
extends MBeanTest

This JUnit test class is for testing the JDBCMBean that is available in Derby. Running these tests requires a JVM supporting J2SE 5.0 or better, due to the implementation's dependency of the platform management agent.

This class currently tests the following:

• That the attributes we expect to be available exist
• That these attributes are readable
• That these attributes have the correct type
• That these attributes have the correct value
• That the MBean operations we expect to see are invokeable, and that their return values are as expected.

The test fixtures will fail if an exception occurs (will be reported as an error in JUnit).

Field Summary

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

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
JDBCMBeanTest(java.lang.String name)

Method Summary

Modifier and Type	Method and Description
private javax.management.ObjectName	getJdbcMBeanObjectName() Creates an object name instance for the MBean whose object name's textual representation contains: type=JDBC
static junit.framework.Test	suite()
void	testAttributeCompliantDriver()
void	testAttributeDriverLevel()
void	testAttributeMajorVersion() Tests the MajorVersion attribute of the JDBCMBean.
void	testAttributeMinorVersion() Tests the MinorVersion attribute of the JDBCMBean.
void	testOperationAcceptsURL()

Methods inherited from class org.apache.derbyTesting.functionTests.tests.management.MBeanTest

assertBooleanAttribute, assertIntAttribute, assertLongAttribute, assertStringAttribute, checkBooleanAttributeValue, checkIntAttributeValue, checkLongAttributeValue, checkStringAttributeValue, enableManagement, getApplicationManagementMBean, getAttribute, getCommandLineProperties, getDerbyDomainMBeans, getDerbyMBeanName, getMBeanServerConnection, getMBeanServerConnection, invokeOperation, invokeOperation, isPlatformJMXClient, setUp, suite, tearDown

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

Constructor Detail

JDBCMBeanTest

public JDBCMBeanTest(java.lang.String name)

Method Detail

suite

public static junit.framework.Test suite()

getJdbcMBeanObjectName

private javax.management.ObjectName getJdbcMBeanObjectName()
                                                    throws java.lang.Exception

Creates an object name instance for the MBean whose object name's textual representation contains:

• type=JDBC

Returns:

the object name representing Derby's JDBCMBean

Throws:

MalformedObjectNameException - if the object name is not valid

java.lang.Exception

testAttributeCompliantDriver

public void testAttributeCompliantDriver()
                                  throws java.lang.Exception

Throws:

java.lang.Exception

testAttributeDriverLevel

public void testAttributeDriverLevel()
                              throws java.lang.Exception

Throws:

java.lang.Exception

testAttributeMajorVersion

public void testAttributeMajorVersion()
                               throws java.lang.Exception

Tests the MajorVersion attribute of the JDBCMBean. Will test that there exists an attribute with that name that we are able to read, that it returns the correct type, and that the return value is as expected.

The expected value is retreived from the embedded driver that is directly accessible to this JVM, making the assumption that this driver's version information is the same as the version information of the embedded driver used in the JVM being instrumented using JMX (this may or may not be the same JVM).

Throws:

java.lang.Exception - if an error occurs, or if the test fails.

testAttributeMinorVersion

public void testAttributeMinorVersion()
                               throws java.lang.Exception

Tests the MinorVersion attribute of the JDBCMBean. Will test that there exists an attribute with that name that we are able to read, that it returns the correct type, and that the return value is as expected.

The expected value is retreived from the embedded driver that is directly accessible to this JVM, making the assumption that this driver's version information is the same as the version information of the embedded driver used in the JVM being instrumented using JMX (this may or may not be the same JVM).

Throws:

java.lang.Exception - if an error occurs, or if the test fails.

testOperationAcceptsURL

public void testOperationAcceptsURL()
                             throws java.lang.Exception

Throws:

java.lang.Exception