No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.mvn/wrapper Add a maven wrapper Mar 16, 2018
src Fix default HTTP response Aug 29, 2016
.editorconfig see vert-x3/issues#122 Oct 13, 2016
.gitignore Initial commit Aug 29, 2016
README.adoc update link to the one-liner script Oct 11, 2016
mvnw Add a maven wrapper Mar 16, 2018
mvnw.cmd Add a maven wrapper Mar 16, 2018
pom.xml update vert.x version to 3.6.0 Nov 29, 2018
redeploy.bat Update web script link Aug 30, 2016
redeploy.sh add missing quotes around the on-redeploy command Oct 16, 2016

README.adoc

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:

git clone https://github.com/vert-x3/vertx-maven-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-maven.sh -o vertx-create-maven-project.sh; bash vertx-create-maven-project.sh

Running the project

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

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

  1. Delete the .git directory

  2. Open the pom.xml file and customize the groupId, artifactId and version. You can also change the main.verticle property to use your own package name and verticle class.

  3. Run redeploy.sh (or redeploy.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.