Deprecate @MultipartForm

independent-projects/resteasy-reactive/common/runtime/src/main/java/org/jboss/resteasy/reactive/MultipartForm.java

@@ -5,6 +5,8 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import javax.ws.rs.BeanParam;
+
 /**
  * Annotation to be used on POJOs meant to map to the various parts
  * of {@code multipart/form-data} HTTP bodies.
@@ -15,7 +17,13 @@
  * It's important to take caution when using such POJOs to read via {@link org.jboss.resteasy.reactive.multipart.FileUpload},
  * {@code java.io.File} or {@code java.nio.file.Path} uploaded files in a blocking manner, that the resource method should be
  * annotated with {@link io.smallrye.common.annotation.Blocking}.
+ *
+ * @deprecated this annotation is not required anymore: you can use {@link BeanParam} or just omit it entirely, as long as your
+ *             container class holds any annotated fields with {@link RestForm}, {@link RestCookie}, {@link RestHeader},
+ *             {@link RestPath},
+ *             {@link RestMatrix}, {@link RestQuery} or their JAX-RS equivalents.
  */
+@Deprecated(forRemoval = true)
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ ElementType.PARAMETER, ElementType.TYPE })
 public @interface MultipartForm {