feat(core): add any() route registration, warn on undocumented OpenAPI routes, log unhandled 500s
Publish Maven packages / publish (push) Failing after 3m35s

FlashRegistrar#any() registers a handler under every HTTP method for
verb-indifferent handlers (e.g. a reverse proxy). OpenApiExtension now warns
when a class-based handler has no @ApiOperation instead of silently omitting
it from the spec. AbstractRouter's default production exception handler now
logs unhandled exceptions server-side instead of only returning a JSON 500.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Zakaria El Orche
2026-08-31 11:56:51 +00:00
co-authored by Claude Sonnet 5
parent 3d743b34ce
commit 74169e40f4
3 changed files with 16 additions and 1 deletions
@@ -10,6 +10,7 @@ import dev.relism.flash.extension.RouteEvent;
import dev.relism.flash.http.ContentType;
import dev.relism.flash.http.HttpMethod;
import dev.relism.flash.routing.Route;
import lombok.extern.slf4j.Slf4j;
/**
* Generates and serves an OpenAPI 3.0 spec and Swagger UI under a configurable base path.
@@ -34,6 +35,7 @@ import dev.relism.flash.routing.Route;
* .start();
* }</pre>
*/
@Slf4j
public class OpenApiExtension implements FlashExtension {
private static final String YAML_CONTENT_TYPE = "application/yaml";
@@ -124,7 +126,11 @@ public class OpenApiExtension implements FlashExtension {
if (handlerClass == null) return; // lambda route: no annotation metadata
ApiOperation op = handlerClass.getAnnotation(ApiOperation.class);
if (op == null) return;
if (op == null) {
log.warn("{} {} ({}) has no @ApiOperation — omitted from the OpenAPI spec",
event.method(), event.path(), handlerClass.getSimpleName());
return;
}
builder.addOperation(routeOf(event), op, handlerClass);
}