From 2c13e5a83ac4297d5ed11d53da92c2cc560b8d9b Mon Sep 17 00:00:00 2001
From: Christian Kaltepoth <christian@kaltepoth.de>
Date: Fri, 23 Nov 2018 17:15:22 +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..e02967ee6 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. If there is at least one
+ * {@link FormParam} for a resource method, JAX-RS implementations MUST support a {@link javax.ws.rs.core.Form}
+ * entity parameter for the same method. Support for other entity parameter types is OPTIONAL.
+ * </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>