weeks of bullshit

flash-extensions/flash-ext-jackson/src/main/java/dev/relism/ext/jackson/JacksonExtension.java

@@ -4,21 +4,19 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.json.JsonMapper;
 import dev.relism.extension.FlashContext;
 import dev.relism.extension.FlashExtension;
-import dev.relism.extension.FlashRegistrar;
 
 /**
  * Registers JSON support into the Flash extension layer.
  *
  * <p>Exposes a {@link Json} utility instance in the {@link FlashContext} under
- * {@code Json.class}. Any handler or extension in the same scope can retrieve
- * it via {@code require(Json.class)} inside {@code onInit()}.
+ * {@code Json.class}. Any handler or extension can retrieve it via {@code ctx.require(Json.class)}
+ * inside {@code onInit()} (class-based) or inside {@link FlashExtension#routes} (extensions).
  *
  * <p>The raw {@link ObjectMapper} is also registered under {@code ObjectMapper.class}
  * for extensions that need direct mapper access (e.g. OpenAPI schema generation).
  *
  * <h3>Usage — composition (preferred)</h3>
  * <pre>{@code
- * // No mandatory base class. Works from any RequestHandler.
  * public class MyHandler extends RequestHandler {
  *     private Json json;
  *
@@ -33,16 +31,6 @@ import dev.relism.extension.FlashRegistrar;
  * }
  * }</pre>
  *
- * <h3>Usage — convenience base class</h3>
- * <pre>{@code
- * // JacksonHandler remains available as a thin opt-in wrapper.
- * public class MyHandler extends JacksonHandler {
- *     public Object handle(Request req, Response res) throws Exception {
- *         return json(res, service.findAll());
- *     }
- * }
- * }</pre>
- *
  * <h3>Custom mapper</h3>
  * <pre>{@code
  * ObjectMapper mapper = JsonMapper.builder()
@@ -69,9 +57,9 @@ public class JacksonExtension implements FlashExtension {
     }
 
     @Override
-    public void install(FlashRegistrar app, FlashContext ctx) {
+    public void provide(FlashContext ctx) {
         Json json = new Json(mapper);
         ctx.provide(Json.class,         json);
-        ctx.provide(ObjectMapper.class, mapper);   // backward compat for extensions (OpenAPI, etc.)
+        ctx.provide(ObjectMapper.class, mapper);
     }
 }

flash-extensions/flash-ext-jackson/src/main/java/dev/relism/ext/jackson/Json.java

@@ -91,16 +91,7 @@ public final class Json {
      * <p>The returned string is used as the response body by the Flash runtime.
      */
     public String write(Response res, Object obj) throws Exception {
-        res.setContentType(ContentType.JSON);
-        return mapper.writeValueAsString(obj);
-    }
-
-    /**
-     * Like {@link #write(Response, Object)} but also sets an explicit HTTP status code.
-     */
-    public String write(Response res, int status, Object obj) throws Exception {
-        res.status(status);
-        res.setContentType(ContentType.JSON);
+        res.type(ContentType.JSON);
         return mapper.writeValueAsString(obj);
     }
 
@@ -109,7 +100,7 @@ public final class Json {
      * restricting serialization to fields visible under {@code view}.
      */
     public String writeView(Response res, Object obj, Class<?> view) throws Exception {
-        res.setContentType(ContentType.JSON);
+        res.type(ContentType.JSON);
         return mapper.writerWithView(view).writeValueAsString(obj);
     }