ru.vyarus.dropwizard.guice

Enum GuiceyOptions

java.lang.Object

java.lang.Enum<GuiceyOptions>

ru.vyarus.dropwizard.guice.GuiceyOptions

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<GuiceyOptions>, Option

public enum GuiceyOptions
extends java.lang.Enum<GuiceyOptions>
implements Option

Guicey core options. In most cases, direct option definition is not required because all options are covered with shortcut method in GuiceBundle.Builder. Direct option definition may be useful when option is dynamically resolved and so shortcut methods can't be used (will require builder flow interruption and additional if statements).

Normally options are mostly useful for runtime configuration values access (e.g. check in some 3rd party bundle what packages are configured for classpath scan).

Generally options are not limited to this enum and custom option enums may be used by 3rd party bundles.

Since:

09.08.2016

See Also:

for details, for usage in guice services, for reporting

Enum Constant Summary

Enum Constants

Enum Constant and Description
BindConfigurationByPath Introspect configuration object (using jackson serialization) and bind all internal values by path (@Inject @Config("path.to.value") Integer value).
BindConfigurationInterfaces Deprecated. remains for compatibility, instead bind configuration interfaces with @Config qualifier
ConfigureFromDropwizardBundles Recognize GuiceyBundle from installed dropwizard bundles.
GuiceFilterRegistration GuiceFilter registered for both contexts (application and admin) to provide guice ServletModule support and allow using request and session scopes.
InjectorStage Guice injector stage used for injector creation.
ScanPackages Packages for classpath scan.
SearchCommands Enables commands search in classpath and dynamic installation.
UseCoreInstallers Automatic core installers installation.
UseHkBridge Enables guice bridge for HK2 to allow HK2 services to see guice beans.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getDefaultValue()
java.lang.Class<?>	getType()
static GuiceyOptions	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static GuiceyOptions[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ScanPackages

public static final GuiceyOptions ScanPackages

Packages for classpath scan. Not empty value indicates auto scan mode enabled. Empty by default.

See Also:

GuiceBundle.Builder.enableAutoConfig(String...)

SearchCommands

public static final GuiceyOptions SearchCommands

Enables commands search in classpath and dynamic installation. Requires auto scan mode. Disabled by default.

See Also:

GuiceBundle.Builder.searchCommands()

UseCoreInstallers

public static final GuiceyOptions UseCoreInstallers

Automatic core installers installation. Enabled by default.

See Also:

GuiceBundle.Builder.noDefaultInstallers()

ConfigureFromDropwizardBundles

public static final GuiceyOptions ConfigureFromDropwizardBundles

Recognize GuiceyBundle from installed dropwizard bundles. Disabled by default.

See Also:

GuiceBundle.Builder.configureFromDropwizardBundles()

BindConfigurationInterfaces

@Deprecated
public static final GuiceyOptions BindConfigurationInterfaces

Deprecated. remains for compatibility, instead bind configuration interfaces with @Config qualifier

Bind all direct interfaces implemented by configuration objects to configuration instance in guice context. Disabled by default.

Note: interfaces are always bound with qualifier: @Inject @Config ConfInterface config. Option only controls if extra binding must be done without qualifier.

See Also:

GuiceBundle.Builder.bindConfigurationInterfaces()

BindConfigurationByPath

public static final GuiceyOptions BindConfigurationByPath

Introspect configuration object (using jackson serialization) and bind all internal values by path (@Inject @Config("path.to.value") Integer value). Recognize unique sub configuration objects for direct binding (@Inject @Config SubConfig conf). Enabled by default.

Note that path could be hidden using JsonIgnore on property getter.

Option exists only for edge cases when introspection fails and prevents application startup (should be impossible) or due to project specific reasons (when internal bindings are not desirable). When disabled, only configuration object itself would be bound (by all classes in hierarchy and interfaces). Note that ConfigurationTree will also not contain paths - option disables entire introspection process.

See Also:

ConfigTreeBuilder, ConfigurationTree, ConfigBindingModule

InjectorStage

public static final GuiceyOptions InjectorStage

Guice injector stage used for injector creation. Production by default.

See Also:

GuiceBundle.Builder.build(Stage)

GuiceFilterRegistration

public static final GuiceyOptions GuiceFilterRegistration

GuiceFilter registered for both contexts (application and admin) to provide guice ServletModule support and allow using request and session scopes. By default, filter is registered only for direct requests. Declare other types if required (but note that GuiceFilter does not support ASYNC!).

To disable guice filter installation use empty set: EnumSet.noneOf(DispatcherType.class). This will completely disable guice servlet modules support because without guice filter, guice web support is useless (all filters and servlets registered in servlet module are dispatched by guice filter).

Note that even without guice servlet modules support HttpServletRequest and HttpServletResponse objects will be still available for injection in resources (through HK2 bridging). Also, note that guice servlets initialization took some time and application starts faster without it (~50ms). Use WebInstallersBundle to register guice manged servlets and filters. IMPORTANT: after disabling guice filter, servlet and request scopes will no longer be available and installation of guice ServletModule will be impossible (will fail on duplicate binding). Also it will not be possible to use http request and response injections under filter and servlets (it will work only with resources).

UseHkBridge

public static final GuiceyOptions UseHkBridge

Enables guice bridge for HK2 to allow HK2 services to see guice beans. This is not often required and so disabled by default. For example, it could be required if HK2Managed used to properly instantiate service by HK2 when it also depends on guice services.

IMPORTANT: requires extra dependency on HK2 guice-bridge: 'org.glassfish.hk2:guice-bridge:2.5.0-b32'

Method Detail

values

public static GuiceyOptions[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (GuiceyOptions c : GuiceyOptions.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static GuiceyOptions valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getType

public java.lang.Class<?> getType()

Specified by:

getType in interface Option

Returns:

option type

getDefaultValue

public java.lang.Object getDefaultValue()

Specified by:

getDefaultValue in interface Option

Returns:

option default value or null