Dropwizard Guicey

https://github.com/xvik/dropwizard-guicey
Admin
Dropwizard Guicey integrates Guice dependency injection with Dropwizard applications, offering...
Tokens:684,196
Snippets:4,711
Trust Score:8.9
License:MIT
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Example installers report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/installers-report.md

Example output of the installers report. It shows the installers in processing order with their features and the configuration tree of installer bundles. The report is a re-configured configuration report but shows all installers, even unused ones.

```text
INFO  [2019-10-11 06:09:06,085] ru.vyarus.dropwizard.guice.debug.ConfigurationDiagnostic: Available installers report

---------------------------------------------------------------------------[CONFIGURATION]

    INSTALLERS in processing order = 
        OBJECT, ORDER                  lifecycle            (r.v.d.g.m.i.f.LifeCycleInstaller)     
        OBJECT, ORDER                  managed              (r.v.d.g.m.i.feature.ManagedInstaller) 
        OBJECT                         jerseyfeature        (r.v.d.g.m.i.f.j.JerseyFeatureInstaller) 
        JERSEY, BIND, OPTIONS          jerseyprovider       (r.v.d.g.m.i.f.j.p.JerseyProviderInstaller) 
        TYPE, JERSEY, BIND, OPTIONS    resource             (r.v.d.g.m.i.f.j.ResourceInstaller)    
        BIND                           eagersingleton       (r.v.d.g.m.i.f.e.EagerSingletonInstaller) 
        OBJECT                         healthcheck          (r.v.d.g.m.i.f.h.HealthCheckInstaller) 
        OBJECT                         task                 (r.v.d.g.m.i.feature.TaskInstaller)    
        BIND                           plugin               (r.v.d.g.m.i.f.plugin.PluginInstaller) 
        OBJECT, OPTIONS, ORDER         webservlet           (r.v.d.g.m.i.f.w.WebServletInstaller)  
        OBJECT, ORDER                  webfilter            (r.v.d.g.m.i.f.web.WebFilterInstaller) 
        OBJECT, OPTIONS, ORDER         weblistener          (r.v.d.g.m.i.f.w.l.WebListenerInstaller) 


---------------------------------------------------------------------------[CONFIGURATION TREE]

    APPLICATION
    │   
    └── CoreInstallersBundle         (r.v.d.g.m.installer)      
        ├── installer  LifeCycleInstaller           (r.v.d.g.m.i.feature)      
        ├── installer  ManagedInstaller             (r.v.d.g.m.i.feature)      
        ├── installer  JerseyFeatureInstaller       (r.v.d.g.m.i.f.jersey)     
        ├── installer  JerseyProviderInstaller      (r.v.d.g.m.i.f.j.provider) 
        ├── installer  ResourceInstaller            (r.v.d.g.m.i.f.jersey)     
        ├── installer  EagerSingletonInstaller      (r.v.d.g.m.i.f.eager)      
        ├── installer  HealthCheckInstaller         (r.v.d.g.m.i.f.health)     
        ├── installer  TaskInstaller                (r.v.d.g.m.i.feature)      
        ├── installer  PluginInstaller              (r.v.d.g.m.i.f.plugin)     
        │   
        └── WebInstallersBundle          (r.v.d.g.m.installer)      
            ├── installer  WebFilterInstaller           (r.v.d.g.m.i.f.web)        
            ├── installer  WebServletInstaller          (r.v.d.g.m.i.f.web)        
            └── installer  WebListenerInstaller         (r.v.d.g.m.i.f.w.listener)      
```

--------------------------------

### Example extensions help report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/extensions-report.md

Example output of the extensions help report. Shows recognized extension signs grouped by installer, with installers listed in processing order; the first installer to recognize an extension owns it.

```text
INFO  [2022-12-28 14:57:01,445] ru.vyarus.dropwizard.guice.debug.ExtensionsHelpDiagnostic: Recognized extension signs

    lifecycle            (r.v.d.g.m.i.f.LifeCycleInstaller)     
        implements LifeCycle

    managed              (r.v.d.g.m.i.feature.ManagedInstaller) 
        implements Managed

    jerseyfeature        (r.v.d.g.m.i.f.j.JerseyFeatureInstaller) 
        implements Feature

    jerseyprovider       (r.v.d.g.m.i.f.j.p.JerseyProviderInstaller) 
        @Provider on class
        implements ExceptionMapper
        implements ParamConverterProvider
        implements ContextResolver
        implements MessageBodyReader
        implements MessageBodyWriter
        implements ReaderInterceptor
        implements WriterInterceptor
        implements ContainerRequestFilter
        implements ContainerResponseFilter
        implements DynamicFeature
        implements ValueParamProvider
        implements InjectionResolver
        implements ApplicationEventListener
        implements ModelProcessor

    resource             (r.v.d.g.m.i.f.j.ResourceInstaller)    
        @Path on class
        @Path on implemented interface

    eagersingleton       (r.v.d.g.m.i.f.e.EagerSingletonInstaller) 
        @EagerSingleton on class

    healthcheck          (r.v.d.g.m.i.f.h.HealthCheckInstaller) 
        extends NamedHealthCheck

    task                 (r.v.d.g.m.i.feature.TaskInstaller)    
        extends Task

    plugin               (r.v.d.g.m.i.f.plugin.PluginInstaller) 
        @Plugin on class
        custom annotation on class, annotated with @Plugin

    webservlet           (r.v.d.g.m.i.f.w.WebServletInstaller)  
        extends HttpServlet + @WebServlet

    webfilter            (r.v.d.g.m.i.f.web.WebFilterInstaller) 
        implements Filter + @WebFilter

    weblistener          (r.v.d.g.m.i.f.w.l.WebListenerInstaller) 
        implements EventListener + @WebListener
```

