Flash5/flash-extensions/flash-ext-view-jte/docs/architecture.md

Architecture

flash-ext-view-jte has two layers:

1. Boot-time

   • JteExtension installs runtime + annotation processor.
   • JteTargetResolver validates handlers and resolves @Template.
   • Resolved targets are cached per handler class.

2. Request-time

   • Handler builds local ViewModel.
   • Runtime injects globals under reserved global namespace and merges local model.
   • jte renders template into StringOutput.

Handler Contract

• Must extend JteHandler.
• Must have route annotation (@Route, @GET, @POST, ...).
• Must declare exactly one view annotation: @Template.

Invalid configurations fail fast at startup.

Defaults

• templateRoot: /templates
• contentType: gg.jte.ContentType.Html
• developmentMode: Flash.DEV
• usePrecompiled: derived from !developmentMode unless explicitly set
• binaryStaticContent: false