This is the Vertx extension for WildFly Application Server.
Eclipse Vert.x is a toolkit to build reactive applications on the JVM, integrating it adds more reactive power to WildFly.
It allows you to define Vertx instances using WildFly management model, and they can be accessed using JNDI lookup or CDI injection in your enterprise or web applications.
You can access Vertx core APIs and some component APIs in your applications.
You can package the verticle classes with the application, the extension will deploy the verticles to the associated Vertx instances managed by the WildFly server if there is a META-INF/vertx.json
or WEB-INF/vertx.json
file in the application archive.
In case of clustering vertx instance, this extension uses vertx-infinispan as the cluster manager to be able to talk with remote Vertx instances. You can specify the necessary JGroups settings for Vertx using standard WildFly configuration.
Please see https://github.com/gaol/wildfly-vertx-extension/wiki/Roadmap for the Roadmap
It requires:
- Java 11+
- Maven 3.2.5+
to build the extension.
Run the following command to build:
mvn clean install
After that, there will be 2 servers and 1 Galleon feature pack produced in the separated subdirectories:
build/target/wildfly-vertx-build-${version}/
dist/target/wildfly-vertx-dist-${version}/
galleon-feature-pack/wildfly-feature-pack/target/wildfly-vertx-feature-pack-${version}.zip
The generated servers can be started the same way as how WildFly server is started:
$SERVER_HOME/bin/standalone.sh
The produced Galleon feature pack can be installed to an existing WildFly server using Galleon CLI.
NOTE: To have
galleon.sh
work, please check the Galleon Provisioning Guide on how to download and install the Gallon CLI tool.
For more information about this extension, please visit the documentation: https://gaol.github.io/wildfly-vertx-extension/