Choose the version of Vert.x you want to use, choose Java as the language, Maven as the build tool, and
type the group id and artifact id you want. Then, add Vert.x Web as a dependency by typing it in the “Dependencies” text box. When you’re done, hit the Generate Project button.
Save the zip on your computer and unzip it in a folder of your choice.
The generated project contains:
The Maven build descriptor pom.xml configured to build and run your application
A sample Verticle and a sample test using JUnit 5
An editor configuration to enforce code style
A Git configuration to ignore files
If you want to try it now, you can download this sample project using
Maven or using Gradle.
2Code
Open the project in the editor of your choice and navigate to src/main/java/com/example/starter/MainVerticle.java.
This source file contains a sample Verticle (the Vert.x deployment unit) that starts an HTTP server.
You’re going to modify it to greet whoever performs requests to your server.
Change the code as follows:
Java
Kotlin
This code creates a Vert.x Web Router (the object used to route HTTP requests to specific request handlers)
and starts an HTTP Server on port 8888. On each request, it returns a JSON object containing the address of the request, the query parameter name, and a greeting message.
3Run
To run the code, open a terminal and navigate to your project folder.
Build the application as follows:
Then, run the application:
Now that the server is up and running, try to send a request:
HTTPie
curl
4Go further
Now that you have had a taste of how easy and fun it is to get started with Vert.x, here are a few pointers to help guide you further along your journey: