This project contains the source code generated by Vaadin's Starter Pack (Vaadin Bakery App Starter for Flow and Spring)
- master - Vaadin 14 (updated on October 9th, 2020)
- V13 - Vaadin 13
- V10 - Vaadin 10
- V8 - Vaadin 8
- Petstore with a Spring-based Backend and Vaadin 8 UI
- Beverage Buddy App Starter for Vaadin Flow
- Bookstore App Starter for Vaadin Flow
- Business App Starter
mvn spring-boot:run
Wait for the application to start
Open http://localhost:8080/ to view the application.
Default credentials are [email protected]/admin for admin access and [email protected]/barista for normal user access.
Note that when running in development mode, the application will not work in IE11.
Integration tests are implemented using TestBench. The tests take tens of minutes to run and are therefore included in a separate profile. We recommend running tests with a production build to minimize the chance of development time toolchains affecting test stability. To run the tests, execute:
mvn verify -Pit,production
and make sure you have a valid TestBench license installed.
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
Run linter to check frontend code by adding -DrunLint
to build/run command.
To activate spring-boot-devtools is needed to:
- Add spring-boot-devtools dependency
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
<scope>runtime</scope>
</dependency>
- Fork the process used to run the application by changing spring-boot-maven-plugin configuration
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<configuration>
<fork>true</fork>
</configuration>
</plugin>
- Optionally you might want to avoid the data generator to be run on each single reload, therefore, make H2 database store entities in file-system instead of in memory by adding the following lines to the
src/main/resources/application.properties
spring.datasource.url=jdbc:h2:file:~/bakery-test-data
spring.jpa.hibernate.ddl-auto=update
To trigger the restart it is needed to update classpath.
In Eclipse it can be done automatically after save modified file.
In IntelliJ IDEA can be done manually Build -> Build Project
Live reload is supported and browser extensions can be found at http://livereload.com/extensions/.
mvn spring-boot:run -Pproduction
The default mode when the application is built or started is 'development'. The 'production' mode is turned on by enabling the production
profile when building or starting the app.
In the 'production' mode all frontend resources of the application are passed through the polymer build
command, which minifies them and outputs two versions: for ES5- and ES6-supporting browsers. That adds extra time to the build process, but reduces the total download size for clients and allows running the app in browsers that do not support ES6 (e.g. in Internet Explorer 11).
Note that if you switch between running in production mode and development mode, you need to do
mvn clean
before running in the other mode.
As both IDEs support running Spring Boot applications you just have to import the project and select com.kiroule.vaadin.bakeryapp.Application
as main class if not done automatically. Using an IDE will also allow you to speed up development even more. Just check https://vaadin.com/blog/developing-without-server-restarts.
Unfortunately, up to IntelliJ 2017 dependencies scoped as provided
in the Maven POM will not be loaded on startup. As a workaround you will have to remove the scope definition of spring-boot-starter-tomcat
and javax.servlet-api
from the pom.xml.
The Bakery App Starter includes scalability tests. Once you have deployed a production build of Bakery you can run them to check how the app behaves under load. The scalability tests can be run completely on your local machine, but you might as well want to run locally only the test agents while the Bakery app under test is deployed to an environment that is close to your production.
In order to run the scalability tests locally:
-
Make sure you are using Java 8 (Gatling Maven plugin does not yet work with Java 9+)
-
Build and start Bakery in the production mode (e.g.
mvn clean spring-boot:run -DskipTests -Pproduction
) -
Open terminal in the project root
-
Start a test from the command line:
mvn -Pscalability gatling:test
-
Test results are stored into target folder (e.g. to
target/gatling/BaristaFlow-1487784042461/index.html
) -
By default, the scalability test starts 100 user sessions at a 100 ms interval for one repeat, all of which connect to a locally running Bakery app. These defaults can be overridden with the
gatling.sessionCount
,gatling.sessionStartInterval
gatling.sessionRepeats
, andgatling.baseUrl
system properties. See an example execution for 300 users started within 50 s:mvn -Pscalability gatling:test -Dgatling.sessionCount=300 -Dgatling.sessionStartInterval=50
Note: If you run Bakery with an in-memory database (like H2, which is the default), it will logically use more memory than when using an external database (like PostgreSQL). It is recommend to run scalability tests for Bakery only after you have configured it to use an external database.
A paid Pro or Prime subscription is required for creating a new software project from this starter. After its creation, results can be used, developed and distributed freely, but licenses for the used commercial components are required during development. The starter or its parts cannot be redistributed as a code example or template.
For full terms, see LICENSE
Pro components used in the starter are :
Also, the tests are created using Testbench library.