Eclipse Vert.x is a lightweight framework for developing web applications, microservices and more.<\/p>\n
I’ve created a project using IntelliJ named VertxTest based upon a Maven project to try out the routing functionality in Vert.x.<\/p>\n
Dependencies – the pom<\/strong><\/p>\n Our pom.xml looks like this<\/p>\n The Verticle<\/strong><\/p>\n As you can see from this my class MainVerticle (which extends AbstractVerticle) is created in the package com.putridparrot and the code looks like this<\/p>\n Note: queryParam actually returns a List We extend AbstractVerticle overriding the start<\/em> method to handle the setting up of our routes etc. <\/p>\n Building and Running<\/strong><\/p>\n We execute mvn clean install<\/em> and then mvn package<\/em> to generate the executable jar. Finally we can run this using java -jar target\/VertxTest-1.0-SNAPSHOT-fat.jar<\/em> or similar in a configuration in an IDE (for example a JAR Application configuration within Intelli J just requires the path to the JAR listed above).<\/p>\n Testing and more<\/strong><\/p>\n Now we should be able to run the following from your preferred web browser or Intelli J’s REST client (or similar in another IDE).<\/p>\n We can easily add further routes and\/or handle GET or POST HTTP methods. For example here’s the addition of an error route using the get<\/em> method<\/p>\n and<\/p>\n Now browsing to <\/p>\n will display a 500 error.<\/p>\n Static pages<\/strong><\/p>\n We can also add static pages by declaring a route such as<\/p>\n where the pages directory is located off the root off of the project folder (in this example). Simply place your HTML pages in this folder and you can access them using the following URL <\/p>\n Routing based upon mime type<\/strong><\/p>\n Along with routine based upon the specific query\/resource requested we can also route based upon the Content-Type within a request. For example if using HTTP POST with Content-Type application\/json we would want to return JSON, likewise if Content-Type is application\/xml we’d expect XML return (and so on).<\/p>\n To route based upon the mime type we simply write the following<\/p>\n Obviously in the examples above we’re simply routing off of the root “\/” URL. Supply a path within the route<\/em> method, as per previous example for other routing scenarios.<\/p>\n Running our Vertx application<\/strong><\/p>\n We’ve seen we can create and run the JAR, but we can also create a Vertx application by creating a main method that looks something like this<\/p>\n We use deployVerticle<\/em> along with our Verticle and Vertx does the rest.<\/p>\n","protected":false},"excerpt":{"rendered":" Eclipse Vert.x is a lightweight framework for developing web applications, microservices and more. I’ve created a project using IntelliJ named VertxTest based upon a Maven project to try out the routing functionality in Vert.x. Dependencies – the pom Our pom.xml looks like this <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd"> <modelVersion>4.0.0<\/modelVersion> <groupId>VertxTest<\/groupId> <artifactId>VertxTest<\/artifactId> <version>1.0-SNAPSHOT<\/version> […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[161,210],"tags":[],"class_list":["post-6020","post","type-post","status-publish","format-standard","hentry","category-java","category-vert-x"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/6020","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=6020"}],"version-history":[{"count":14,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/6020\/revisions"}],"predecessor-version":[{"id":6035,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/6020\/revisions\/6035"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=6020"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=6020"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=6020"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0"\r\n xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n xsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd">\r\n <modelVersion>4.0.0<\/modelVersion>\r\n\r\n <groupId>VertxTest<\/groupId>\r\n <artifactId>VertxTest<\/artifactId>\r\n <version>1.0-SNAPSHOT<\/version>\r\n\r\n <properties>\r\n <java.version>1.8<\/java.version>\r\n <vertx.version>3.5.0<\/vertx.version>\r\n <\/properties>\r\n <build>\r\n <plugins>\r\n <plugin>\r\n <groupId>org.apache.maven.plugins<\/groupId>\r\n <artifactId>maven-compiler-plugin<\/artifactId>\r\n <version>3.5.1<\/version>\r\n <configuration>\r\n <source>${java.version}<\/source>\r\n <target>${java.version}<\/target>\r\n <\/configuration>\r\n <\/plugin>\r\n <plugin>\r\n <groupId>org.apache.maven.plugins<\/groupId>\r\n <artifactId>maven-shade-plugin<\/artifactId>\r\n <version>2.4.3<\/version>\r\n <executions>\r\n <execution>\r\n <phase>package<\/phase>\r\n <goals>\r\n <goal>shade<\/goal>\r\n <\/goals>\r\n <configuration>\r\n <transformers>\r\n <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">\r\n <manifestEntries>\r\n <Main-Class>io.vertx.core.Launcher<\/Main-Class>\r\n <Main-Verticle>com.putridparrot.MainVerticle<\/Main-Verticle>\r\n <\/manifestEntries>\r\n <\/transformer>\r\n <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">\r\n <resource>META-INF\/services\/io.vertx.core.spi.VerticleFactory<\/resource>\r\n <\/transformer>\r\n <\/transformers>\r\n <artifactSet>\r\n <\/artifactSet>\r\n <outputFile>${project.build.directory}\/${project.artifactId}-${project.version}-fat.jar<\/outputFile>\r\n <\/configuration>\r\n <\/execution>\r\n <\/executions>\r\n <\/plugin>\r\n <plugin>\r\n <groupId>org.codehaus.mojo<\/groupId>\r\n <artifactId>exec-maven-plugin<\/artifactId>\r\n <version>1.5.0<\/version>\r\n <configuration>\r\n <mainClass>io.vertx.core.Launcher<\/mainClass>\r\n <arguments>\r\n <argument>run<\/argument>\r\n <argument>com.putridparrot.MainVerticle<\/argument>\r\n <\/arguments>\r\n <\/configuration>\r\n <\/plugin>\r\n <\/plugins>\r\n <\/build>\r\n <dependencies>\r\n <dependency>\r\n <groupId>io.vertx<\/groupId>\r\n <artifactId>vertx-core<\/artifactId>\r\n <version>${vertx.version}<\/version>\r\n <\/dependency>\r\n <dependency>\r\n <groupId>io.vertx<\/groupId>\r\n <artifactId>vertx-unit<\/artifactId>\r\n <version>${vertx.version}<\/version>\r\n <\/dependency>\r\n <dependency>\r\n <groupId>io.vertx<\/groupId>\r\n <artifactId>vertx-web<\/artifactId>\r\n <version>${vertx.version}<\/version>\r\n <\/dependency>\r\n <\/dependencies>\r\n<\/project>\r\n<\/pre>\n\r\npackage com.putridparrot;\r\n\r\nimport io.vertx.core.AbstractVerticle;\r\nimport io.vertx.ext.web.Router;\r\nimport io.vertx.ext.web.handler.BodyHandler;\r\n\r\npublic class MainVerticle extends AbstractVerticle {\r\n @Override\r\n public void start() {\r\n\r\n Router router = Router.router(vertx);\r\n\r\n router.route("\/hello").handler(ctx -> {\r\n ctx.response()\r\n .putHeader("content-type", "text\/plain")\r\n .end("Hello " + ctx.queryParam("name"));\r\n });\r\n\r\n vertx.createHttpServer()\r\n .requestHandler(router::accept)\r\n .listen(8080);\r\n\r\n System.out.println("HTTP server started on port 8080");\r\n }\r\n}\r\n<\/pre>\n\r\nhttp:\/\/localhost:8080\/hello?name=Mark\r\n<\/pre>\n
\r\nrouter.get("\/error")\r\n .handler(this::handleGetError);\r\n<\/pre>\n\r\nprivate void handleGetError(RoutingContext ctx) {\r\n ctx.response()\r\n .setStatusCode(500)\r\n .end();\r\n}\r\n<\/pre>\n\r\nhttp:\/\/localhost:8080\/error\r\n<\/pre>\n
\r\n router.route("\/pages\/*")\r\n .handler((StaticHandler.create("pages")));\r\n<\/pre>\n\r\nhttp:\/\/localhost:8080\/pages\/index.html\r\n<\/pre>\n
\r\nrouter.route()\r\n .consumes("*\/json")\r\n .handler(ctx -> {\r\n System.out.println("JSON request");\r\n});\r\n\r\nrouter.route()\r\n .consumes("*\/xml")\r\n .handler(ctx -> {\r\n System.out.println("XML request");\r\n});\r\n<\/pre>\n\r\npublic static void main(String[] args) {\r\n Vertx vertx = Vertx.vertx();\r\n\r\n vertx.deployVerticle(new MainVerticle());\r\n}\r\n<\/pre>\n