org.deventropy.junithelper.derby.datasource

Class EmbeddedDerbyDataSourceResource

java.lang.Object

org.junit.rules.ExternalResource

org.deventropy.junithelper.derby.EmbeddedDerbyResource

org.deventropy.junithelper.derby.datasource.EmbeddedDerbyDataSourceResource

All Implemented Interfaces:

Closeable, AutoCloseable, TestRule

public class EmbeddedDerbyDataSourceResource
extends EmbeddedDerbyResource

Provides an in-memory Derby resource capable of providing different kinds of DataSources supported by Derby. An instance of this class is initialized with the configuration and a Derby System Home.

This resource extends EmbeddedDerbyResource and all functionality in that class are available here, please consult the documentation of that class on initialization, control of the resource and the underlying Derby database.

Example of usage:

 public class SimpleDerbyTest {
 
  private static final String DB_NAME = "test-database";
 
  private TemporaryFolder tempFolder = new TemporaryFolder();
  private EmbeddedDerbyDataSourceResource embeddedDerbyResource =
        new EmbeddedDerbyDataSourceResource(DerbyResourceConfig.buildDefault().useInMemoryDatabase(DB_NAME),
        tempFolder);
 
  @Rule
  public RuleChain derbyRuleChain = RuleChain.outerRule(tempFolder).around(embeddedDerbyResource);
 
        @Test
        public void test () throws SQLException {
                final String jdbcUrl = embeddedDerbyResource.getJdbcUrl();
                DataSource dataSource = null;
                Connection connection = null;
                Statement stmt = null;
                ResultSet rs = null;
 
                try {
                        final EmbeddedDerbyDataSourceFactory dsFactory = embeddedDerbyDataSourceResource.getDataSourceFactory();
                        assertNotNull(dsFactory);
 
                        dataSource = dsFactory.getDataSource(true);
                        connection = dataSource.getConnection();
 
                        // Check a value
                        stmt = connection.createStatement();
                        rs = stmt.executeQuery("SELECT 1 FROM SYSIBM.SYSDUMMY1");
 
                        assertTrue(rs.next());
                } finally {
                        // Close resources
                }
        }
 }
 

For further information and examples, see User Manual on the Project Website.

Author:

Bindul Bhowmik

See Also:

EmbeddedDerbyResource, DerbyResourceConfig

Constructor Summary

Constructors

Constructor and Description
EmbeddedDerbyDataSourceResource(DerbyResourceConfig dbResourceConfig, File derbySystemHomeDir) Creates a new Derby resource.
EmbeddedDerbyDataSourceResource(DerbyResourceConfig dbResourceConfig, TemporaryFolder derbySystemHomeParentTmpFolder) Creates a new Derby resource.

Method Summary

Modifier and Type	Method and Description
EmbeddedDerbyDataSourceFactory	getDataSourceFactory() Returns the EmbeddedDerbyDataSourceFactory instance for this resource from which data sources can be created / cached.

Methods inherited from class org.deventropy.junithelper.derby.EmbeddedDerbyResource

after, appendDbLocNameToUrl, backupLiveDatabase, before, close, createConnection, ensureActive, getConfig, getDatabasePath, getDerbySystemHome, getJdbcUrl, isActive, start

Methods inherited from class org.junit.rules.ExternalResource

apply

Methods inherited from class java.lang.Object

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

Constructor Detail

EmbeddedDerbyDataSourceResource

public EmbeddedDerbyDataSourceResource(DerbyResourceConfig dbResourceConfig,
                                       File derbySystemHomeDir)

Creates a new Derby resource.

Parameters:

dbResourceConfig - Configurations to setup this resource

derbySystemHomeDir - A folder to use as the derby system home

See Also:

EmbeddedDerbyResource.EmbeddedDerbyResource(DerbyResourceConfig, File)

EmbeddedDerbyDataSourceResource

public EmbeddedDerbyDataSourceResource(DerbyResourceConfig dbResourceConfig,
                                       TemporaryFolder derbySystemHomeParentTmpFolder)

Creates a new Derby resource.

Parameters:

dbResourceConfig - Configurations to setup this resource

derbySystemHomeParentTmpFolder - A temporary folder to use as the derby system home

See Also:

EmbeddedDerbyResource.EmbeddedDerbyResource(DerbyResourceConfig, TemporaryFolder)

Method Detail

getDataSourceFactory

public EmbeddedDerbyDataSourceFactory getDataSourceFactory()

Returns the EmbeddedDerbyDataSourceFactory instance for this resource from which data sources can be created / cached. The factory returned supports caching ataSources created. It also checks the state of this instance and will throw IllegalStateException if the resource is not EmbeddedDerbyResource.isActive().

Returns:

Factory to create data sources for this instance.