add static asset serving support with configurable options

2026-04-26 12:27:59 +02:00
parent 6ef11ca595
commit c2e3f98ea2
15 changed files with 697 additions and 19 deletions
@@ -15,6 +15,59 @@ The extension mirrors `gg.jte.ContentType` into Flash HTTP content type:
 - `gg.jte.ContentType.Html` -> `text/html`
 - `gg.jte.ContentType.Plain` -> `text/plain`

+## Static serving (opinionated)
+
+Static serving is enabled by default and serves classpath assets from `/static/**`
+(`src/main/resources/static/**`) on an HTTP wildcard route.
+
+Defaults:
+
+- `serveStatics = true`
+- `staticPrefix = "/static"`
+- ETag via CRC32 + length
+- `304 Not Modified` on `If-None-Match`
+- pre-compressed `.gz` support when client sends `Accept-Encoding: gzip`
+- MIME auto-resolution for common web/media/font/wasm types
+- cache policy:
+  - versioned assets (`file.<hash>.ext` or query `?v=...` / `?hash=...`) -> `public, max-age=31536000, immutable`
+  - non-versioned -> `no-cache`
+- byte-range support for large files (threshold configurable, default 64 KiB)
+
+If classpath `/static` is missing, extension logs a warning and disables static routes.
+
+### Configuration examples
+
+```java
+// option 1: customizer constructor
+app.install(new JteExtension(cfg -> cfg
+    .templateRoot("/templates")
+    .serveStatics(true)
+    .staticPrefix("/assets")));
+
+// option 2: fluent style
+app.install(new JteExtension()
+    .templateRoot("/templates")
+    .withStaticServing()
+    .staticPrefix("/assets"));
+```
+
+Disable static serving:
+
+```java
+app.install(new JteExtension().serveStatics(false));
+```
+
+Enable static CORS (default disabled):
+
+```java
+app.install(new JteExtension().staticCors(cfg -> cfg
+    .enableStaticCors(true)
+    .staticCorsAllowOrigin("*")
+    .staticCorsAllowMethods("GET,HEAD,OPTIONS")
+    .staticCorsAllowHeaders("*")
+    .staticCorsMaxAge(3600)));
+```
+
 ## Quick Start

 ```java