vert-x3 / Vertx Maven Starter
Programming Languages
Projects that are alternatives of or similar to Vertx Maven Starter
= Vert.x Maven Starter
This project is a template to start your own Vert.x project using Apache Maven.
== Prerequisites
- Apache Maven
- JDK 8+
== Getting started
Create your project with:
[source]
https://github.com/vert-x3/vertx-maven-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-maven.sh -o vertx-create-maven-project.sh; bash vertx-create-maven-project.sh
curl== Running the project
Once you have retrieved the project, you can check that everything works with:
[source]
mvn test exec:java
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:
- a
pom.xml
file - a main verticle file (src/main/java/io/vertx/starter/MainVerticle.java)
- an unit test (src/main/test/io/vertx/starter/MainVerticleTest.java)
== Start to hack
- Delete the
.git
directory - Open the
pom.xml
file and customize thegroupId
,artifactId
andversion
. You can also change themain.verticle
property to use your own package name and verticle class. - Run
redeploy.sh
(orredeploy.bat
on Windows) and the project recompiles while editing.
NOTE: the redeploy
script are also configurable
== Building the project
To build the project, just use:
mvn clean package
It generates a fat-jar in the target
directory.