Skip to content

Java EE version of Bookstore Vaadin 24 multimodule project with EAR packaging

Notifications You must be signed in to change notification settings

TatuLund/bookstore-flow-ee

Repository files navigation

Bookstore App Starter for Vaadin Flow / Java EE

A project example for a Vaadin application that requires a Servlet 6 container to run. The UI is built mostly with Java only.

Vaadin 24 supports Servlet 6 and Jakarta EE 10. This demo app demonstrates many use cases with Java EE and CDI such as

  • How to use dependency injection and inversion of control
  • How to apply model view presenter architecture in Vaadin app using CDI
  • How to use Vaadin scopes when beans.xml has bean-discovery-mode="annotated"
  • How to use EAR packaging for production
  • How to use WAR packaging for development

Other useful Vaadin tips demoed

These tips are not specific to CDI or JavaEE

  • How to build custom app layout when not using AppLayout component
  • How to build CRUD view without using Crud component
  • How to use Dialog as Offcanvas style modal view
  • How to highlight changed fields in the Form
  • How to use CustomI18NProvider with multiple supported languages
  • How to persist chosen language in a cookie
  • How to use localized error messages with JSR-303 and BeanValidationBinder
  • How to use bean level validator
  • How to implement caching data provider when backend is slow
  • How to use warning colors with Button and ConfirmDialog
  • How to create responsive design

Prerequisites

The project can be imported into the IDE of your choice, with Java 17 installed, as a Maven project.

Project Structure

The project consists of the following three modules:

  • parent project: common metadata and configuration
  • bookstore-starter-flow-ui: main application module that includes views (war)
  • bookstore-starter-flow-my-component: sub module for custom components (jar)
  • bookstore-starter-flow-backend: POJO classes and mock services being used in the ui (jar)
  • bookstore-starter-flow-it: TestBench test examples (ToDo: update to work)
  • bookstore-starter-flow-ear: EAR packaging

Workflow

Development version as WAR

To compile the entire project, run "mvn install" in the parent project.

Production version as EAR

To compile the entire project, run "mvn install" in the parent project.

Other basic workflow steps:

  • getting started
  • compiling the whole project
    • run mvn clean install -Production in parent project
  • running in production mode
  • creating a production mode war
    • run mvn package -Pproduction ear module
  • running in production mode
    • production mode is used by default

Branching information:

  • v24 the latest version of the starter, using the latest platform version