Vert.x Gradle Starter

This project is a template to start your own Vert.x project using Gradle.

Prerequisites

  • JDK 8+

Getting started

Create your project with:

git clone https://github.com/vert-x3/vertx-gradle-starter.git PROJECT_NAME

Replace PROJECT_NAME with the name of your project.

On Linux and MacOSx (or Windows with bash), if you want to go faster and generate an already configured project run:

curl http://vertx.io/assets/starter-scripts/create-vertx-project-gradle.sh -o vertx-create-gradle-project.sh; bash vertx-create-gradle-project.sh

Running the project

Once you have retrieved the project, you can check that everything works with:

./gradlew test run

The command compiles the project and runs the tests, then it launches the application, so you can check by yourself. Open your browser to http://localhost:8080. You should see a Hello World message.

Anatomy of the project

The project contains:

  • the Gradle project using the Kotlin DSL (see build.gradle.kts) with auto-reloading and fat-jar building

  • a main verticle file (src/main/java/io/vertx/starter/MainVerticle.java)

  • a unit test (src/main/test/io/vertx/starter/MainVerticleTest.java)

Start to hack

  1. Delete the .git directory

  2. Open the build.gradle.kts file and customize vertxVersion. You can also change the mainVerticleName variable to use your own package name and verticle class.

  3. Run ./gradlew run.

This last command relaunches Gradle and the application as soon as you change something under src/main.

Building the project

To build the project, just use:

./gradlew build

It generates a fat-jar in the build/libs directory.