Add io.avaje.http.api @Valid Annotation to support custom validators

http-api/src/main/java/io/avaje/http/api/IgnoreBeanField.java

@@ -0,0 +1,12 @@
+package io.avaje.http.api;
+
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.RetentionPolicy.SOURCE;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/** Mark a field on a BeanParam/FormParam class as not a request parameter of any kind */
+@Target(FIELD)
+@Retention(SOURCE)
+public @interface IgnoreBeanField {}

http-api/src/main/java/io/avaje/http/api/Valid.java

@@ -0,0 +1,23 @@
+package io.avaje.http.api;
+
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PARAMETER;
+import static java.lang.annotation.ElementType.TYPE;
+import static java.lang.annotation.RetentionPolicy.SOURCE;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ *
+ * Add @Valid annotation on a controller/method/BeanParam that we want bean validation to be included for.
+ * When we do this controller methods that take a request payload will then have the request bean
+ * (populated by JSON payload or form parameters) validated before it is passed to the controller
+ * method.
+ *
+ * When trying to validate a @BeanParam bean, this will need to be placed on the BeanParam type
+
+ */
+@Retention(SOURCE)
+@Target({METHOD, TYPE, PARAMETER})
+public @interface Valid {}

http-generator-core/src/main/java/io/avaje/http/generator/core/BeanParamReader.java

@@ -40,6 +40,10 @@ private void read() {
   }
 
   private void readField(Element enclosedElement) {
+
+    if (IgnoreBeanFieldPrism.isPresent(enclosedElement)) {
+      return;
+    }
     FieldReader field = new FieldReader(enclosedElement, defaultParamType);
     fieldMap.put(field.varName(), field);
   }

http-generator-core/src/main/java/io/avaje/http/generator/core/ControllerReader.java

@@ -162,6 +162,7 @@ private boolean initDocHidden() {
   private boolean initHasValid() {
 
     return findAnnotation(JavaxValidPrism::getOptionalOn).isPresent()
+        || findAnnotation(JakartaValidPrism::getOptionalOn).isPresent()
         || findAnnotation(ValidPrism::getOptionalOn).isPresent();
   }
 

http-generator-core/src/main/java/io/avaje/http/generator/core/ElementReader.java

@@ -129,7 +129,9 @@ private boolean useValidation() {
     }
     final var elementType = typeElement(rawType);
     return elementType != null
-        && (ValidPrism.isPresent(elementType) || JavaxValidPrism.isPresent(elementType));
+        && (ValidPrism.isPresent(elementType)
+            || JavaxValidPrism.isPresent(elementType)
+            || JakartaValidPrism.isPresent(elementType));
   }
 
   private void readAnnotations(Element element, ParamType defaultType) {

http-generator-core/src/main/java/io/avaje/http/generator/core/package-info.java

@@ -1,6 +1,7 @@
 /** Generate the prisms to access annotation info */
 @GeneratePrism(value = io.avaje.http.api.Controller.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.BeanParam.class, publicAccess = true)
+@GeneratePrism(value = io.avaje.http.api.IgnoreBeanField.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.QueryParam.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.Client.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.Cookie.class, publicAccess = true)
@@ -26,12 +27,13 @@
 @GeneratePrism(value = io.avaje.http.api.OpenAPIResponse.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.OpenAPIResponses.class, publicAccess = true)
 @GeneratePrism(value = io.swagger.v3.oas.annotations.Hidden.class, publicAccess = true)
-@GeneratePrism(value = javax.validation.Valid.class, name = "JavaxValidPrism", publicAccess = true)
-@GeneratePrism(value = jakarta.validation.Valid.class, publicAccess = true)
 @GeneratePrism(value = org.jetbrains.annotations.NotNull.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.Client.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.Client.Import.class, publicAccess = true)
 @GeneratePrism(value = io.avaje.http.api.RequestTimeout.class, publicAccess = true)
+@GeneratePrism(value = javax.validation.Valid.class, name = "JavaxValidPrism")
+@GeneratePrism(value = jakarta.validation.Valid.class, name = "JakartaValidPrism")
+@GeneratePrism(value = io.avaje.http.api.Valid.class)
 package io.avaje.http.generator.core;
 
 import io.avaje.prism.GeneratePrism;

tests/test-javalin-jsonb/src/main/java/org/example/myapp/web/GetBeanForm.java

@@ -9,8 +9,10 @@
 import javax.validation.constraints.Size;
 
 import io.avaje.http.api.Header;
+import io.avaje.http.api.IgnoreBeanField;
 import io.avaje.http.api.QueryParam;
 import io.avaje.jsonb.Json;
+import io.avaje.jsonb.Json.Ignore;
 
 @Json
 @Valid
@@ -30,6 +32,12 @@ public class GetBeanForm {
 
   @QueryParam private Set<ServerType> type;
 
+  @Ignore @IgnoreBeanField private String ignored;
+
+  public String getIgnored() {
+    return ignored;
+  }
+
   public String getName() {
     return name;
   }

tests/test-javalin-jsonb/src/main/java/org/example/myapp/web/HelloController.java

@@ -8,8 +8,6 @@
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.Executors;
 
-import javax.validation.Valid;
-
 import org.example.myapp.service.MyService;
 
 import io.avaje.http.api.BeanParam;
@@ -23,6 +21,7 @@
 import io.avaje.http.api.Post;
 import io.avaje.http.api.Produces;
 import io.avaje.http.api.QueryParam;
+import io.avaje.http.api.Valid;
 import io.javalin.http.Context;
 import io.swagger.v3.oas.annotations.Hidden;
 import jakarta.inject.Inject;