Merge pull request #31498 from drmaniac/resteasy-openapi-31486

Added a note to get correct OpenAPI documentation
quarkusio · Mar 2, 2023 · 2139851 · 2139851
2 parents 27d7d5f + 2c15623
commit 2139851
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/docs/src/main/asciidoc/resteasy-reactive.adoc b/docs/src/main/asciidoc/resteasy-reactive.adoc
@@ -383,13 +383,14 @@ public class Endpoint {
     }
 
     @POST
-    public String allParams(Parameters parameters) {
+    public String allParams(@BeanParam Parameters parameters) { <1>
         return parameters.type + "/" + parameters.variant + "/" + parameters.age 
             + "/" + parameters.level + "/" + parameters.secretHandshake
             + "/" + parameters.smell;
     }
 }
 ----
+<1>  `BeanParam` is required to comply with the JAX-RS specification so that libraries like OpenAPI can introspect the parameters.
 
 === Declaring URI parameters