Provide examples of the different format of groovy verticles we support.

Author: cescoffier

core-examples/README.adoc

@@ -362,4 +362,24 @@ export NODE_PATH=$PWD
 vertx run my_npm_verticle.js
 ----
 
+== Groovy verticles
+
+Vert.x supports several _formats_ to develop verticles in Groovy. This link:src/main/groovy/verticles[directory]
+illustrates the different formats:
+
+* link:src/main/groovy/verticles/script.groovy[plain script] - a verticle developed as a plain Groovy script
+* link:src/main/groovy/verticles/script-with-hooks.groovy[plain script with hooks] - a verticle developed as a script
+ with hooks called by vert.x when the verticle is deployed and un-deployed
+* link:src/main/groovy/verticles/verticle-extending-abstract-verticle.groovy[class extending AbstractVerticle] - a
+verticle developed as a class extending `AbstractVerticle`
+* link:src/main/groovy/verticles/verticle-extending-groovy-verticle.groovy[class extending GroovyVerticle] - a
+verticle developed as a class extending `GroovyVerticle`
+
+You can run these examples using the `vertx` command line. For example:
+
+```
+vertx run script.groovy
+```
+
+
 

core-examples/src/main/groovy/verticles/README.md

@@ -0,0 +1,2 @@
+This directory contains examples of the different _formats_ supported to develop Groovy verticles. 
+**Do not remove**, the files are not generated. 

core-examples/src/main/groovy/verticles/script-with-hooks.groovy

@@ -0,0 +1,18 @@
+/**
+ * A verticle developed as a groovy script with hooks. vert.x calls the `vertxStart` and `vertxStop` method when the verticle
+ * is deployed and un-deployed.
+ * @author <a href="http://escoffier.me">Clement Escoffier</a>
+ */
+
+void vertxStart() {
+  println "starting"
+  vertx.createHttpServer().requestHandler({ request ->
+    request.response().end("Hello world")
+  }).listen(8080)
+
+}
+
+void vertxStop() {
+  println "stopping"
+}
+

core-examples/src/main/groovy/verticles/script.groovy

@@ -0,0 +1,11 @@
+/**
+ * A verticle developed as a plain groovy script. The code is executed in the Vert.x Event Loop
+ * @author <a href="http://escoffier.me">Clement Escoffier</a>
+ */
+
+
+println "Starting from " + Thread.currentThread().name
+
+vertx.createHttpServer().requestHandler({ request ->
+  request.response().end("Hello world")
+}).listen(8080)

core-examples/src/main/groovy/verticles/verticle-extending-abstract-verticle.groovy

@@ -0,0 +1,25 @@
+import io.vertx.core.AbstractVerticle
+
+/**
+ * A verticle developed as class extending `AbstractVerticle`.
+ * @author <a href="http://escoffier.me">Clement Escoffier</a>
+ */
+
+class MyVerticle extends AbstractVerticle {
+
+  @Override
+  void start() throws Exception {
+    println "starting"
+
+    vertx.createHttpServer().requestHandler({ request ->
+      request.response().end("Hello world")
+    }).listen(8080)
+  }
+
+  @Override
+  void stop() throws Exception {
+    println "stopping"
+  }
+}
+
+

core-examples/src/main/groovy/verticles/verticle-extending-groovy-verticle.groovy

@@ -0,0 +1,25 @@
+import io.vertx.lang.groovy.GroovyVerticle
+
+/**
+ * A verticle developed as class extending `GroovyVerticle`.
+ * @author <a href="http://escoffier.me">Clement Escoffier</a>
+ */
+
+class MyVerticle extends GroovyVerticle {
+
+  @Override
+  void start() throws Exception {
+    println "starting"
+
+    vertx.createHttpServer().requestHandler({ request ->
+      request.response().end("Hello world")
+    }).listen(8080)
+  }
+
+  @Override
+  void stop() throws Exception {
+    println "stopping"
+  }
+}
+
+