Skip to content

Configuration hooks

Guicey provides special mechanism for external configuration:

public class MyHook implements GuiceyConfigurationHook {
    @Override
    public void configure(GuiceBundle.Builder builder) {
        builder.bundles(new AdditinoalBundle());    
    }       
}

Hook implementation receive the same builder instance as used in GuiceBundle and so it is able to change everything (for example, GuiceyBundle abilities are limited).

Note

Hooks intended to be used in tests (e.g. to activate some diagnostic tools or disable application parts) and to activate diagnostic/tracking tools on compiled application.

Registration

When hook implemented as separate class it could be registered directly:

new MyHook().register()

For lambda-hook registration use:

ConfigurationHooksSupport.register(builder -> { 
    // do modifications 
})

Lifecycle

All hooks are executed just before guice bundle builder finalization (when you call last .build() method of GuiceBundle). Hooks registered after this moment will simply be never used.

Tests

Note

For hooks usage in tests there is a special test support (spock and junit).

In context of tests, the most important hook modifications are:

  • Change options
  • Disable any bundle, installer, extension, module
  • Register disable predicate (to disable features by package, registration source etc.)
  • Override guice bindings
  • Register additional bundles, extensions, modules (usually test-specific, for example guicey tests register additional guice module with restricted guice options (disableCircularProxies, requireExplicitBindings, requireExactBindingAnnotations))

Diagnostic

Hooks could be activated on compiled application with a system property:

-Dguicey.hooks=com.company.MyHook1,com.company.MyHook2 

To simplify usage you can register hook alias:

GuiceBindle.builder()
    .hookAlias("alias1", MyHook1.class)
    .hookAlias("alias2", MyHook2.class)   

Now, hooks could be activated as:

-Dguicey.hooks=alias1,alias2 

Moreover, you will always see these aliases in application startup logs (to not forget about this abilities):

INFO  [2019-09-16 16:26:35,229] ru.vyarus.dropwizard.guice.hook.ConfigurationHooksSupport: Available hook aliases [ -Dguicey.hooks=alias ]: 

    alias1                    com.company.MyHook1
    alias2                    com.company.MyHook2

Note

By default, guicey register diagnostic hook to easily activate diagnostic reports on compiled application:

-Dguicey.hooks=diagnistic