--------------------------------

### Log output for installed resource

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/getting-started.md

Example log output showing that the resource was automatically installed and the path /sample/ was registered. This appears when the application runs.

```text
INFO  [2017-02-05 11:23:31,188] io.dropwizard.jersey.DropwizardResourceConfig: The following paths were found for the configured resources:

    GET     /sample/ (ru.vyarus.dropwizard.guice.examples.rest.SampleResource)
```

--------------------------------

### Complex setup object implementing TestExecutionListener

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Shows a complex setup object that implements both TestEnvironmentSetup and TestExecutionListener, registering itself via extension.listen(this) in the setup method. The started method is overridden to react to the application start event.

```java
public class MySetup implements TestEnvironmentSetup, TestExecutionListener {
    @Override
    public Object setup(TestExtension extension) throws Exception {
        extension.listen(this);
    }

    @Override
    public void started(final EventContext context) throws Exception {
        // something
    }
}
```

--------------------------------

### Run application with server command

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/ext-jdbi3/README.md

Command to start the application normally using the provided example configuration file. Assumes running the main class from an IDE.

```text
Jdbi3Application server example-config.yml
```

--------------------------------

### Complete JUnit raw test example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/general/run.md

Complete JUnit example using raw test support: setup() creates the support object and calls before(), before() injects beans, cleanup() calls after(), and the test uses the injected service. Note that support.before() automatically calls after() on startup error.

```java
public class RawTest {

    static DropwizardTestSupport support;

    @Inject MyService service;

    @BeforeAll
    public static void setup() {
        support = TestSupport.coreApp(App.class);
        // support = TestSupport.webApp(App.class);
        // start app
        support.before();
    }

    @BeforeEach
    public void before() {
        // inject services in test
        TestSupport.injectBeans(support, this);
    }

    @AfterAll
    public static void cleanup() {
        if (support != null) {
            support.after();
        }
    }

    @Test
    public void test() {
        Assertions.assertEquals("10", service.computeValue());
    }
}
```

--------------------------------

### Implement TestEnvironmentSetup to start a test database

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Implement the TestEnvironmentSetup interface to prepare the environment before application startup. The setup method receives a TestExtension to apply configuration overrides. Returning a Closeable object ensures it is closed after application shutdown; other return values are ignored.

```java
public class TestDbSetup implements TestEnvironmentSetup {

    @Override
    public Object setup(TestExtension extension) throws Exception {
        // pseudo code
        Db db = DbFactory.startTestDb();
        // register required configuration
        extension
                .configOverride("database.url", ()-> db.getUrl())
                .configOverride("database.user", ()-> db.getUser())
                .configOverride("database.password", ()-> db.getPassword);
        // assuming object implements Closable
        return db;
    }
}
```

--------------------------------

### Application setup with GuiceBundle

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/tests.md

Shows the application class used in the testing examples. It registers a Guice bundle with a security bundle and service/DAO modules. This is the base application that tests will modify.

```java
public class App extends Application<MyConfig> {
    public void initialize(Bootstrap<MyConfig> bootstrap) {
        bootstrap.addBundle(GuiceBundle.builder()
            .bundles(new SecurityOnlyBundle())
            .modules(new ServiceModule(), new DaoModule())
            .build()
    }
}
```

--------------------------------

### Installer report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/core-installer-custom/README.md

Output shown after startup, indicating the installer detected and installed the SampleMarker extension.

```text
INFO  [2019-12-31 08:54:11,994] ru.vyarus.dropwizard.guice.examples.installer.MarkersInstaller: Installed markers = 

    r.v.d.g.e.service.SampleMarker

```

--------------------------------

### Start application with server config.yml

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/ext-gsp/README.md

Command-line arguments to start the application with the configuration file 'config.yml'.

```text
server config.yml
```

--------------------------------

### ManagedInstaller report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/installers.md

Example output from the ManagedInstaller's report() method, showing the installed managed extension. The report is logged at INFO level and includes the installer class name and the extension class.

```text
INFO  [2016-08-21 23:49:49,534] ru.vyarus.dropwizard.guice.module.installer.feature.ManagedInstaller: managed =

    (ru.vyarus.dropwizard.guice.support.feature.DummyManaged)

```

--------------------------------

### Duplicate bundle registration example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/deduplication.md

Illustrates the duplicate bundle problem: two bundles each install the same common bundle, causing it to be installed twice. The example shows the bundle classes and the GuiceBundle builder usage.

```java
public class Feature1Bundle implements GuiceyBundle {
    @Override
    public void initialize(GuiceyBootstrap bootstrap) throws Exception {
        bootstrap.bundles(new CommonBundle);
    }
}

public class Feature2Bundle implements GuiceyBundle {
    @Override
    public void initialize(GuiceyBootstrap bootstrap) throws Exception {
        bootstrap.bundles(new CommonBundle);
    }
}

GuiceBundle.buider()
    .bundles(new Feature1Bundle(). new Feature2Bundle())
    ...
```

--------------------------------

### Setup field with lambda listener shortcuts

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Demonstrates using lambda shortcuts for listener methods on a setup field. The @EnableSetup annotation marks the field, and the setup object is configured with chained on... methods for each lifecycle event.

