Showcase of Vaadin features

This application will demonstrate example of proper architecture of Vaadin application based on the following patterns and best practices:

• separation of concerns (server and client side of the application should be explicitly decoupled)
• DRY
• standard Java EE features like JSR-330 (Dependency Injection) and many others.

Prerequisites

• Intellij IDEA or Eclipse EE
• Oracle JDK 1.8.X
• Maven 3.6.3

How to contribute

Please go through Contribution Guide

Setting up IDE

For Intellij IDEA:

• navigate to the Preferences | Build, Execution, Deployment | Compiler | Annotation Processors and turn on Enable Annotation Processing
• navigate to the Preferences | Plugins, open the Marketplace tab, install Lombok Plugin by Michail Plushnikov

How to build

mvn install

How to launch locally

Type mvn package tomee:run from project root or webapp module and then navigate to http://localhost:8080.

Unit testing

We need to keep coverage of all logic by Unit tests between above 80%. We don't need to add Unit tests for Vaadin UI classes, such as Views and others.

Integration testing

By example of PostgreSqlDbTest.class, you can see how we can use testcontainers and docker for integration testing.

Continuous Integration

https://travis-ci.com/rednavis/vaadin-showcase

Quality assurance

Codacy DeepCode

Commands

mvn clean install -Pintegration-tests - run integration-tests

mvn package -Pproduction - run in production mode

mvn checkstyle:checkstyle - run checkstyle