io.dropwizard.setup

Class Bootstrap<T extends Configuration>

java.lang.Object

io.dropwizard.setup.Bootstrap<T>

Type Parameters:

T - the configuration type

public class Bootstrap<T extends Configuration>
extends Object

The pre-start application environment, containing everything required to bootstrap a Dropwizard command.

Constructor Summary

Constructors

Constructor and Description
Bootstrap(Application<T> application) Creates a new Bootstrap for the given application.

Method Summary

Modifier and Type	Method and Description
void	addBundle(ConfiguredBundle<? super T> bundle) Adds the given bundle to the bootstrap.
void	addCommand(Command command) Adds the given command to the bootstrap.
void	addCommand(ConfiguredCommand<T> command) Adds the given command to the bootstrap.
Application<T>	getApplication() Returns the bootstrap's Application.
ClassLoader	getClassLoader() Returns the bootstrap's class loader.
List<Command>	getCommands() Returns the application's commands.
ConfigurationFactoryFactory<T>	getConfigurationFactoryFactory()
ConfigurationSourceProvider	getConfigurationSourceProvider() Returns the bootstrap's ConfigurationSourceProvider.
com.codahale.metrics.health.HealthCheckRegistry	getHealthCheckRegistry() returns the health check registry
com.codahale.metrics.jmx.JmxReporter	getJmxReporter() Returns the JmxReporter registered with the bootstrap's MetricRegistry.
com.codahale.metrics.MetricRegistry	getMetricRegistry() Returns the application metrics.
com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper() Returns the bootstrap's ObjectMapper.
javax.validation.ValidatorFactory	getValidatorFactory() Returns the application's validator factory.
void	registerMetrics() Registers the JVM metrics to the metric registry and start to report the registry metrics via JMX.
void	run(T configuration, Environment environment) Runs the bootstrap's bundles with the given configuration and environment.
void	setClassLoader(ClassLoader classLoader) Sets the bootstrap's class loader.
void	setConfigurationFactoryFactory(ConfigurationFactoryFactory<T> configurationFactoryFactory)
void	setConfigurationSourceProvider(ConfigurationSourceProvider provider) Sets the bootstrap's ConfigurationSourceProvider.
void	setHealthCheckRegistry(com.codahale.metrics.health.HealthCheckRegistry healthCheckRegistry)
void	setMetricRegistry(com.codahale.metrics.MetricRegistry metricRegistry) Sets a custom registry for the application metrics.
void	setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper) Sets the given ObjectMapper to the bootstrap.
void	setValidatorFactory(javax.validation.ValidatorFactory validatorFactory)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Bootstrap

public Bootstrap(Application<T> application)

Creates a new Bootstrap for the given application.

Parameters:

application - a Dropwizard Application

Method Detail

registerMetrics

public void registerMetrics()

Registers the JVM metrics to the metric registry and start to report the registry metrics via JMX.

getJmxReporter

@Nullable
public com.codahale.metrics.jmx.JmxReporter getJmxReporter()

Returns the JmxReporter registered with the bootstrap's MetricRegistry.

Since:

2.1

getApplication

public Application<T> getApplication()

Returns the bootstrap's Application.

getConfigurationSourceProvider

public ConfigurationSourceProvider getConfigurationSourceProvider()

Returns the bootstrap's ConfigurationSourceProvider.

setConfigurationSourceProvider

public void setConfigurationSourceProvider(ConfigurationSourceProvider provider)

Sets the bootstrap's ConfigurationSourceProvider.

getClassLoader

public ClassLoader getClassLoader()

Returns the bootstrap's class loader.

setClassLoader

public void setClassLoader(ClassLoader classLoader)

Sets the bootstrap's class loader.

addBundle

public void addBundle(ConfiguredBundle<? super T> bundle)

Adds the given bundle to the bootstrap.

Parameters:

bundle - a ConfiguredBundle

addCommand

public void addCommand(Command command)

Adds the given command to the bootstrap.

Parameters:

command - a Command

addCommand

public void addCommand(ConfiguredCommand<T> command)

Adds the given command to the bootstrap.

Parameters:

command - a ConfiguredCommand

getObjectMapper

public com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()

Returns the bootstrap's ObjectMapper.

setObjectMapper

public void setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Sets the given ObjectMapper to the bootstrap. WARNING: The mapper should be created by Jackson.newMinimalObjectMapper() or Jackson.newObjectMapper(), otherwise it will not work with Dropwizard.

Parameters:

objectMapper - an ObjectMapper

run

public void run(T configuration,
                Environment environment)
         throws Exception

Runs the bootstrap's bundles with the given configuration and environment.

Parameters:

configuration - the parsed configuration

environment - the application environment

Throws:

Exception - if a bundle throws an exception

getCommands

public List<Command> getCommands()

Returns the application's commands.

getMetricRegistry

public com.codahale.metrics.MetricRegistry getMetricRegistry()

Returns the application metrics.

setMetricRegistry

public void setMetricRegistry(com.codahale.metrics.MetricRegistry metricRegistry)

Sets a custom registry for the application metrics.

Parameters:

metricRegistry - a custom metric registry

getValidatorFactory

public javax.validation.ValidatorFactory getValidatorFactory()

Returns the application's validator factory.

setValidatorFactory

public void setValidatorFactory(javax.validation.ValidatorFactory validatorFactory)

getConfigurationFactoryFactory

public ConfigurationFactoryFactory<T> getConfigurationFactoryFactory()

setConfigurationFactoryFactory

public void setConfigurationFactoryFactory(ConfigurationFactoryFactory<T> configurationFactoryFactory)

getHealthCheckRegistry

public com.codahale.metrics.health.HealthCheckRegistry getHealthCheckRegistry()

returns the health check registry

setHealthCheckRegistry

public void setHealthCheckRegistry(com.codahale.metrics.health.HealthCheckRegistry healthCheckRegistry)