open-api: support 3.1.0

- fix #3759

Author: jknack

modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/OpenAPITask.java

@@ -35,6 +35,8 @@ public class OpenAPITask extends BaseTask {
 
   private String excludes;
 
+  private String specVersion;
+
   /**
    * Generate OpenAPI files from Jooby application.
    *
@@ -67,6 +69,7 @@ public void generate() throws Throwable {
     tool.setClassLoader(classLoader);
     tool.setOutputDir(outputDir);
     tool.setSources(sources);
+    tool.setSpecVersion(specVersion);
     trim(includes).ifPresent(tool::setIncludes);
     trim(excludes).ifPresent(tool::setExcludes);
 
@@ -157,6 +160,22 @@ public void setExcludes(@Nullable String excludes) {
     this.excludes = excludes;
   }
 
+
+  /**
+   * Get the OpenAPI spec version. One of <code>3.0.1</code>, <code>3.1.0</code>.
+   *
+   * @return The OpenAPI spec version. One of <code>3.0.1</code>, <code>3.1.0</code>.
+   */
+  @Input
+  @org.gradle.api.tasks.Optional
+  public String getSpecVersion() {
+    return specVersion;
+  }
+
+  public void setSpecVersion(String specVersion) {
+    this.specVersion = specVersion;
+  }
+
   private Optional<String> trim(String value) {
     if (value == null || value.trim().length() == 0) {
       return Optional.empty();

modules/jooby-maven-plugin/src/main/java/io/jooby/maven/OpenAPIMojo.java

@@ -44,6 +44,9 @@ public class OpenAPIMojo extends BaseMojo {
   @Parameter(property = "openAPI.excludes")
   private String excludes;
 
+  @Parameter(property = "openAPI.specVersion")
+  private String specVersion;
+
   @Override
   protected void doExecute(@NonNull List<MavenProject> projects, @NonNull String mainClass)
       throws Exception {
@@ -61,6 +64,9 @@ protected void doExecute(@NonNull List<MavenProject> projects, @NonNull String m
     getLog().debug("Source directories: " + sources);
 
     OpenAPIGenerator tool = new OpenAPIGenerator();
+    if (specVersion != null) {
+      tool.setSpecVersion(specVersion);
+    }
     tool.setClassLoader(classLoader);
     tool.setOutputDir(outputDir);
     tool.setSources(sources);
@@ -117,4 +123,12 @@ public void setIncludes(@Nullable String includes) {
   public void setExcludes(@Nullable String excludes) {
     this.excludes = excludes;
   }
+
+  public String getSpecVersion() {
+    return specVersion;
+  }
+
+  public void setSpecVersion(String specVersion) {
+    this.specVersion = specVersion;
+  }
 }

modules/jooby-openapi/src/main/java/io/jooby/openapi/OpenAPIGenerator.java

@@ -442,6 +442,20 @@ public void setSpecVersion(SpecVersion specVersion) {
     this.specVersion = specVersion;
   }
 
+  public void setSpecVersion(String version) {
+    if (specVersion != null) {
+      switch (version) {
+        case "v3.1", "v3.1.0", "3.1", "3.1.0":
+          setSpecVersion(SpecVersion.V31);
+        case "v3.0", "v3.0.0", "3.0", "3.0.0", "v3.0.1", "3.0.1":
+          setSpecVersion(SpecVersion.V30);
+        default:
+          throw new IllegalArgumentException(
+              "Invalid spec version: " + version + ". Supported version: [3.0.1, 3.1.0]");
+      }
+    }
+  }
+
   private String appname(String classname) {
     String name = classname;
     int i = name.lastIndexOf('.');