org.apache.derbyTesting.functionTests.tests.lang

Class XMLBindingTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.junit.BaseJDBCTestCase

org.apache.derbyTesting.functionTests.tests.lang.XMLBindingTest

All Implemented Interfaces:

junit.framework.Test

public class XMLBindingTest
extends BaseJDBCTestCase

This test checks to make sure that the XML data type and the corresponding XML operations all work as expected from the JDBC side of things. In particular, this test verifies that 1) it is NOT possible to bind to/from an XML datatype (because such an operation requires JDBC 4.0 and is not yet supported by Derby), and 2) the correct behavior occurs when null values (both Java and SQL) are bound into the bindable parameters for the XML operators. This test also checks that insertion from XML files via a character stream works, which is important since XML files can be arbitrarily long and thus stream-based processing is a must.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	XMLBindingTest.XBindTestSetup Helper class.

Field Summary

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

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Constructor and Description
XMLBindingTest(java.lang.String name) Public constructor required for running test as standalone JUnit.

Method Summary

Modifier and Type	Method and Description
private void	existsQuery(java.lang.String xPath, int expectedRows) Helper method.
static junit.framework.Test	suite() Return a suite that runs a set of XML binding tests.
void	testInvalidXMLBindings() Performs a series of binding checks to make sure binding to or from an XML value never works.
void	testXMLExistsBinding() Run some simple XPath queries against the documents inserted as part of XBindTestSetup to verify correct functionality in insertion and XMLEXISTS.
void	testXMLQueryBinding() Test binding of values into the first XMLQUERY operand (should fail).
void	testXMLSerializeBinding() Test serialization of the XML values inserted as part XBindTestSetup processing.

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

XMLBindingTest

public XMLBindingTest(java.lang.String name)

Public constructor required for running test as standalone JUnit.

Method Detail

suite

public static junit.framework.Test suite()

Return a suite that runs a set of XML binding tests. Only return such a suite IF the testing classpath has the required XML classes. Otherwise just return an empty suite.

testInvalidXMLBindings

public void testInvalidXMLBindings()
                            throws java.lang.Exception

Performs a series of binding checks to make sure binding to or from an XML value never works.

Throws:

java.lang.Exception

testXMLSerializeBinding

public void testXMLSerializeBinding()
                             throws java.lang.Exception

Test serialization of the XML values inserted as part XBindTestSetup processing. For the documents that are are larger than 32K, this tests that they can be correctly read from disk as a stream (instead of just as as string).

Throws:

java.lang.Exception

testXMLExistsBinding

public void testXMLExistsBinding()
                          throws java.lang.Exception

Run some simple XPath queries against the documents inserted as part of XBindTestSetup to verify correct functionality in insertion and XMLEXISTS. Also test binding of values into the first XMLEXISTS operator (should fail).

Throws:

java.lang.Exception

testXMLQueryBinding

public void testXMLQueryBinding()
                         throws java.lang.Exception

Test binding of values into the first XMLQUERY operand (should fail).

Throws:

java.lang.Exception

existsQuery

private void existsQuery(java.lang.String xPath,
                         int expectedRows)
                  throws java.lang.Exception

Helper method. Selects all rows (from xTable.t1) against which evaluation of the received XPath expression returns a non-empty sequence. Evaluates the query using the XMLEXISTS operator and then verifies that the number of rows matches the expected row row count.

Parameters:

xPath - The XPath expression to evaluate.

expectedRows - Number of rows for which we expect XMLEXISTS to return "true".

Throws:

java.lang.Exception