Package dev.relism.flash.routing

Class AbstractRouter

java.lang.Object

dev.relism.flash.routing.AbstractRouter

Direct Known Subclasses:

FastPathRouterImpl

public abstract class AbstractRouter
extends Object

Base router contract. Owns error handlers and the compile-time middleware wrapping logic. The only concrete implementation is FastPathRouterImpl.

All middleware composition happens once at boot time; the hot-path sees only a plain RequestHandler call with zero allocation overhead.

Default error handlers

• Dev mode (-Dflash.env=dev): rich HTML pages with full stack traces.
• Prod mode (default): generic JSON — no internal detail leaked to clients.

Override via FlashApp.onNotFound(dev.relism.flash.models.SimpleHandler.FunctionalHandler) / FlashApp.onException(dev.relism.flash.routing.AbstractRouter.ExceptionHandler).

Registration: use FlashApp — the single public registration API. doRegister(dev.relism.flash.http.HttpMethod, java.lang.String, dev.relism.flash.models.RequestHandler, dev.relism.flash.routing.Middleware[]) is an infrastructure method.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractRouter.ExceptionHandler

Field Summary

Fields

Modifier and Type	Field	Description
protected AbstractRouter.ExceptionHandler	exceptionHandler
protected SimpleHandler	notFoundHandler

Constructor Summary

Constructors

Constructor	Description
AbstractRouter()

Method Summary

Modifier and Type	Method	Description
protected abstract AbstractRouter	addRoute(HttpMethod method, String path, RequestHandler handler)
AbstractRouter	doRegister(HttpMethod method, String path, RequestHandler handler, Middleware[] middlewares)	Registers a handler with a pre-built middleware array.
AbstractRouter.ExceptionHandler	getExceptionHandler()
SimpleHandler	getNotFoundHandler()
void	onException(AbstractRouter.ExceptionHandler handler)
void	onNotFound(SimpleHandler.FunctionalHandler handler)
abstract RequestHandler	route(Request request)
protected static void	setPathParams(Request request, String[] names, dev.relism.fpr.core.ByteView source, int[] starts, int[] lens)

Methods inherited from class java.lang.Object

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

Field Details

notFoundHandler

protected SimpleHandler notFoundHandler

exceptionHandler

protected AbstractRouter.ExceptionHandler exceptionHandler

Constructor Details

AbstractRouter

public AbstractRouter()

Method Details

getNotFoundHandler

public SimpleHandler getNotFoundHandler()

getExceptionHandler

public AbstractRouter.ExceptionHandler getExceptionHandler()

onNotFound

public void onNotFound(SimpleHandler.FunctionalHandler handler)

onException

public void onException(AbstractRouter.ExceptionHandler handler)

doRegister

public AbstractRouter doRegister(HttpMethod method,
 String path,
 RequestHandler handler,
 Middleware[] middlewares)

Registers a handler with a pre-built middleware array. Compiles the middleware chain once at boot — zero overhead on hot-path.

route

public abstract RequestHandler route(Request request)

addRoute

protected abstract AbstractRouter addRoute(HttpMethod method,
 String path,
 RequestHandler handler)

setPathParams

protected static void setPathParams(Request request,
 String[] names,
 dev.relism.fpr.core.ByteView source,
 int[] starts,
 int[] lens)