io.dropwizard.testing.junit

Class DropwizardAppRule<C extends Configuration>

java.lang.Object

org.junit.rules.ExternalResource

io.dropwizard.testing.junit.DropwizardAppRule<C>

Type Parameters:

C - the configuration type

All Implemented Interfaces:

org.junit.rules.TestRule

public class DropwizardAppRule<C extends Configuration>
extends org.junit.rules.ExternalResource

A JUnit rule for starting and stopping your application at the start and end of a test class.

By default, the Application will be constructed using reflection to invoke the nullary constructor. If your application does not provide a public nullary constructor, you will need to override the newApplication() method to provide your application instance(s).

Using DropwizardAppRule at the suite level can speed up test runs, as the application is only started and stopped once for the entire suite:

 @RunWith(Suite.class)
 @SuiteClasses({FooTest.class, BarTest.class})
 public class MySuite {
   @ClassRule
   public static final DropwizardAppRule<MyConfig> DROPWIZARD = new DropwizardAppRule<>(...);
 }
 

If the same instance of DropwizardAppRule is reused at the suite- and class-level, then the application will be started and stopped once, regardless of whether the entire suite or a single test is executed.

 public class FooTest {
   @ClassRule public static final DropwizardAppRule<MyConfig> DROPWIZARD = MySuite.DROPWIZARD;

   public void testFoo() { ... }
 }

 public class BarTest {
   @ClassRule public static final DropwizardAppRule<MyConfig> DROPWIZARD = MySuite.DROPWIZARD;

   public void testBar() { ... }
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DropwizardAppRule.ServiceListener<T extends Configuration>

Constructor Summary

Constructors

Constructor and Description
DropwizardAppRule(Class<? extends Application<C>> applicationClass)
DropwizardAppRule(Class<? extends Application<C>> applicationClass, C configuration) Alternate constructor that allows specifying exact Configuration object to use, instead of reading a resource and binding it as Configuration object.
DropwizardAppRule(Class<? extends Application<C>> applicationClass, C configuration, Function<Application<C>,Command> commandInstantiator) Alternate constructor that allows specifying the command the Dropwizard application is started with.
DropwizardAppRule(Class<? extends Application<C>> applicationClass, String configPath, ConfigOverride... configOverrides)
DropwizardAppRule(Class<? extends Application<C>> applicationClass, String configPath, Optional<String> customPropertyPrefix, ConfigOverride... configOverrides)
DropwizardAppRule(Class<? extends Application<C>> applicationClass, String configPath, Optional<String> customPropertyPrefix, Function<Application<C>,Command> commandInstantiator, ConfigOverride... configOverrides)
DropwizardAppRule(DropwizardTestSupport<C> testSupport)

Method Summary

Modifier and Type	Method and Description
DropwizardAppRule<C>	addListener(DropwizardAppRule.ServiceListener<C> listener)
protected void	after()
protected void	before()
javax.ws.rs.client.Client	client() Returns a new HTTP Jersey Client for performing HTTP requests against the tested Dropwizard server.
protected org.glassfish.jersey.client.JerseyClientBuilder	clientBuilder()
int	getAdminPort()
<A extends Application<C>> A	getApplication()
C	getConfiguration()
Environment	getEnvironment()
int	getLocalPort()
com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper()
int	getPort(int connectorIndex)
DropwizardTestSupport<C>	getTestSupport()
DropwizardAppRule<C>	manage(io.dropwizard.lifecycle.Managed managed)
Application<C>	newApplication()

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

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass)

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass,
                         @Nullable
                         String configPath,
                         ConfigOverride... configOverrides)

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass,
                         String configPath,
                         Optional<String> customPropertyPrefix,
                         ConfigOverride... configOverrides)

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass,
                         String configPath,
                         Optional<String> customPropertyPrefix,
                         Function<Application<C>,Command> commandInstantiator,
                         ConfigOverride... configOverrides)

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass,
                         C configuration)

Alternate constructor that allows specifying exact Configuration object to use, instead of reading a resource and binding it as Configuration object.

Since:

0.9

DropwizardAppRule

public DropwizardAppRule(Class<? extends Application<C>> applicationClass,
                         C configuration,
                         Function<Application<C>,Command> commandInstantiator)

Alternate constructor that allows specifying the command the Dropwizard application is started with.

Since:

1.1.0

DropwizardAppRule

public DropwizardAppRule(DropwizardTestSupport<C> testSupport)

Method Detail

addListener

public DropwizardAppRule<C> addListener(DropwizardAppRule.ServiceListener<C> listener)

manage

public DropwizardAppRule<C> manage(io.dropwizard.lifecycle.Managed managed)

before

protected void before()

Overrides:

before in class org.junit.rules.ExternalResource

after

protected void after()

Overrides:

after in class org.junit.rules.ExternalResource

getConfiguration

public C getConfiguration()

getLocalPort

public int getLocalPort()

getPort

public int getPort(int connectorIndex)

getAdminPort

public int getAdminPort()

newApplication

public Application<C> newApplication()

getApplication

public <A extends Application<C>> A getApplication()

getEnvironment

public Environment getEnvironment()

getObjectMapper

public com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()

getTestSupport

public DropwizardTestSupport<C> getTestSupport()

client

public javax.ws.rs.client.Client client()

Returns a new HTTP Jersey Client for performing HTTP requests against the tested Dropwizard server. The client can be reused across different tests and automatically closed along with the server. The client can be augmented by overriding the clientBuilder() method.

Returns:

a new Client managed by the rule.

clientBuilder

protected org.glassfish.jersey.client.JerseyClientBuilder clientBuilder()