vert-x3 / Vertx Gradle Starter
Programming Languages
Projects that are alternatives of or similar to Vertx Gradle Starter
= 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:
[source]
https://github.com/vert-x3/vertx-gradle-starter.git PROJECT_NAME
git cloneReplace 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:
[source]
http://vertx.io/assets/starter-scripts/create-vertx-project-gradle.sh -o vertx-create-gradle-project.sh; bash vertx-create-gradle-project.sh
curl== Running the project
Once you have retrieved the project, you can check that everything works with:
[source]
./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
- Delete the
.git
directory - Open the
build.gradle.kts
file and customizevertxVersion
. You can also change themainVerticleName
variable to use your own package name and verticle class. - 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.