vertx-tutor-app

My version of applications from Introduction to Vert.x The examples demonstrate how to use Vert.x including Vert.x-core, Vert.x-web, Vert.x-unit with HSQLDB and MongoDB. Vert.x is a toolkit for building reactive applications on the JVM: modern, scalable network apps.

Requirements:

• Java SE Development Kit 8
• Maven 3.X (or you could use Maven wrapper)
• Git 1.7.x (or newer)

Examples:

• Simple Vert.x instance
  change the value of environment variable main_verticle in run.sh to ...

  export main_verticle="ru.shishmakov.SimpleVerticle"

• Vert.x instance with HSQLDB 2.x (embedded HSQLDB)
  change the value of environment variable main_verticle in run.sh to ...

  export main_verticle="ru.shishmakov.WebSqlVerticle"

• Vert.x instance with MongoDB 3.x (need external mongod process)
  change the value of environment variable main_verticle in run.sh to ...

  export main_verticle="ru.shishmakov.WebMongoVerticle"

REST API

• get all items
  • curl -X GET localhost:8080/api/whiskies
• get one item by id
  • curl -X GET localhost:8080/api/whiskies/1
• delete item by id
  • curl -X DELETE localhost:8080/api/whiskies/2
• change item by id
  • curl -H "Content-Type: application/json" -X PUT -d '{"name":"Jameson","origin":"Ireland"}' localhost:8080/api/whiskies/1
• add new item
  • curl -H "Content-Type: application/json" -X POST -d '{"name":"WhiskyName","origin":"WhiskyOrigin"}' localhost:8080/api/whiskies

Run:

• rebuild, run unit/integration tests and start app

$ ./run.sh build
[INFO] Scanning for projects...
[INFO]
[INFO] -------------------< ru.shishmakov:vertx-tutor-app >--------------------
[INFO] Building vertx-tutor-app 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ vertx-tutor-app ---
[INFO] Deleting /Users/dima/programming/git/vertx/vertx-tutor-app/target
[INFO]

...

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 27.809 s
[INFO] Finished at: 2018-06-03T22:08:17+01:00
[INFO] ------------------------------------------------------------------------

...

01:26:56.603 [vert.x-eventloop-thread-0] INFO  r.s.WebMongoVerticle - server has started successfully
Jun 18, 2018 1:26:56 AM io.vertx.core.impl.launcher.commands.VertxIsolatedDeployer
INFO: Succeeded in deploying verticle

• start app only

$ ./run.sh
01:26:56.603 [vert.x-eventloop-thread-0] INFO  r.s.WebMongoVerticle - server has started successfully
Jun 18, 2018 1:26:56 AM io.vertx.core.impl.launcher.commands.VertxIsolatedDeployer
INFO: Succeeded in deploying verticle

• start app with custom configs

./run.sh ./target/classes/application-conf.json
01:26:56.603 [vert.x-eventloop-thread-0] INFO  r.s.WebMongoVerticle - server has started successfully
Jun 18, 2018 1:26:56 AM io.vertx.core.impl.launcher.commands.VertxIsolatedDeployer
INFO: Succeeded in deploying verticle

• open pages in a web browser
  • 'http://localhost:8080'
  • 'http://localhost:8080/api/whiskies'
  • 'http://localhost:8080/assets/index.html'

Stop

• need interruption by the user, such as typing ^C (Ctrl + C)
• kill the process kill <PID>