Dropwizard guice integration

DOCUMENTATION: http://xvik.github.io/dropwizard-guicey/

• Examples
• Standalone sample app
• Extensions and integrations

Support: discussions | gitter chat

About

Dropwizard 5.0.1 guice 7.0.0 integration.

Features:

• Auto configuration from classpath scan and guice bindings.
• Yaml config values bindings by path or unique sub objects.
• Advanced Web support
• Dropwizard style console reporting: detected (and installed) extensions are printed to console to remove uncertainty
• Test support: custom junit and spock extensions
• Advanced test abilities to disable or override application logic
• Developer friendly:
  • core integrations may be replaced (to better fit needs)
  • rich api for developing custom integrations, and hooking into lifecycle)
  • out of the box support for plug-n-play plugins (auto discoverable)
  • diagnostic tools (reports), support for custom diagnostic tools

Sponsors

^{If guicey makes your life easier, you can support its development.}

Supported versions

All active (not EOL) dropwizard versions supported.

Setup

Maven:

<dependency>
  <groupId>ru.vyarus</groupId>
  <artifactId>dropwizard-guicey</artifactId>
  <version>8.0.2</version>
</dependency>

Gradle:

implementation 'ru.vyarus:dropwizard-guicey:8.0.2'

BOM

Use BOM for guice, dropwizard and guicey modules dependency management. BOM usage is highly recommended as it allows you to correctly update dropwizard dependencies.

Gradle:

dependencies {
    implementation platform('ru.vyarus.guicey:guicey-bom:8.0.2')
    // uncomment to override dropwizard and its dependencies versions    
    //implementation platform('io.dropwizard:dropwizard-dependencies:5.0.1')

    // no need to specify versions
    implementation 'ru.vyarus:dropwizard-guicey'
    implementation 'ru.vyarus.guicey:guicey-eventbus'
   
    implementation 'io.dropwizard:dropwizard-auth'
    implementation 'com.google.inject:guice-assistedinject'   
    
    testImplementation 'io.dropwizard:dropwizard-testing'
}

Maven:

<dependencyManagement>  
    <dependencies>
        <dependency>
            <groupId>ru.vyarus.guicey</groupId>
            <artifactId>guicey-bom</artifactId>
            <version>8.0.2</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency> 
        <!-- uncomment to override dropwizard and its dependencies versions  
        <dependency>
            <groupId>io.dropwizard/groupId>
            <artifactId>dropwizard-dependencies</artifactId>
            <version>5.0.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency> -->                 
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>ru.vyarus</groupId>
        <artifactId>dropwizard-guicey</artifactId>
    </dependency>
</dependencies>

BOM includes:

Sample project

You can also use sample gradle project for a new project bootstrap

Snapshots

repositories {
        mavenLocal()
        mavenCentral()
        maven {
            name = 'Central Portal Snapshots'
            url = 'https://central.sonatype.com/repository/maven-snapshots/'
            mavenContent {
                snapshotsOnly()
                includeGroupAndSubgroups('ru.vyarus')
            }
        }
    }

dependencies {
    implementation 'ru.vyarus:dropwizard-guicey:8.0.2-SNAPSHOT'
}

configurations.all {
    resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}

<repositories>
    <repository>
        <name>Central Portal Snapshots</name>
        <id>central-portal-snapshots</id>
        <url>https://central.sonatype.com/repository/maven-snapshots/</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

<dependency>
    <groupId>ru.vyarus</groupId>
    <artifactId>dropwizard-guicey</artifactId>
    <version>8.0.2-SNAPSHOT</version>
</dependency>

Usage

Read documentation

Might also like

• yaml-updater - yaml configuration update tool, preserving comments and whitespaces (has dropwizard module)
• generics-resolver - runtime generics resolution
• guice-validator - hibernate validator integration for guice (objects validation, method arguments and return type runtime validation)
• guice-ext-annotations - @Log, @PostConstruct, @PreDestroy and utilities for adding new annotations support
• guice-persist-orient - guice integration for orientdb
• dropwizard-orient-server - embedded orientdb server for dropwizard