

Testing¶

You can use all existing dropwizard testing tools for unit tests.

Guicey tests¶

Guicey intended to shine in integration tests: it provides a lot of tools for application modification.

The most important is hooks mechanism which allows you to re-configure existing application. There are two main testing approaches:

Disable everything not required and register custom versions instead
Override some bindings (pure guice Modules.override() method)

Disable and replace¶

Suppose we have the following application:

public class App extends Application<MyConfig> {
    public void initialize(Bootstrap<MyConfig> bootstrap) {
        bootstrap.addBundle(GuiceBundle.builder()
            .bundles(new SecurityOnlyBundle())
            .modules(new ServiceModule(), new DaoModule())
            .build()
    }
}

Specifically for tests we create special module MockDaoModule which applies all the same bindings, but with mock implementations.

Just for demonstration, suppose that application registers SecurityOnlyBundle which do nothing except of additional security. Suppose we don't need this in tests.

@TestGuiceyApp(App.class)
public class MyTest {   

    @EnableHook
    static GuiceyConfigurationHook HOOK = builder -> 
                                builder.disableBundles(SecurityOnlyBundle.class)
                                       .disableModules(DaoModule.class)
                                       .modules(new MockDaoModule());                
}

Here hook applied to:

remove SecurityOnlyBundle
remove DaoModule
add MockDaoModule

This way you can disable everything: module, extensions, guicey and dropwizard bundles and installers.

Note

Bundles (both guice and dropwizard) and guice modules are actually hierarchical (one bundle/module can register other bundle/module) and you can disable even exact bundle/module inside this hierarchy (not just directly registered). See more: about guice transitive bundles and dropwizard transitive bundles

All disables are shown on diagnostic report - you can use it to verify configuration state.

Override bindings¶

We can do the same without replacing module, but overriding bindings using guice Modules.override() feature. This is preferred in cases when modules are not so well structured and you need to override just a subset of bindings (not all bindings in module).

Above example would look like:

@TestDropwizardApp(App.class)
public class MyTest {    

    @EnableHook
    static GuiceyConfigurationHook HOOK = builder -> 
                                builder.disableBundles(SecurityOnlyBundle.class)                                       
                                       .modulesOverride(new MockDaoModule());       
}

In the previous example all bindings from DaoModule were removed and here we just register overriding bindings so bindings from MockDaoModule will be used instead of (the same) bindings from DaoModule.

Note

All overrides are visible on guice report - use it to verify override correctness.

Configuration¶

For tests you can use custom configuration file (e.g. src/test/resources/test-config.yml).

@TestDropwizardApp(value = MyApp.class, conifg="src/test/resources/test-config.yml")

Or just override exact values (without declaring config file):

@TestDropwizardApp(value = MyApp.class, conifgOverride = "server.applicationConnectors[0].port: 0")

Lightweight tests¶

In many cases, you don't need the entire application, but just a working Injector to check core application logic.

For such cases, guicey provides lightweight extensions like @TestGuiceyApp:

will not start jetty (no ports bind, no HK2 launched)
start Managed objects to simulate lifecycle

These tests work much faster!

@TestGuiceyApp(App.class)
public class MyTest {    

    @EnableHook
    static GuiceyConfigurationHook HOOK = builder -> 
                            builder.disableBundles(SecurityOnlyBundle.class)                                       
                                   .modulesOverride(new MockDaoModule());    

    @Test
    public void test(MyService service) {
         service.doSomething();
         ...  
    }       
}

Spock¶

All examples above was for junit 5. You can also use groovy-based Spock framework instead of junit. Spock tests are much easier to write (you can write less code) and more expressive. Junit 5 and spock extensions are almost identical, so its more the language preference.

Guicey provides all required extensions to write tests above with spock.

For example, the first example will look like:

@UseDropwizardApp(App)
class MyTest extends Specification {    

    @EnableHook
    static GuiceyConfigurationHook HOOK = { it.disableBundles(SecurityOnlyBundle.class)
                                            .disableModules(DaoModule.class)
                                            .modules(new MockDaoModule()) }

    @Inject
    MyService service

    def 'Check service method'() {

        when: 'calling service method'
        def res = service.doSoomething()

        then: 'value is correct'
        res == 12
    }      
}

Note

Only junit 5 currently support running tests in parallel.