```java
public class Test {

    @EnableSetup
    static TestDbSetup db = ext - > ext
            .onApplicationStarting(event -> ...)
            .onApplicationStart(event -> ...)
            .onBeforeAll(event -> ...)
            .onBeforeEach(event -> ...)
            .onAfterEach(event -> ...)
            .onAfterAll(event -> ...)
            .onApplicationStopping(event -> ...)
            .onApplicationStop(event -> ...)
}
```

--------------------------------

### Implement ModelProcessor

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/installers/jersey-ext.md

Any class implementing org.glassfish.jersey.server.model.ModelProcessor (or extending an abstract class implementing it) can be installed. The example shows the required processResourceModel and processSubResource methods.

```java
public class MyModelProcessor implements ModelProcessor {

    @Override
    public ResourceModel processResourceModel(ResourceModel resourceModel,
                                              Configuration configuration) {
        return resourceModel;
    }

    @Override
    public ResourceModel processSubResource(ResourceModel subResourceModel,
                                            Configuration configuration) {
        return subResourceModel;
    }
}
```

--------------------------------

### Install ServerPagesBundle in GuiceBundle

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/extras/gsp.md

Install the global ServerPagesBundle in the main application class. It configures and installs dropwizard-views (global) and supports the same configurations as the pure dropwizard-views bundle. Remove any direct ViewBundle registrations if previously used.

```java
GuiceBundle.builder()
    .bundles(ServerPagesBundle.builder().build());
```

--------------------------------

### Registering multiple bundle instances

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/bundles.md

Shows how to register multiple instances of the same bundle. This example is used to illustrate the need for bundle de-duplication, as installing the same bundle multiple times may not be intended.

```java
.bundles(new MyBundle(), new MyBundle())
```

--------------------------------

### Managed Object Installation Log

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/getting-started.md

Startup log output showing the managed object installation. Guicey reports installed extensions when Dropwizard does not.

```text
INFO  [2017-02-05 11:59:30,750] ru.vyarus.dropwizard.guice.module.installer.feature.ManagedInstaller: managed =

    (ru.vyarus.dropwizard.guice.examples.service.SampleBootstrap)
```

--------------------------------

### Add reporting to installer with Reporter

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/installers.md

Installer with reporting. The report method is called automatically after all extensions installation. The reporter is created with the installer class and a label, and lines are added during install.

```java
public class ScheduledInstaller implements FeatureInstaller,
                                           InstanceInstaller<ScheduledTask> {
    
    private final Reporter reporter = 
            new Reporter(ScheduledInstaller.class, "scheduled tasks =");
    ...    
    
    @Override
    public void install(Environment environment, ScheduledTask instance) {
        SchedulerFramework.registerTask(instance);
        // register for reporting
        reporter.line("(%s)", FeatureUtils.getInstanceClass(instance).getName());
    }   
                          
    @Override
    public void report() {
        reporter.report();    
    }
}
```

--------------------------------

### Add command listener for setup and cleanup

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/general/command.md

Attach a listener for setup and cleanup actions during command execution. The listener interface provides setup(String[] args) and cleanup(CommandResult<TestConfiguration> result) methods.

```java
TestSupport.buildCommandRunner(App.class)
        .listen(new CommandRunBuilder.CommandListener<>() {
            public void setup(String[] args) { ... }
            public void cleanup(CommandResult<TestConfiguration> result) { ... }
        })
        .run("cmd")
```

--------------------------------

### Default installers list output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/core-installers-reset/README.md

Output of the default installers in processing order, as printed by Guicey. Shows all default installers with their types and options.

```text
    INSTALLERS in processing order = 
        OBJECT, ORDER                  lifecycle            (r.v.d.g.m.i.f.LifeCycleInstaller)     
        OBJECT, ORDER                  managed              (r.v.d.g.m.i.feature.ManagedInstaller) 
        OBJECT                         jerseyfeature        (r.v.d.g.m.i.f.j.JerseyFeatureInstaller) 
        JERSEY, BIND, OPTIONS          jerseyprovider       (r.v.d.g.m.i.f.j.p.JerseyProviderInstaller) 
        TYPE, JERSEY, BIND, OPTIONS    resource             (r.v.d.g.m.i.f.j.ResourceInstaller)    
        BIND                           eagersingleton       (r.v.d.g.m.i.f.e.EagerSingletonInstaller) 
        OBJECT                         healthcheck          (r.v.d.g.m.i.f.h.HealthCheckInstaller) 
        OBJECT                         task                 (r.v.d.g.m.i.feature.TaskInstaller)    
        BIND                           plugin               (r.v.d.g.m.i.f.plugin.PluginInstaller) 
        OBJECT, OPTIONS, ORDER         webservlet           (r.v.d.g.m.i.f.w.WebServletInstaller)  
        OBJECT, ORDER                  webfilter            (r.v.d.g.m.i.f.web.WebFilterInstaller) 
        OBJECT, OPTIONS, ORDER         weblistener          (r.v.d.g.m.i.f.w.l.WebListenerInstaller) 
```

--------------------------------

### PluginInstaller report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/installers.md

Example output from the PluginInstaller's report() method, showing installed plugins grouped by type: a Set of PluginInterface and a Map keyed by DummyPluginKey. The report is logged at INFO level.

```text
INFO  [2016-08-21 23:49:49,535] ru.vyarus.dropwizard.guice.module.installer.feature.plugin.PluginInstaller: plugins =

    Set<PluginInterface>
        (ru.vyarus.dropwizard.guice.support.feature.DummyPlugin1)
        (ru.vyarus.dropwizard.guice.support.feature.DummyPlugin2)

    Map<DummyPluginKey, PluginInterface>
        ONE        (ru.vyarus.dropwizard.guice.support.feature.DummyNamedPlugin1)
        TWO        (ru.vyarus.dropwizard.guice.support.feature.DummyNamedPlugin2)

```

