Programmatic Routes with GroovyRouterBuilder

If you prefer to build your routes programmatically (similar to Grails UrlMappings) then a special io.micronaut.web.router.GroovyRouteBuilder exists that has some enhancements to make the DSL better.

The following example shows GroovyRouteBuilder in act:

Using GroovyRouteBuilder

  1. @Singleton
  2. static class MyRoutes extends GroovyRouteBuilder {
  4.     MyRoutes(ApplicationContext beanContext) {
  5.         super(beanContext)
  6.     }
  8.     @Inject
  9.     void bookResources(BookController bookController, AuthorController authorController) {
  10.         GET(bookController) {
  11.             POST("/hello{/message}", bookController.&hello) (1)
  12.         }
  13.         GET(bookController, ID) { (2)
  14.             GET(authorController)
  15.         }
  16.     }
  17. }
1You can use injected controllers to create routes by convention and Groovy method references to create routes to methods
2The ID property can be used to reference include an {id} URI variable

The above example results in the following routes:

  • /book - Maps to BookController.index()

  • /book/hello/{message} - Maps to BookController.hello(String)

  • /book/{id} - Maps to BookController.show(String id)

  • /book/{id}/author - Maps to AuthorController.index