Files

T

Zakaria El OrcheandClaude Sonnet 5 4feabc45d5 fix(ext-view): clear cross-engine error, propagate globals across JteExtension builder chain

- BaseViewExtension: wrap the ViewRuntimeBridge provider collision with a message
  naming the real constraint (one view engine per FlashApp) instead of the generic
  "duplicate provider" error.
- BaseViewExtension/JteExtension: carry registered globals across JteExtension's
  immutable settings builders (templateRoot/serveStatics/staticPrefix/withStaticCors/
  staticCors). addGlobal() called before any of those used to be silently dropped,
  since each builder method returned a fresh instance with an empty globals list.
- Correct flash-ext-view-jte docs (README, architecture.md, model-and-globals.md):
  globals merge flat with one typed @param per key, not under a global.* namespace
  like Thymeleaf — the docs previously claimed the same reserved namespace for both
  engines, which doesn't match JteRuntime's actual merge behavior.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-09-09 13:31:21 +00:00

1.4 KiB

Raw Blame History

Architecture

flash-ext-view-jte has two layers:

Boot-time
- JteExtension installs runtime + annotation processor.
- JteTargetResolver validates handlers and resolves @Template.
- Resolved targets are cached per handler class.
Request-time
- Handler builds local ViewModel.
- Runtime merges globals and local model into one flat parameter map (fails fast on key collision).
- jte renders template into StringOutput.
Static assets (optional, enabled by default)
- Extension mounts wildcard routes under staticPrefix (default /static/**).
- Assets are served from classpath /static/**.
- Uses Flash Response.body(...) for small payloads and Response.stream(...) for large payloads.
- Supports ETag/304, gzip precompressed assets, MIME auto-resolution, and byte ranges.

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
serveStatics: true
staticPrefix: /static
largeFileThresholdBytes: 65536
static CORS: disabled (false)

1.4 KiB Raw Blame History

Architecture

Handler Contract

Defaults

1.4 KiB

Raw Blame History