--------------------------------

### Declare setup object with lambda in field

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Declares a setup object as a static field using a lambda that receives the extension and returns the setup object. The lambda configures a database URL override and returns the created Db instance.

```java
@EnableSetup
static TestEnvironmentSetup db = ext -> {
            Db db = new Db();
            ext.configOverride("db.url", ()->db.getUrl())
            return db;
        };
```

--------------------------------

### Installers timing output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/configuration-report.md

Shows the time spent on installer initialization and processing, including the number of registered installers and extension recognition time.

```text
    ├── [7.4%] INSTALLERS processed in 32.60 ms
    │   ├── registered 12 installers
    │   └── 4 extensions recognized from 10 classes in 11.63 ms
```

--------------------------------

### Implement JerseyInstaller for custom feature

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/installers.md

Jersey installer example for a CustomFeature base class. Uses JerseyInstaller and binds components with JerseyBinding.bindComponent. Jersey installers are called on jersey start and may be complex due to binding aspects.

```java
public class CustomInstaller implements FeatureInstaller, JerseyInstaller<CustomFeature> {
    @Override
    public boolean matches(final Class<?> type) {
        return FeatureUtils.is(type, CustomFeature.class);
    }
    
    @Override
    public void install(final AbstractBinder binder, final Class<CustomFeature> type) {
        JerseyBinding.bindComponent(binder, type, false, false); 
        ...
    }
    
    @Override
    public void report() { 
        ...
    }
} 
```

--------------------------------

### Console output for installed repositories

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/extras/jdbi3.md

All installed repositories are reported in the console with this format.

```text
INFO  [2016-12-05 19:42:27,374] ru.vyarus.guicey.jdbi3.installer.repository.RepositoryInstaller: repositories =

    (ru.vyarus.guicey.jdbi3.support.repository.SampleRepository)
```

--------------------------------

### Disable default installers and register only ResourceInstaller

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/core-installers-reset/README.md

Java code using GuiceBundle.builder() to disable all default installers with .noDefaultInstallers(), then register only ResourceInstaller and add SampleResource extension. Also prints available installers with .printAvailableInstallers().

```java
GuiceBundle.builder()   
    .noDefaultInstallers()
    .installers(ResourceInstaller.class)
    .extensions(SampleResource.class)
    // see all registered installers
    .printAvailableInstallers()     
    .build()
```

--------------------------------

### Startup log with hook aliases

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/hooks.md

Example of application startup log output showing available hook aliases. This log is always printed to remind about the aliases.

```text
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
```

--------------------------------

### Diagnostic report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/core-extensions/README.md

Example diagnostic report output shown when ExtensionsDemoApplication starts. It lists installers and extensions in processing order, plus the application tree with classpath scan and Guice bindings sections.

```text
    INSTALLERS and EXTENSIONS in processing order = 
        resource             (r.v.d.g.m.i.f.j.ResourceInstaller)    
            MyResource                   (r.v.d.g.e.rest)           
            MyResourceFromScan           (r.v.d.g.e.rest.scan)      *SCAN
            MyResourceFromBinding        (r.v.d.g.e.rest)           *BINDING  


    APPLICATION
    ├── extension  MyResource                   (r.v.d.g.e.rest)           
    ├── module     AppModule                    (r.v.d.guice.examples)     
    ├── module     GuiceBootstrapModule         (r.v.d.guice.module)       
    │   
    ├── CoreInstallersBundle         (r.v.d.g.m.installer)      
    │   ├── installer  ResourceInstaller            (r.v.d.g.m.i.f.jersey)     
    │   └── WebInstallersBundle          (r.v.d.g.m.installer)      
    │   
    ├── CLASSPATH SCAN
    │   └── extension  MyResourceFromScan           (r.v.d.g.e.rest.scan)      
    │   
    └── GUICE BINDINGS
        │   
        └── AppModule                    (r.v.d.guice.examples)     
            └── extension  MyResourceFromBinding        (r.v.d.g.e.rest)  
```

--------------------------------

### Sample startup time report output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/startup-report.md

Sample log output from the startup time report. Shows the hierarchical breakdown of JVM time, application startup, Dropwizard initialization, and run phases with individual timings for bundles, installers, listeners, and commands.

```text
INFO  [2025-03-27 09:12:27,435] ru.vyarus.dropwizard.guice.debug.StartupTimeDiagnostic: Application startup time: 

	JVM time before                    : 1055 ms

	Application startup                : 807 ms
		Dropwizard initialization          : 127 ms
			GuiceBundle                        : 123 ms (finished since start at 127 ms)
				Bundle builder time                : 38 ms
				Hooks processing                   : 3.23 ms
					StartupDiagnosticTest$Test1$$Lambda/0x0000711de72a1d70: 2.37 ms
				Classpath scan                     : 44 ms
				Commands processing                : 4.41 ms
					DummyCommand                       : 0.42 ms
					NonInjactableCommand               : 3.16 ms
				Bundles lookup                     : 1.15 ms
				Guicey bundles init                : 3.24 ms
					WebInstallersBundle                : 0.52 ms
					CoreInstallersBundle               : 1.83 ms
				Installers time                    : 21 ms
					Installers resolution              : 15 ms
					Scanned extensions recognition     : 6.13 ms
				Listeners time                     : 1.35 ms
					ConfigurationHooksProcessedEvent   : 0.23 ms
					BeforeInitEvent                    : 0.59 ms
					BundlesResolvedEvent               : 0.009 ms
					BundlesInitializedEvent            : 0.43 ms
					CommandsResolvedEvent              : 0.006 ms
					InstallersResolvedEvent            : 0.01 ms
					ClasspathExtensionsResolvedEvent   : 0.009 ms
					InitializedEvent                   : 0.007 ms

		Dropwizard run                     : 679 ms
			Configuration and Environment      : 483 ms
			GuiceBundle                        : 196 ms
				Configuration analysis             : 20 ms
		...
```

