ru.vyarus.dropwizard.guice.module.installer.install.binding

Interface BindingInstaller

All Known Implementing Classes:

EagerSingletonInstaller, JerseyProviderInstaller, PluginInstaller, ResourceInstaller

public interface BindingInstaller

Marker interface must be used together with FeatureInstaller. Used for installers which requires custom bindings for extension. Note: binder.bind(type) is not called by default for binding installer, assuming installer will specify proper binding itself.

• bindExtension(Binder, Class, boolean) called for extensions not manually bound in guice
• checkBinding(Binder, Class, Binding) called for extensions, resolved from manual guice binding
• installBinding(Binder, Class) is always called after one of install methods above in order to apply registrations common for both registration types. Ideal for reporting.

Install methods may be also used to restrict extension declaration only as class or bindings.

If extension is annotated with LazyBinding boolean hint is passed and installer must decide what to do with it (preferably support or fail, not ignore). Bindings extensions (resolved from guice modules) may not be declared as lazy (this will be detected automatically).

Installer may be called multiple times if guice bindings or aop report is enabled. If required, report execution may be detected by used stage: binder.currentStage() == Stage.TOOL.

Since:

09.10.2014

See Also:

PluginInstaller

Method Summary

Modifier and Type	Method and Description
void	bindExtension(com.google.inject.Binder binder, java.lang.Class<?> type, boolean lazy) Called to apply custom binding for installed feature.
<T> void	checkBinding(com.google.inject.Binder binder, java.lang.Class<T> type, com.google.inject.Binding<T> manualBinding) Called for extensions, resolved from guice bindings (in user modules).
void	installBinding(com.google.inject.Binder binder, java.lang.Class<?> type) Called after execution of one of above methods.

Method Detail

bindExtension

void bindExtension(com.google.inject.Binder binder,
                   java.lang.Class<?> type,
                   boolean lazy)

Called to apply custom binding for installed feature. By default, all found extensions are installed as binder.bind(type). This method will be called instead of default registration.

Called only for non binding extensions (extensions that are not already bound in guice module.

WARNING: may be called multiple times due to enabled bindings reporting! Be sure to produce correct logs.

Parameters:

binder - guice binder

type - extension class

lazy - true if extension is annotated with LazyBinding

checkBinding

<T> void checkBinding(com.google.inject.Binder binder,
                      java.lang.Class<T> type,
                      com.google.inject.Binding<T> manualBinding)

Called for extensions, resolved from guice bindings (in user modules). May be used to validate binding or do some additional bindings with existing binding.

LazyBinding flag is not used here because guicey will automatically throw an error if existing binding is annotated as lazy binding (which don't makes any sense).

WARNING: may be called multiple times due to enabled bindings reporting! Be sure to produce correct logs.

Type Parameters:

T - extension type, used to connect extension class with binding

Parameters:

binder - guice binder

type - extension class

manualBinding - binding declaration from guice module

See Also:

for errors reporting

installBinding

void installBinding(com.google.inject.Binder binder,
                    java.lang.Class<?> type)

Called after execution of one of above methods. May be useful to perform common actions for both cases or simply for reporting.

WARNING: may be called multiple times due to enabled bindings reporting! Be sure to produce correct logs.

Parameters:

binder - guice binder

type - extension class