JarCastingVertx Vaadin
Status
Description
Vertx Vaadin is an adapter library that lets you run Vaadin applications on top of Vert.x. This means you can mix the simplicity and robustness of Vaadin applications with the powerful tools provided by Vert.x, such as event bus, clustering, High Availability and Fail-Over.
Installation and Getting Started
Vertx-vaadin binaries are available on Maven Central and Bintray.
Maven
<dependency>
<groupId>com.github.mcollovati.vertx</groupId>
<artifactId>vertx-vaadin8</artifactId>
<version>${vertx-vaadin8.version}</version>
</dependency>
<dependency>
<groupId>com.github.mcollovati.vertx</groupId>
<artifactId>vertx-vaadin-flow</artifactId>
<version>${vertx-vaadin-flow.version}</version>
</dependency>
For snapshots:
<repository>
<id>vertx-vaadin-snapshots</id>
<url>https://mcollovati.jfrog.io/artifactory/vertx-vaadin-snapshots</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
For additional vertx-vaadin artifacts not published on Maven Central (eg Vaadin client repackages):
<repository>
<id>vertx-vaadin-public</id>
<url>https://mcollovati.jfrog.io/artifactory/vertx-vaadin-public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
Gradle
compile 'com.github.mcollovati.vertx:vertx-vaadin8:0.4.0'
For snapshots:
repositories {
maven { url 'https://mcollovati.jfrog.io/artifactory/vertx-vaadin-snapshots' }
}
Compatibility matrix
| Vaadin version | Vert.x version | vertx-vaadin version | Status |
|---|---|---|---|
| 8.x -> 8.7 | 3.5 | vertx-vaadin8:1.0.1 |  |
| 8.8 | 3.7 | vertx-vaadin8:2.0.0 |  |
| 10 | 3.5 | vertx-vaadin-flow:10.0.0 |  |
| 12 | 3.5 | vertx-vaadin-flow:12.0.0 | |
| 13 | 3.5 | vertx-vaadin-flow:13.0.1 | |
| 14.0 | 3.7 | vertx-vaadin-flow:14.0.0 | |
| 14.0 | 3.8.3 | vertx-vaadin-flow:14.0.10+ | |
| 14.1 | 3.8.3 | vertx-vaadin-flow:14.1.x | |
| 14.2 | 3.8.3 | vertx-vaadin-flow:14.2.x |  |
| 15 | 3.8.5 | vertx-vaadin-flow:15.0.x | |
| 16 | 3.8.5 | vertx-vaadin-flow:16.0.x | |
| 17 | 3.8.5 | vertx-vaadin-flow:17.0.x | |
| 18 | 3.8.5 | vertx-vaadin-flow:18.0.x |  |
| 19 | 3.9.1 | vertx-vaadin-flow:19.0.x |  |
| 20 | 3.9.1 | vertx-vaadin-flow:20.0.x |  |
Documentation
See vertx-vaadin-8 or vertx-vaadin-flow module for more information.
Demo and samples
A public demo based on Vaadin 8 archetype application example is published on heroku and is available here
Bookstore demo on Vaadin Flow is published on heroku and is available at the following urls:
Source code and other samples can be found on vaadin-vertx-samples repository.
Issue tracking
The issues for this project are tracked on its github.com page. All bug reports and feature requests are appreciated.
Contributions
Contributions are welcome, but there are no guarantees that they are accepted as such. Process for contributing is the following:
- Fork this project
- Create an issue to this project about the contribution (bug or feature) if there is no such issue about it already. Try to keep the scope minimal.
- Develop and test the fix or functionality carefully. Only include minimum amount of code needed to fix the issue.
- Refer to the fixed issue in commit
- Send a pull request for the original project
- Comment on the original issue that you have implemented a fix for it
License
Vertx Vaadin is distributed under MIT License. For license terms, see LICENSE.
Acknowledgements
Thanks to:
- David Sowerby (author of Krail framework) for all his precious technical and non technical support.
- Vaadin, and especially Pekka Hyvönen, for allowing me to use Flow UI test code and for the Testbench license.
- Dudeplayz for his valuable feedback.