Bookstore App Starter for Vaadin

A project example for a Vaadin application that only requires a Servlet 3.1 container to run (no other JEE dependencies). The UI is built with Java only.

The easiest way of using it is via https://vaadin.com/start - you can choose the package naming you want.

Prerequisites

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

Project Structure

The project is following the standard Maven project layout.

Workflow

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

Other basic workflow steps:

getting started
compiling the whole project
- run mvn install in project root
developing the application
- edit code in src/main
- run mvn
- open http://localhost:8080/
creating a production mode war
- run mvn package -Pproduction
running in production mode
- run mvn jetty:run -Pproduction
- open http://localhost:8080/

Running Integration Tests

Integration tests are implemented using TestBench. The tests take a few minutes to run and are therefore included in a separate Maven profile. To run the tests using Google Chrome, execute

mvn verify -Pit

and make sure you have a valid TestBench license installed. If the tests fail because of an old Chrome Driver or you want to use a different browser, you'll need to update the webdrivers.xml file in the project root.

Profile it adds the following parameters to run integration tests:

-Dwebdriver.chrome.driver=path_to_driver
-Dcom.vaadin.testbench.Parameters.runLocally=chrome

If you would like to run a separate test make sure you have added these parameters to VM Options of JUnit run configuration

Branching information:

master the latest version of the starter, using the latest platform version