co.cask.http

Interface HandlerHook

All Known Implementing Classes:

AbstractHandlerHook

public interface HandlerHook

Interface that needs to be implemented to intercept handler method calls.

Method Summary

Modifier and Type	Method and Description
void	postCall(io.netty.handler.codec.http.HttpRequest request, io.netty.handler.codec.http.HttpResponseStatus status, co.cask.http.internal.HandlerInfo handlerInfo) postCall is run after a handler method call is made.
boolean	preCall(io.netty.handler.codec.http.HttpRequest request, HttpResponder responder, co.cask.http.internal.HandlerInfo handlerInfo) preCall is run before a handler method call is made.

Method Detail

preCall

boolean preCall(io.netty.handler.codec.http.HttpRequest request,
                HttpResponder responder,
                co.cask.http.internal.HandlerInfo handlerInfo)

preCall is run before a handler method call is made. If any of the preCalls throw exception or return false then no other subsequent preCalls will be called and the request processing will be terminated, also no postCall hooks will be called.

Parameters:

request - HttpRequest being processed.

responder - HttpResponder to send response.

handlerInfo - Info on handler method that will be called.

Returns:

true if the request processing can continue, otherwise the hook should send response and return false to stop further processing.

postCall

void postCall(io.netty.handler.codec.http.HttpRequest request,
              io.netty.handler.codec.http.HttpResponseStatus status,
              co.cask.http.internal.HandlerInfo handlerInfo)

postCall is run after a handler method call is made. If any of the postCalls throw and exception then the remaining postCalls will still be called. If the handler method was not called then postCall hooks will not be called.

Parameters:

request - HttpRequest being processed.

status - Http status returned to the client.

handlerInfo - Info on handler method that was called.