From 9acd5dc9a14e73e598bc2e4361c14670c2ad1d45 Mon Sep 17 00:00:00 2001
From: Christian Kaltepoth <christian@kaltepoth.de>
Date: Sun, 4 Nov 2018 15:41:29 +0100
Subject: [PATCH] Define that FormParam values must be read from Form entity

---
 jaxrs-api/src/main/java/javax/ws/rs/FormParam.java | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/jaxrs-api/src/main/java/javax/ws/rs/FormParam.java b/jaxrs-api/src/main/java/javax/ws/rs/FormParam.java
index 69a9fbcd2..00fcda811 100644
--- a/jaxrs-api/src/main/java/javax/ws/rs/FormParam.java
+++ b/jaxrs-api/src/main/java/javax/ws/rs/FormParam.java
@@ -46,6 +46,13 @@
  * </p>
  *
  * <p>
+ * If this annotation is used to bind form parameters, a JAX-RS implementation MUST use the entity provider API
+ * to create a {@link javax.ws.rs.core.Form} and derive the values from this instance. This implies,
+ * that {@link javax.ws.rs.core.Form} is the only allowed entity parameter type if there is at least one
+ * {@link FormParam} annotation for a request.
+ * </p>
+ *
+ * <p>
  * Note that, whilst the annotation target permits use on fields and methods, this annotation is only required to be
  * supported on resource method parameters.
  * </p>