#Vert.x for Starters

This is a series of sample projects that build event-driven web applications using Vert.x.

• Hello World: a simple HTTP server
• To-do REST API: a to-do REST service backed up MongoDB
• To-do Web Application: a to-do list management rich-client application, backed by the previous to-do REST service

The tutorial also shows how to develop Vert.x applications by multi-modules.

Java 8

All samples are written in Java 8 to take advantage of the lambda feature. A more in-depth discussion regarding Vert.x and lambda programming is made in the "Hello World" module.

To run the examples, make sure to install JDK 8, which is still a preview version for now. Most popular IDE's already have early support for Java 8 and Lambda. I have personally tried Eclipse and NetBeans. Bboth are decent, and NetBeans is more stable for now.

Maven Integration

The series is developed as a multi-module maven project based on vertx maven integration.

The project is structured as three modules:

   <modules>
        <module>helloworld</module>
        <module>todoapi</module>
        <module>todowebapp</module>
   </modules>  

Shared elements of sub-module pom's are extracted into the parent pom as much as possible in order to avoid duplication and inconsistency, including

• properties for dependencies and versions,
• common dependencies,
• plugins for compiling, resource and packaging.

The following are useful common maven commands:

• mvn clean To clean up
• mvn verify To execute integration tests
• mvn install To compile, test, package and install