--------------------------------

### Inject Dropwizard Environment in Guice bean

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/guice/bindings.md

Shows how to inject the Dropwizard Environment into a Guice bean to perform additional configurations not covered by installers. The example adds a server lifecycle listener that calls a method when the server starts.

```java
public class MyBean {
    
    @Inject
    public MyBean(Environment environment) {
        environment.lifecycle().addServerLifecycleListener(new ServerLifecycleListener {
            public void serverStarted(Server server) {
                callSomeMethod();
            }
        })
    }
}
```

--------------------------------

### GuiceyEnvironment.onApplicationStartup(ApplicationStartupListener listener)

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/configuration.md

Shortcut for manual actions after complete application start (jetty started). Also called after guicey initialization in lightweight guicey tests.

```APIDOC
## GuiceyEnvironment.onApplicationStartup(ApplicationStartupListener listener)

### Description
Shortcut for manual actions after complete application start (jetty started). Also called after guicey initialization in lightweight guicey tests.

### Method
onApplicationStartup

### Signature
`void onApplicationStartup(ApplicationStartupListener listener)`

### Parameters
- **listener** (ApplicationStartupListener) - Required - The application startup listener to register.
```

--------------------------------

### GET /get/{name}

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/reference/rest-client.md

Example of a GET resource method with a path parameter.

```APIDOC
## [GET] /get/{name}

### Description
Retrieves a list of integers by name path parameter.

### Method
GET

### Endpoint
/get/{name}

### Parameters
#### Path Parameters
- **name** (String) - Required - Path parameter used to identify the resource.

### Response
#### Success Response (200)
- **body** (List<Integer>) - The list of integers returned by the endpoint.

#### Response Example
```json
[1, 2, 3]
```
```

--------------------------------

### Disable all installations from a package

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/concepts.md

Example of using Disables.inPackage to disable all installations (extensions, bundles, etc.) from a specific package.

```java
.disable(Disables.inPackage("some.package.here"))
```

--------------------------------

### Implement getRecognizableSigns() in custom installer

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/extensions-report.md

Example implementation of getRecognizableSigns() for a custom installer to participate in the extensions help report. This method is not required but allows the installer to list its recognizable signs.

```java
public class EagerSingletonInstaller implements FeatureInstaller {
    ...
    
    @Override
    public List<String> getRecognizableSigns() {
        return Collections.singletonList("@" + EagerSingleton.class.getSimpleName() + " on class");
    }
}
```

--------------------------------

### Define async servlet with example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/installers/servlet.md

Defines an asynchronous servlet. The guice servlet module does not support async servlets, so the installer is the only option to install them.

```java
@WebServlet(urlPatterns = "/async", asyncSupported = true)
public class AsyncServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        final AsyncContext context = req.startAsync();
        context.start(() -> {
            context.getResponse().getWriter().write("done!");
            context.complete();
        });
    }
}
```

--------------------------------

### Filter Installation Log

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/getting-started.md

