org.jdbi.v3.testing

Class JdbiRule

java.lang.Object

org.junit.rules.ExternalResource

org.jdbi.v3.testing.JdbiRule

All Implemented Interfaces:

org.junit.rules.TestRule

public abstract class JdbiRule
extends org.junit.rules.ExternalResource

JUnit @Rule to manage a Jdbi instance pointed to a managed database.

Constructor Summary

Constructors

Constructor and Description
JdbiRule()

Method Summary

Modifier and Type	Method and Description
protected void	after()
<T> T	attach(Class<T> extension) Attach an extension (such as a SqlObject) to the managed handle.
protected void	before()
protected abstract DataSource	createDataSource()
static JdbiRule	embeddedPostgres() Create a JdbiRule with an embedded Postgres instance.
Handle	getHandle() Get the single Handle instance opened for the duration of this test case.
Jdbi	getJdbi() Get Jdbi, in case you want to open additional handles to the same data source.
static JdbiRule	h2() Create a JdbiRule with an in-memory H2 database instance.
JdbiRule	migrateWithFlyway() Run database migration scripts from db/migration on the classpath, using Flyway.
JdbiRule	migrateWithFlyway(String... locations) Run database migration scripts from the given locations on the classpath, using Flyway.
JdbiRule	withPlugin(JdbiPlugin plugin) Install a plugin into JdbiRule.
JdbiRule	withPlugins() Discover and install plugins from the classpath.

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

JdbiRule

public JdbiRule()

Method Detail

createDataSource

protected abstract DataSource createDataSource()

embeddedPostgres

public static JdbiRule embeddedPostgres()

Create a JdbiRule with an embedded Postgres instance. Your project must depend on the otj-pg-embedded artifact.

h2

public static JdbiRule h2()

Create a JdbiRule with an in-memory H2 database instance. Your project must depend on the h2 database artifact.

migrateWithFlyway

public JdbiRule migrateWithFlyway()

Run database migration scripts from db/migration on the classpath, using Flyway.

Returns:

this

migrateWithFlyway

public JdbiRule migrateWithFlyway(String... locations)

Run database migration scripts from the given locations on the classpath, using Flyway.

Returns:

this

withPlugins

public JdbiRule withPlugins()

Discover and install plugins from the classpath.

See Also:

we recommend installing plugins explicitly instead

withPlugin

public JdbiRule withPlugin(JdbiPlugin plugin)

Install a plugin into JdbiRule.

before

protected void before()
               throws Throwable

Overrides:

before in class org.junit.rules.ExternalResource

Throws:

Throwable

after

protected void after()

Overrides:

after in class org.junit.rules.ExternalResource

getJdbi

public Jdbi getJdbi()

Get Jdbi, in case you want to open additional handles to the same data source.

getHandle

public Handle getHandle()

Get the single Handle instance opened for the duration of this test case.

attach

public <T> T attach(Class<T> extension)

Attach an extension (such as a SqlObject) to the managed handle.