Package dev.relism.flash.ext.view.core

Class BaseViewHandler<TTarget>

java.lang.Object

dev.relism.flash.models.RequestHandler

dev.relism.flash.ext.view.core.BaseViewHandler<TTarget>

Direct Known Subclasses:

JteHandler, ThymeleafHandler

public abstract class BaseViewHandler<TTarget>
extends RequestHandler

Constructor Summary

Constructors

Constructor	Description
BaseViewHandler()

Method Summary

Modifier and Type	Method	Description
final Object	handle(Request request, Response response)	Handles an incoming request.
protected final void	onInit()	Override to cache services at boot time.
protected void	onViewInit()
ViewModel	render(Request req)
ViewModel	render(Request req, Response res)
final ViewModel	renderInternal(Request req, Response res)

Methods inherited from class dev.relism.flash.models.RequestHandler

bind, find, optional, require

Methods inherited from class java.lang.Object

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

Constructor Details

BaseViewHandler

public BaseViewHandler()

Method Details

render

public ViewModel render(Request req)
                 throws Exception

Throws:

Exception

render

public ViewModel render(Request req,
 Response res)
                 throws Exception

Throws:

Exception

onInit

protected final void onInit()

Description copied from class: RequestHandler

Override to cache services at boot time. Called once after RequestHandler.bind(dev.relism.flash.extension.FlashContext), before any request reaches this handler.

Use RequestHandler.require(java.lang.Class<T>) and RequestHandler.find(java.lang.Class<T>) to retrieve services from the FlashContext. Cache them in private fields so the hot-path (RequestHandler.handle(dev.relism.flash.models.Request, dev.relism.flash.models.Response)) has zero lookup overhead.

Important: if your class extends another handler base (e.g. JacksonHandler), call super.onInit() first so the parent can initialise its own services.

 @Override protected void onInit() {
     super.onInit();
     myService = require(MyService.class);
 }
 

Overrides:

onInit in class RequestHandler

onViewInit

protected void onViewInit()

handle

public final Object handle(Request request,
 Response response)
                    throws Exception

Description copied from class: RequestHandler

Handles an incoming request. The return value determines the response body: return a Response to replace the whole response, any other non-null value to set it as the body, or null to leave the response as-is.

Specified by:

handle in class RequestHandler

Throws:

Exception

renderInternal

public final ViewModel renderInternal(Request req,
 Response res)
                               throws Exception

Throws:

Exception