Package org.testcontainers.jdbc

Class ContainerDatabaseDriver

java.lang.Object

org.testcontainers.jdbc.ContainerDatabaseDriver

All Implemented Interfaces:

Driver

public class ContainerDatabaseDriver
extends Object
implements Driver

Test Containers JDBC proxy driver. This driver will handle JDBC URLs of the form:

jdbc:tc:type://host:port/database?querystring

where type is a supported database type (e.g. mysql, postgresql, oracle). Behind the scenes a new docker container will be launched running the required database engine. New JDBC connections will be created using the database's standard driver implementation, connected to the container.

If TC_INITSCRIPT is set in querystring, it will be used as the path for an init script that should be run to initialize the database after the container is created. This should be a classpath resource.

Similarly TC_INITFUNCTION may be a method reference for a function that can initialize the database. Such a function must accept a javax.sql.Connection as its only parameter. An example of a valid method reference would be com.myapp.SomeClass::initFunction

Constructor Summary

Constructors

Constructor	Description
ContainerDatabaseDriver()

Method Summary

Modifier and Type	Method	Description
boolean	acceptsURL(String url)
Connection	connect(String url, Properties info)
int	getMajorVersion()
int	getMinorVersion()
Logger	getParentLogger()
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info)
boolean	jdbcCompliant()
static void	killContainer(String jdbcUrl)	Utility method to kill a database container directly from test support code.
static void	killContainers()	Utility method to kill ALL database containers directly from test support code.

Methods inherited from class java.lang.Object

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

Constructor Details

ContainerDatabaseDriver

public ContainerDatabaseDriver()

Method Details

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

connect

public Connection connect(String url,
 Properties info)
                   throws SQLException

Specified by:

connect in interface Driver

Throws:

SQLException

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String url,
 Properties info)
                                     throws SQLException

Specified by:

getPropertyInfo in interface Driver

Throws:

SQLException

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface Driver

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface Driver

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException

killContainers

public static void killContainers()

Utility method to kill ALL database containers directly from test support code. It shouldn't be necessary to use this, but it is provided for convenience - e.g. for situations where many different database containers are being tested and cleanup is needed to limit resource usage.

killContainer

public static void killContainer(String jdbcUrl)

Utility method to kill a database container directly from test support code. It shouldn't be necessary to use this, but it is provided for convenience - e.g. for situations where many different database containers are being tested and cleanup is needed to limit resource usage.

Parameters:

jdbcUrl - the JDBC URL of the container which should be killed