ru.vyarus.dropwizard.guice.module.installer

Interface FeatureInstaller<T>

Type Parameters:

T - expected extension type (or Object when no super type (e.g. for annotated beans))

All Known Implementing Classes:

AdminFilterInstaller, AdminServletInstaller, EagerSingletonInstaller, HealthCheckInstaller, JerseyProviderInstaller, LifeCycleInstaller, ManagedInstaller, PluginInstaller, ResourceInstaller, TaskInstaller

public interface FeatureInstaller<T>

Installer serve two purposes: find extension on classpath and properly install it (in dropwizard or somewhere else). Each installer should work with single feature.

Installers are not guice beans: they are instantiated during guice context start and used to register additional beans in guice context.

Installer may choose from three possible types of installation:

• BindingInstaller to apply specific guice bindings (called in process of injector creation, whereas other installer are called after)
• TypeInstaller to register class in environment or somewhere else
• InstanceInstaller to register instance in environment or somewhere else
• JerseyInstaller to register jersey related extension

Even if installer doesn't implement any of these types, extension will be still registered in guice.

Method Summary

Modifier and Type	Method and Description
boolean	matches(java.lang.Class<?> type) NOTE: consider using ru.vyarus.dropwizard.guice.module.installer.util.FeatureUtils to simplify checks (for example, types most likely must be checks to be not abstract).
void	report() Called to log registered endpoints in dropwizard log fashion.

Method Detail

matches

boolean matches(java.lang.Class<?> type)

NOTE: consider using ru.vyarus.dropwizard.guice.module.installer.util.FeatureUtils to simplify checks (for example, types most likely must be checks to be not abstract).

When type accepted by any extension it's registered in guice module.

Parameters:

type - type to check

Returns:

true if extension recognized, false otherwise

report

void report()

Called to log registered endpoints in dropwizard log fashion. It's important to naturally show all dynamically resolved classes to easily catch errors. Use Reporter to simplify reporting.

Method may do nothing if reporting not required