AbstractFrameworkHandlerMapping class abstract

A specialized AbstractAnnotatedHandlerMapping that registers JetLeaf framework-specific routes and endpoints.

AbstractFrameworkHandlerMapping extends AbstractAnnotatedHandlerMapping and provides the default infrastructure routes used internally by JetLeaf, such as the framework home page and favicon endpoints.

This class ensures that core framework functionality is accessible immediately after initialization, without requiring explicit controller definitions from the application.

Responsibilities

• Register built-in JetLeaf routes (e.g., /jetleaf, /favicon.ico).
• Construct route handlers using FrameworkHandlerMethod.
• Integrate with the parent handler mapping for pattern matching via AbstractAnnotatedHandlerMapping.registerHandler.
• Ensure framework routes respect the application’s context path.

Initialization Flow

1. During Pod construction, the @PreConstruct annotated init method is invoked automatically.
2. init builds a RouterBuilder for default framework routes.
3. Routes are parsed into PathPatterns using the injected PathPatternParserManager.
4. Each route is registered with a corresponding FrameworkHandlerMethod.

Example

final mapping = MyFrameworkHandlerMapping(parserManager);
mapping.init();

// GET /jetleaf → serves resources/framework/home.html
// GET /favicon.ico → serves the default SVG icon

See also

• AbstractAnnotatedHandlerMapping
• AbstractAnnotatedHandlerMapping
• FrameworkHandlerMethod
• RouterBuilder

Inheritance

• Object
• AbstractHandlerMapping
• AbstractWebViewAnnotatedHandlerMapping
• AbstractAnnotatedHandlerMapping
• AbstractFrameworkHandlerMapping

Implementers

• AbstractRouteDslHandlerMapping

Annotations

• @Author.new("Evaristus Adimonyemma")

Constructors

AbstractFrameworkHandlerMapping(PathPatternParserManager parser)

A specialized AbstractAnnotatedHandlerMapping that registers JetLeaf framework-specific routes and endpoints.

Properties

applicationContext ↔ ApplicationContext

The application context used for accessing Pod definitions.

getter/setter pair, inherited

hashCode → int

The hash code for this object.

no setter, inherited

logger → Log

Framework logger for debug and diagnostic output.

final, inherited

parser → PathPatternParserManager

The composite path matcher used to evaluate and normalize URL patterns.

final, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

getContextPath() → String

Returns the global context path from the active Environment.

inherited

getHandler(ServerHttpRequest request) → HandlerMethod?

Resolves a HandlerMethod capable of handling the given request.

inherited

getPackageName() → String

Represents an abstraction for identifying the package that an object, resource, or service belongs to.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

onReady() → Future<void>

Initializes built-in Jetleaf routes.

override

registerHandler(PathPattern pattern, HandlerMethod handler) → void

Registers a HandlerMethod for the given pattern.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited