org.testcontainers.containers

Class JdbcDatabaseContainer

java.lang.Object

org.testcontainers.containers.FailureDetectingExternalResource

org.testcontainers.containers.GenericContainer

org.testcontainers.containers.JdbcDatabaseContainer

All Implemented Interfaces:

org.junit.rules.TestRule, LinkableContainer

public abstract class JdbcDatabaseContainer
extends GenericContainer
implements LinkableContainer

Base class for containers that expose a JDBC connection

Author:

richardnorth

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,String>	parameters

Fields inherited from class org.testcontainers.containers.GenericContainer

containerId, containerName, dockerClient

Constructor Summary

Constructors

Constructor and Description
JdbcDatabaseContainer(String dockerImageName)

Method Summary

Modifier and Type	Method and Description
void	addParameter(String paramName, String value)
Connection	createConnection(String queryString) Creates a connection to the underlying containerized database instance.
protected abstract String	getDriverClassName()
Driver	getJdbcDriverInstance() Obtain an instance of the correct JDBC driver for this particular database container type
abstract String	getJdbcUrl()
protected abstract Integer	getLivenessCheckPort()
abstract String	getPassword()
protected abstract String	getTestQueryString()
abstract String	getUsername()
protected void	optionallyMapResourceParameterAsVolume(String paramName, String pathNameInContainer)
void	setParameters(Map<String,String> parameters)
protected void	waitUntilContainerStarted()

Methods inherited from class org.testcontainers.containers.GenericContainer

addEnv, addExposedPort, addExposedPorts, addFileSystemBind, addLink, canEqual, configure, containerIsStarted, containerIsStarting, createVolumeDirectory, equals, finished, getBinds, getCommandParts, getContainerId, getContainerInfo, getContainerName, getDockerClient, getDockerImageName, getEnv, getExposedPorts, getHostIpAddress, getIpAddress, getLinkedContainers, getMappedPort, hashCode, isRunning, logger, setBinds, setCommand, setCommand, setCommandParts, setContainerId, setContainerInfo, setContainerName, setDockerClient, setDockerImageName, setEnv, setExposedPorts, setLinkedContainers, start, starting, stop, toString, waitForListeningPort, withClasspathResourceMapping, withCommand, withCommand, withEnv, withExposedPorts

Methods inherited from class org.testcontainers.containers.FailureDetectingExternalResource

apply, failed, succeeded

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.testcontainers.containers.traits.LinkableContainer

getContainerName

Field Detail

parameters

protected Map<String,String> parameters

Constructor Detail

JdbcDatabaseContainer

public JdbcDatabaseContainer(String dockerImageName)

Method Detail

getDriverClassName

protected abstract String getDriverClassName()

Returns:

the name of the actual JDBC driver to use

getJdbcUrl

public abstract String getJdbcUrl()

Returns:

a JDBC URL that may be used to connect to the dockerized DB

getUsername

public abstract String getUsername()

Returns:

the standard database username that should be used for connections

getPassword

public abstract String getPassword()

Returns:

the standard password that should be used for connections

getTestQueryString

protected abstract String getTestQueryString()

Returns:

a test query string suitable for testing that this particular database type is alive

waitUntilContainerStarted

protected void waitUntilContainerStarted()

Overrides:

waitUntilContainerStarted in class GenericContainer

getJdbcDriverInstance

public Driver getJdbcDriverInstance()

Obtain an instance of the correct JDBC driver for this particular database container type

Returns:

a JDBC Driver

createConnection

public Connection createConnection(String queryString)
                            throws SQLException

Creates a connection to the underlying containerized database instance.

Parameters:

queryString - any special query string parameters that should be appended to the JDBC connection URL. The '?' character must be included

Returns:

a Connection

Throws:

SQLException

optionallyMapResourceParameterAsVolume

protected void optionallyMapResourceParameterAsVolume(String paramName,
                                                      String pathNameInContainer)

getLivenessCheckPort

protected abstract Integer getLivenessCheckPort()

Overrides:

getLivenessCheckPort in class GenericContainer

setParameters

public void setParameters(Map<String,String> parameters)

addParameter

public void addParameter(String paramName,
                         String value)