Awesome

Vertx Vaadin

Status

License Maven Central

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
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+
14.6+	4.0.3	vertx-vaadin-flow:14.4.x
14.7+	4.2.1	vertx-vaadin-flow:14.5.x
14.8+	4.3.0	vertx-vaadin-flow:14.6.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.8.5	vertx-vaadin-flow:19.0.x
20	4.0.3	vertx-vaadin-flow:20.0.x
21	4.0.3	vertx-vaadin-flow:21.0.x
23.1.1+	4.2.3	vertx-vaadin-flow:23.1.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.