Package kos.core

Class SimplifiedRouter

java.lang.Object

kos.core.SimplifiedRouter

All Implemented Interfaces:

io.vertx.core.Handler<io.vertx.core.http.HttpServerRequest>

public class SimplifiedRouter
extends Object
implements io.vertx.core.Handler<io.vertx.core.http.HttpServerRequest>

Small layer over Router that aims to simplify a few common aspects regarding route configuration, like intercepting requests and the reading body requests in a POST, PUT and PATCH requests.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	SimplifiedRouter.SafeRequestInterceptor
private static class	SimplifiedRouter.SafeRoutingContextHandler

Field Summary

Fields

Modifier and Type	Field	Description
private Map<io.vertx.core.http.HttpMethod,Boolean>	httpMethodsThatMayReadBody
private RequestInterceptorHandler	interceptorHandler
private KosConfiguration	kosConfiguration
private io.vertx.core.logging.Logger	log
private io.vertx.ext.web.Router	router

Constructor Summary

Constructors

Modifier	Constructor	Description
	SimplifiedRouter(KosConfiguration kosConfiguration, io.vertx.ext.web.Router router, Map<io.vertx.core.http.HttpMethod,Boolean> httpMethodsThatMayReadBody)
private	SimplifiedRouter(KosConfiguration kosConfiguration, io.vertx.ext.web.Router router, RequestInterceptorHandler interceptor, Map<io.vertx.core.http.HttpMethod,Boolean> httpMethodsThatMayReadBody)

Method Summary

Modifier and Type	Method	Description
void	handle(io.vertx.core.http.HttpServerRequest event)
void	intercept(RequestInterceptor interceptor)	Registers a Handler to intercept all requests.
void	intercept(RequestInterceptor interceptor, boolean tryHandleExceptions)	Registers a Handler to intercept all requests.
void	route(io.vertx.core.http.HttpMethod method, String path, io.vertx.core.Handler<io.vertx.ext.web.RoutingContext> handler)	Routes requests made to path to a particular handler.
void	route(io.vertx.core.http.HttpMethod method, String path, RequestHandler handler)	Routes requests made to path to a particular handler.
io.vertx.ext.web.Router	unwrap()	Returns the wrapped Vert.x Router.
static SimplifiedRouter	wrapWithAutoBodyReader(KosConfiguration kosConfiguration, io.vertx.ext.web.Router router)	Creates an instance of SimplifiedRouter that will automatically read the request body payload for PATCH, POST and PUT.
static SimplifiedRouter	wrapWithNoAutoBodyReader(KosConfiguration kosConfiguration, io.vertx.ext.web.Router router)	Creates a basic instance of SimplifiedRouter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

private final io.vertx.core.logging.Logger log

router

private final io.vertx.ext.web.Router router

interceptorHandler

private final RequestInterceptorHandler interceptorHandler

httpMethodsThatMayReadBody

private final Map<io.vertx.core.http.HttpMethod,Boolean> httpMethodsThatMayReadBody

kosConfiguration

private final KosConfiguration kosConfiguration

Constructor Detail

SimplifiedRouter

public SimplifiedRouter(KosConfiguration kosConfiguration,
                        io.vertx.ext.web.Router router,
                        Map<io.vertx.core.http.HttpMethod,Boolean> httpMethodsThatMayReadBody)

SimplifiedRouter

private SimplifiedRouter(KosConfiguration kosConfiguration,
                         io.vertx.ext.web.Router router,
                         RequestInterceptorHandler interceptor,
                         Map<io.vertx.core.http.HttpMethod,Boolean> httpMethodsThatMayReadBody)

Method Detail

unwrap

public io.vertx.ext.web.Router unwrap()

Returns the wrapped Vert.x Router.

Returns:

the wrapped Vert.x Router

intercept

public void intercept(RequestInterceptor interceptor)

Registers a Handler to intercept all requests.

Parameters:

interceptor - the interceptor handler.

intercept

public void intercept(RequestInterceptor interceptor,
                      boolean tryHandleExceptions)

Registers a Handler to intercept all requests.

Parameters:

tryHandleExceptions - if set true, it will wrap the interceptor and try to handle possible exceptions that might be thrown. It won't be capable to handle those that might happen on a different thread though.

interceptor - the interceptor handler.

route

public void route(io.vertx.core.http.HttpMethod method,
                  String path,
                  RequestHandler handler)

Routes requests made to path to a particular handler.

Parameters:

method - Http Method used by this endpoint

path - relative URI used by this endpoint

handler - request handler

route

public void route(io.vertx.core.http.HttpMethod method,
                  String path,
                  io.vertx.core.Handler<io.vertx.ext.web.RoutingContext> handler)

Routes requests made to path to a particular handler.

Parameters:

method - Http Method used by this endpoint

path - relative URI used by this endpoint

handler - request handler

wrapWithAutoBodyReader

public static SimplifiedRouter wrapWithAutoBodyReader(KosConfiguration kosConfiguration,
                                                      io.vertx.ext.web.Router router)

Creates an instance of SimplifiedRouter that will automatically read the request body payload for PATCH, POST and PUT.

Parameters:

router - the router instance that will be wrapped

Returns:

An instance of SimplifiedRouter

wrapWithNoAutoBodyReader

public static SimplifiedRouter wrapWithNoAutoBodyReader(KosConfiguration kosConfiguration,
                                                        io.vertx.ext.web.Router router)

Creates a basic instance of SimplifiedRouter. Developers that use instances created by this method should configure themselves how to read the request body payload.

Parameters:

router - the router instance that will be wrapped

Returns:

An instance of SimplifiedRouter

handle

public void handle(io.vertx.core.http.HttpServerRequest event)

Specified by:

handle in interface io.vertx.core.Handler<io.vertx.core.http.HttpServerRequest>