ru.vyarus.guicey:guicey-spa

Singe page applications support


Keywords
dropwizard, eventbus, guice, java, jdbi
License
MIT

Documentation

Dropwizard-guicey extensions

License Build Status Appveyor build status codecov

About

Dropwizard-guicey 5.x extensions and integrations. Provided modules may be used directly and for educational purposes (as examples for custom integrations).

NOTE: Extension modules version is derived from guicey version: guiceyVersion-Number (the same convention as for dropwizard modules). For example version 5.0.0-1 means first extensions release (1) for guicey 5.0.0.

Also, guicey base package ru.vyarus.dropwizard.guice is different from extensions base package ru.vyarus.guicey.

Older versions:

Setup

JCenter Maven Central

You can either use modules directly (in this case see module page for setup) or use provided BOM to unify versions management.

Note that BOM will also provide guice and dropwizard BOMs, so you can avoid declaring versions of these modules too.

BOM usage is recommended as it allows correct dropwizard dependencies update.

Snapshots

Snapshots may be used through JitPack

WARNING: snapshot may not contain today's commits due to ~1day publication lag!

WARNING2: master-SHAPSHOT versions are not working due to incorrect pom generation (yet unkown reason), use exact commits instead

Add JitPack repository:

repositories { maven { url 'https://jitpack.io' } }

For spring dependencies plugin:

dependencyManagement {
    resolutionStrategy {
        cacheChangingModulesFor 0, 'seconds'
    }
    imports {
        mavenBom "ru.vyarus.guicey:guicey-bom:COMMIT-HASH"
    }
}   

dependencies {
    implementation 'ru.vyarus.guicey:guicey-validation'
}

If you don't use BOM:

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

dependencies {
    implementation 'ru.vyarus.guicey:guicey-validation:COMMIT-HASH'
}

Note that in both cases resolutionStrategy setting required for correct updating snapshot with recent commits (without it you will not always have up-to-date snapshot)

OR you can depend on exact commit:

  • Go to JitPack project page
  • Select Commits section and click Get it on commit you want to use and use commit hash as version: ru.vyarus.guicey:guicey-bom:8585300d12

Maven:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>  

<dependencyManagement> 
    <dependencies>
        <dependency>
            <groupId>ru.vyarus.guicey</groupId>
            <artifactId>guicey-bom</artifactId>
            <version>COMMIT-HASH</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>  
 
<dependencies>
    <dependency>
        <groupId>ru.vyarus.guicey</groupId>
        <artifactId>guicey-validation</artifactId>
    </dependency>
</dependencies>

Or simply change dependency version if BOM not used (repository definition is still required).

Modules

Admin REST

Admin context rest support (mirror main rest).

Lifecycle annotations

Support for @PostConstruct, @PreDestroy, @PostStartup annotations on guice beans.

Validation

Allows using validation annotations on any guice bean method (the same way as dropwizard rest validation)

Guava EventBus integration

Module provides integration with Guava EventBus: automates subscriptions, report events with subscriptions and registers EventBus for inject.

JDBI integration

Based on dropwizard integration. Introduce thread bound transactions, defined with annotations. Sql proxies could be used as usual guice beans without extra efforts to use them in the same transaction.

JDBI3 integration

Jdbi3 integration, based on dropwizard module. Introduce thread bound transactions, defined with annotations. Sql proxies could be used as usual guice beans without extra efforts to use them in the same transaction.

Single page applications

Correct redirect to index page for html5 client routing urls (e.g. html5 routing enabled by default in Angular 2).

Guicey Server Pages

JSP like simplicity for dropwizard-views.


java lib generator