Startup log output confirming the filter installation. The filter is mapped to /* and is named .auth.

```text
INFO  [2017-02-11 17:18:16,943] ru.vyarus.dropwizard.guice.module.installer.feature.web.WebFilterInstaller: filters =

    /*                       (ru.vyarus.dropwizard.guice.examples.web.AuthFilter)   .auth
```

--------------------------------

### Manual extension declaration with GuiceBundle.builder()

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/guice/module-analysis.md

Equivalent to the module bindings example: manually declaring the same extensions via GuiceBundle builder. Guicey uses the same installers for recognition and installation, but does not create default bindings when extensions are already bound.

```java
GuiceBundle.builder()
    .extensions(MyResource.class, MyManaged.class)
```

--------------------------------

### Transitive module disabling example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/concepts.md

Shows a module that installs another module transitively, and how disabling the transitive module works.

```java
public class MyModule extends AbstractModule {
    @Override
    protected void configure() {
        // transitive
        install(new OtherMyModule());
    }
}

GuiceBundle.builder()
    .modules(new MyModule())
    .disableModules(OtherMyModule.class)
```

--------------------------------

### GuiceyBundle initialization example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/configuration.md

Shows the required structure of a GuiceyBundle implementation with the initialize method. The method receives GuiceyBootstrap and can be used to configure the bundle.

```java
public class MyBundle implements GuiceyBundle {
       
    @Override
    public void initialize(GuiceyBootstrap bootstrap) throws Exception {
        ...
    }      
}
```

--------------------------------

### VM options for faster startup

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/configuration-report.md

VM options that can improve application startup during development. The example shows the resulting startup time with these options, which is about 20% faster.

```text
    -XX:TieredStopAtLevel=1 -noverify
```

```text
    GUICEY started in 304.0 ms (88.18 ms config / 214.6 ms run / 1.130 ms jersey)
```

--------------------------------

### EnvironmentCommand with manual managed lifecycle

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/commands.md

Example of an EnvironmentCommand that manually starts and stops a Managed bean. EnvironmentCommand must have a constructor with an Application argument. This shows a workaround for managed initialization in commands: DbManager is a Managed bean that would run automatically in server mode, but commands never start managed objects, so we have to manually start and stop them.

```java
public class SyncCommand extends EnvironmentCommand<AppConfiguration> {

    @Inject
    private RemoteSynchronizer synchronizer;
    @Inject
    private DbManager manager;

    public SyncCommand(Application<AppConfiguration> application) {
        super(application, "sync", "Perform remote synchronization");
    }

    @Override
    protected void run(Environment environment,
                        Namespace namespace,
                        AppConfiguration configuration) throws Exception {
        manager.start();
        try {
            synchronizer.synchronize();
        } finally {
            manager.stop();
        }
    }
}
```

--------------------------------

### Example report with GuiceyConfigurationInfo

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/general/tracks.md

Sample console output showing statistics for GuiceyConfigurationInfo methods, with call counts and timing metrics. The note indicates methods are sorted by slowness.

```text
	[service]                                [method]                                           [calls]    [fails]    [min]      [max]      [median]   [75%]      [95%]
	GuiceyConfigurationInfo                  getNormalModuleIds()                               1          0          1.076 ms   1.076 ms   1.076 ms   1.076 ms   1.076 ms
	GuiceyConfigurationInfo                  getModulesDisabled()                               1          0          0.038 ms   0.038 ms   0.038 ms   0.038 ms   0.038 ms
	GuiceyConfigurationInfo                  getOverridingModuleIds()                           1          0          0.034 ms   0.034 ms   0.034 ms   0.034 ms   0.034 ms
	GuiceyConfigurationInfo                  getExtensionsDisabled()                            1          0          0.020 ms   0.020 ms   0.020 ms   0.020 ms   0.020 ms
	GuiceyConfigurationInfo                  getOptions()                                       1          0          0.005 ms   0.005 ms   0.005 ms   0.005 ms   0.005 ms
	GuiceyConfigurationInfo                  getData()                                          3          0          0.003 ms   0.006 ms   0.004 ms   0.006 ms   0.006 ms
```

--------------------------------

### Use lambda for setup

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Use a lambda expression to define the setup logic inline. The lambda receives the TestExtension and can apply configuration overrides. Returning a Closeable object is optional.

```java
.setup(ext -> {
        Db db = new Db();
        ext.configOverride("db.url", ()->db.getUrl())
        return db;
})
```

--------------------------------

### Implement ApplicationEventListener

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/installers/jersey-ext.md

Any class implementing org.glassfish.jersey.server.monitoring.ApplicationEventListener (or extending an abstract class implementing it) can be installed. The example shows the required onEvent and onRequest methods.

```java
public class MyApplicationEventListener implements ApplicationEventListener {

    @Override
    public void onEvent(ApplicationEvent event) {
    }

    @Override
    public RequestEventListener onRequest(RequestEvent requestEvent) {
        return null;
    }
}
```

--------------------------------

### Register report listener with custom configuration

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/diagnostic-tools.md

Shows how to register a report listener directly with custom configuration, using the available installers report as an example.

```java
public Builder<T> printAvailableInstallers() {
    return listen(ConfigurationDiagnostic.builder("Available installers report")
            .printConfiguration(new DiagnosticConfig()
                    .printInstallers()
                    .printNotUsedInstallers()
                    .printInstallerInterfaceMarkers())
            .printContextTree(new ContextTreeConfig()
                    .hideCommands()
                    .hideDuplicateRegistrations()
                    .hideEmptyBundles()
                    .hideExtensions()
                    .hideModules())
            .build());
}
```

--------------------------------

### GuiceyEnvironment.onGuiceyStartup(GuiceyStartupListener listener)

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/configuration.md

Shortcut for manual configuration under run phase with available injector.

```APIDOC
## GuiceyEnvironment.onGuiceyStartup(GuiceyStartupListener listener)

### Description
Shortcut for manual configuration under run phase with available injector.

### Method
onGuiceyStartup

### Signature
`void onGuiceyStartup(GuiceyStartupListener listener)`

### Parameters
- **listener** (GuiceyStartupListener) - Required - The startup listener to register.
```

--------------------------------

### Startup timings output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/configuration-report.md

Shows the overall Guicey startup time and the breakdown into configuration, run, and jersey phases. The time is measured as GuiceBundle methods plus part of jersey configuration time.

```text
    GUICEY started in 431.2 ms (150.2 ms config / 279.4 ms run / 1.594 ms jersey)
```

--------------------------------

### Default request logging with @StubRest

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/rest.md

By default, the REST client logs requests and responses. This example shows a test that sends a GET request and asserts the response.

```java
@TestGuiceyApp(App.class)
public class Test {

    @StubRest
    RestClient rest;

    @Test
    public void test() {
        String res = rest.get("/foo", String.class);
        Assertions.assertEquals("something", res);
    }
}
```

--------------------------------

### Console reporting log output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/extras/eventbus.md

Example log output showing registered event listeners after server start. Only subscriptions of beans registered at injector startup are shown.

```text
INFO  [2016-12-01 12:31:02,819] ru.vyarus.guicey.eventbus.report.EventsReporter: EventBus subscribers =

    MyEvent
        com.foo.something.SomeOtherService

```

--------------------------------

### Install servlet in both contexts with andMain

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/installers/servlet.md

Installs the servlet in both admin and main (application) contexts by using andMain = true.

```java
@AdminContext(andMain = true)
@WebServlet("/mapped")
public class MyServlet extends HttpServlet { ... }
```

--------------------------------

### Example GuiceyBundle implementation and registration

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/bundles.md

Shows a complete GuiceyBundle implementation with initialize and run methods, and how to register it with GuiceBundle.builder().bundles().

```java
public class MyFeatureBundle implements GuiceyBundle {

    @Override
    public void initialize(GuiceyBootstrap bootstrap) throws Exception {
        bootstrap
            .installers(MyFeatureExtensionInstaller.class)
            // dropwizard bundle usage
            .dropwizardBundle(new RequiredDwBundle())
            .modules(new MyFeatureModule());     
                                                                 
        // dropwizard bootstrap access
        bootstrap.bootstrap().addCommand(new MyFeatureCommand());
    }   

    @Override    
    public void run(GuiceyEnvironment environment) throws Exception {
        // configuration access
        environment
            .modules(new SpecialModle(environment.configuration().getSomeValue()))
            .onApplicationStartup(() -> logger.info("Application started!"));
    
        // dropwizard environment access        
        environment.environment().setValidator(new MyCustomValudatior());
    }
}

bootstrap.addBundle(GuiceBundle.builder()                        
        .bundles(new MyFeatureBundle())
        .build()
);
```

--------------------------------

### Manual unit of work with UnitManager

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/extras/jdbi3.md

Use this snippet when you need to manually manage a unit of work without a transaction. It starts a unit with beginUnit(), obtains the handle via get(), and ensures endUnit() is called in a finally block. Repositories can be called inside this manual unit because the unit of work is correctly started.

```java
@Inject UnitManager manager;

manager.beginUnit();
try {
    Handle handle = manager.get();
    // logic executed in unit of work but without transaction
} finally {
    manager.endUnit();
}
```

--------------------------------

### Manual GuiceBundle setup for OAuthDynamicFeature

Source: https://github.com/xvik/dropwizard-guicey/wiki/Authentication-integration

Manual Guice bundle configuration that installs the OAuthDynamicFeature and MySecuredResource as extensions. Requires the JerseyProviderInstaller and ResourceInstaller to be set. Use this when auto configuration is not enabled.

```java
bootstrap.addBundle(GuiceBundle.<TestConfiguration> builder()
                .installers(JerseyProviderInstaller.class, ResourceInstaller.class)
                .extensions(OAuthDynamicFeature.class, MySecuredResource.class)
                .build()
        );
```

--------------------------------

### ServiceLoader services file example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/bundles.md

Example content of the services file listing two GuiceyBundle implementations. Both bundles will be loaded automatically on startup.

```text
com.foo.Bundle1
com.foo.Bundle2
```

--------------------------------

### Use ClientSupport context shortcuts

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/spock.md

Shows shortcuts for querying rest, main, and admin contexts. These methods accept any number of strings that are automatically combined into the correct path.

```groovy
// GET {rest path}/some
client.targetRest("some").request().buildGet().invoke()

// GET {main context path}/servlet
client.targetApp("servlet").request().buildGet().invoke()

// GET {admin context path}/adminServlet
client.targetAdmin("adminServlet").request().buildGet().invoke()
```

--------------------------------

### Service loader file for TestEnvironmentSetup

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/setup-object.md

Contents of the META-INF/services/ru.vyarus.dropwizard.guice.test.jupiter.env.TestEnvironmentSetup file. Each line lists a setup object class to be loaded automatically via the service loader.

```text
ru.vyarus.dropwizard.guice.test.jupiter.ext.log.RecordedLogsSupport
ru.vyarus.dropwizard.guice.test.jupiter.ext.rest.RestStubSupport
ru.vyarus.dropwizard.guice.test.jupiter.ext.stub.StubsSupport
ru.vyarus.dropwizard.guice.test.jupiter.ext.mock.MocksSupport
```

--------------------------------

### Directly installed bundles not de-duplicated

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/deduplication.md

Shows that Guicey does not see directly installed bundles (intentionally). The example adds MyBundle directly and then adds a Guicey bundle that registers OtherBundle and sets uniqueItems(MyBundle.class). This will not work because Guicey sees only directly registered bundles: OtherBundle and transitive MyBundle, so MyBundle would be registered twice.

```java
bootstrap.addBundle(new MyBundle())
bootstrap.addBundle(GuiceBindle.builder()
                .dropwizardBundles(new OtherBundle())
                .uniqueItems(MyBundle.class)
                .build())
```

--------------------------------

### Configuration class hierarchy example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/guice/bindings.md

Shows the class hierarchy example for configuration binding. All classes between the root configuration class and io.dropwizard.Configuration are bound.

```java
MyConfiguration extends MyAbstractConfiguration extends Configuration
```

--------------------------------

### Default request logging output

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/general/rest.md

By default, the rest client logs requests and responses. This example shows the log output for a GET request to /foo, including the request and response details.

```text
[Client action]---------------------------------------------{
1 * Sending client request on thread main
1 > GET http://localhost:0/foo

}----------------------------------------------------------


[Client action]---------------------------------------------{
1 * Client response received on thread main
1 < 200
1 < Content-Length: 3
1 < Content-Type: application/json
something

}----------------------------------------------------------

```

--------------------------------

### Run application with server command

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/getting-started.md

Launches the application by running the main class with the 'server' command. No config.yml is passed because additional configuration is not needed yet.

```bash
SampleApplication server
```

--------------------------------

### Disable transitive module with .disableModules()

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/disables.md

Shows that disabling a module also affects transitive modules installed by it. The example disables TransitiveModule, which removes all its bindings. Note the typos in the source (GuiceBindle, TrannsitiveModule.clas).

```java
public class MyModule extends AbstractModule {
    @Override
    public void configure() {
        install(new TransitiveModule());
    }
}

GuiceBindle.builder()
    .disableModules(TrannsitiveModule.clas)
    ...
```

--------------------------------

### Example URLs for main context SPA

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/extras/spa.md

Example URLs showing how the SPA bundle handles requests: root returns the index, resource paths serve files, and client routes return the index page.

```text
http://localhost:8080/ -> app index
http://localhost:8080/css/app.css -> application resource, located at /app/css/app.css in the classpath
http://localhost:8080/someroute -> application client route - index page returned
```

--------------------------------

### Enable debug timing with @TestGuiceyApp

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/debug.md

Use @TestGuiceyApp with debug = true to enable timing reports. The example shows a test class with two test methods sharing the same application instance started in beforeAll.

```java
@TestGuiceyApp(value = App.class, debug = true)
public class PerformanceLogTest {
    @Test
    public void test1() { ... }
    @Test
    public void test2() { ... }
}
```

--------------------------------

### Deferred configuration with configOverride

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/config.md

Use deferred configuration to supply values from another extension or resolve values after test start. The example shows a FooExtension providing a value via configOverride and a custom ConfigOverrideValue.

```java
@RegisterExtension
@Order(1)
static FooExtension ext = new FooExtension();

@RegisterExtension
@Order(2)
static TestGuiceyAppExtension app = TestGuiceyAppExtension.forApp(AutoScanApplication.class)
        .config("src/test/resources/ru/vyarus/dropwizard/guice/config.yml")
        .configOverrides("foo: 1")
        .configOverride("bar", () -> ext.getValue())
        .configOverrides(new ConfigOverrideValue("baa", () -> "44"))
        .create();
```

--------------------------------

### Enable debug via setup object calling ext.debug()

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/test/junit5/debug.md

Activates the debug log from inside a setup object by calling ext.debug() on the provided extension instance.

```java
@EnableSetup
static TestEnvironmentSetup db = ext -> {
            ext.debug();
        };
```

--------------------------------

### Inner static classes auto-scan example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/scan.md

Shows that Guicey's auto-scan detects inner static classes that extend a base mapper and are annotated with @Provider. The nested classes FooExceptionMapper and BarExceptionMapper are found and installed automatically.

```java
public abstract class AbstractExceptionMapper<T extends Exception> implements ExceptionMapper<T> {

    @Provider
    public static class FooExceptionMapper extends AbstractExceptionMapper<IOException> { ... }

    @Provider
    public static class BarExceptionMapper extends AbstractExceptionMapper<ServletException> { ... }
}
```

--------------------------------

### Web report output showing stopped and disabled items

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/web-report.md

Example of the web report output under a lightweight guicey test when Jetty is not started, showing stopped and disabled items. MainServlet is disabled (and stopped), BothServlet is just stopped.

```text
    MAIN /
    ├── filter     /custom/*                    CustomMappingFilter          (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED       [ERROR]         .custommapping
    ├── filter     /async/*             async   AsyncFilter                  (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED       [REQUEST]       .async
    ├── filter     /both/*                      BothFilter                   (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED       [REQUEST]       .both
    ├── filter     /1/*                         MainFilter                   (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED       [REQUEST]       .main
    ├── filter     /2/*                         --"--
    │
    ├── filter     /*                   async   GuiceFilter                  (c.g.inject.servlet)                      STOPPED       [REQUEST]       Guice Filter
    │   ├── guicefilter     /1/*                         GFilter                        r.v.d.g.d.r.w.support.GuiceWebModule
    │   ├── guicefilter     /1/abc?/.*           regex   GRegexFilter                   r.v.d.g.d.r.w.support.GuiceWebModule
    │   ├── guicefilter     /1/foo                       instance of GFilterInstance    r.v.d.g.d.r.w.support.GuiceWebModule
    │   ├── guiceservlet    /2/*                         GServlet                       r.v.d.g.d.r.w.support.GuiceWebModule
    │   ├── guiceservlet    /2/abc?/             regex   GRegexServlet                  r.v.d.g.d.r.w.support.GuiceWebModule
    │   └── guiceservlet    /2/foo                       instance of GServletInstance   r.v.d.g.d.r.w.support.GuiceWebModule
    │
    ├── servlet    /foo                         MainServlet                  (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED                       target
    │   └── filter                                  TargetServletFilter          (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED       [REQUEST]       .targetservlet
    │
    ├── servlet    /bar                         --"--
    ├── servlet    /both                        BothServlet                  (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED                       .both
    └── servlet    /async               async   AsyncServlet                 (r.v.d.g.d.r.w.s.UserServletsBundle)      STOPPED                       .async
```

--------------------------------

### Query enabled installers with Filters.enabled()

Source: https://github.com/xvik/dropwizard-guicey/blob/master/dropwizard-guicey/src/doc/docs/guide/diagnostic/configuration-model.md

Shows how to query enabled installers from GuiceyConfigurationInfo using the Filters.enabled() predicate and ItemId.typesOnly() to ignore duplicates.

```java
 public List<Class<FeatureInstaller>> getInstallers() {
    return typesOnly(getData().getItems(ConfigItem.Installer, Filters.enabled()));
}
```

--------------------------------

### Static resource call example

Source: https://github.com/xvik/dropwizard-guicey/blob/master/examples/ext-gsp/README.md

Example of a static resource call: requesting '/style.css' maps to the classpath resource at 'src/main/resources/com/example/app/style.css'.

```text
http://localhost:8080/style.css → src/main/resources/com/example/app/style.css
```
Tokens:
Raw