open-api: Support OpenAPI @io.swagger.v3.oas.annotations.Parameter on method parameters

- fix #3461

Author: jknack

modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/OpenAPIParser.java

@@ -212,11 +212,17 @@ public static void parse(ParserContext ctx, OperationExt operation) {
     findAnnotationByType(method.visibleAnnotations, Parameter.class).stream()
         .findFirst()
         .ifPresent(a -> parameters(ctx, operation, singletonList(toMap(a))));
-    /**
-     * @RequestBody:
-     */
     if (method.visibleParameterAnnotations != null) {
       for (List<AnnotationNode> paramAnnotations : method.visibleParameterAnnotations) {
+        /**
+         * @Parameter:
+         */
+        findAnnotationByType(paramAnnotations, Parameter.class).stream()
+            .findFirst()
+            .ifPresent(a -> parameters(ctx, operation, singletonList(toMap(a))));
+        /**
+         * @RequestBody:
+         */
         findAnnotationByType(paramAnnotations, RequestBody.class).stream()
             .findFirst()
             .ifPresent(a -> requestBody(ctx, operation, toMap(a)));

modules/jooby-openapi/src/test/java/issues/i3461/App3461.java

@@ -0,0 +1,31 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package issues.i3461;
+
+import java.util.UUID;
+
+import io.jooby.Jooby;
+import io.jooby.annotation.GET;
+import io.jooby.annotation.Path;
+import io.jooby.annotation.QueryParam;
+import io.swagger.v3.oas.annotations.Parameter;
+
+public class App3461 extends Jooby {
+
+  @Path("/")
+  static class Controller {
+
+    @GET("/3461")
+    public String getBlah(
+        @Parameter(required = true, description = "Param annotation") @QueryParam UUID orgId) {
+      return "";
+    }
+  }
+
+  {
+    mvc(new Controller());
+  }
+}

modules/jooby-openapi/src/test/java/issues/i3461/Issue3461.java

@@ -0,0 +1,44 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package issues.i3461;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import io.jooby.openapi.OpenAPIResult;
+import io.jooby.openapi.OpenAPITest;
+
+public class Issue3461 {
+
+  @OpenAPITest(value = App3461.class)
+  public void shouldParseAvajeBeanScopeControllers(OpenAPIResult result) {
+    assertEquals(
+        "openapi: 3.0.1\n"
+            + "info:\n"
+            + "  title: 3461 API\n"
+            + "  description: 3461 API description\n"
+            + "  version: \"1.0\"\n"
+            + "paths:\n"
+            + "  /3461:\n"
+            + "    get:\n"
+            + "      operationId: getBlah\n"
+            + "      parameters:\n"
+            + "      - name: orgId\n"
+            + "        in: query\n"
+            + "        description: Param annotation\n"
+            + "        required: true\n"
+            + "        schema:\n"
+            + "          type: string\n"
+            + "          format: uuid\n"
+            + "      responses:\n"
+            + "        \"200\":\n"
+            + "          description: Success\n"
+            + "          content:\n"
+            + "            application/json:\n"
+            + "              schema:\n"
+            + "                type: string\n",
+        result.toYaml());
+  }
+}