open-api: disable javadoc parsing by default

- fix #3841
- allow to set option from maven/gradle

Author: jknack

docs/asciidoc/modules/openapi.adoc

@@ -108,21 +108,25 @@ To avoid this behaviour you can specify maven build phase which suits your needs
 | `${project.dir}`
 |Set base directory used it for loading openAPI template file name.
 
+|`excludes`
+|
+|Regular expression used to excludes route. Example: `/web`.
+
 |`includes`
 | 
 |Regular expression used to includes/keep route. Example: `/api/.*`.
 
-|`excludes`
-|
-|Regular expression used to excludes route. Example: `/web`.
+|`javadoc`
+|`on/true`
+|Turn on/off javadoc generation from Java source files. Set to `off` or `false` to turn it off.
 
 |`specVersion`
 |`3.0`
-|Set the desired spec output
+|Set the desired spec output. Possible values: `3.0` or `3.1`
 
 |`templateName`
 |`openapi.yaml`
-|Set openAPI template file name.
+|Set openAPI template file path.
 
 |===
 
@@ -191,7 +195,7 @@ You will find the files in the output build directory. If your application is `b
 This is the main difference with previous version. We moved from runtime to build time generation. This way we:
 
 - Are able to get our OpenAPI files at build time (of course)
-- At runtime we don't waste resources (CPU, memory) while analyze and build the OpenAPI model
+- At runtime, we don't waste resources (CPU, memory) while analyze and build the OpenAPI model
 - We keep bootstrap as fast as possible
 ====
 
@@ -254,7 +258,7 @@ Full/complete example available https://github.com/jooby-project/library-demo[he
 
 ==== JavaDoc comments
 
-JavaDoc comments are supported on Java in script and MVC routes.
+JavaDoc comments are supported for script and MVC routes on Java code base. They are enable by default, to turn them off set `javadoc: off` or `javadoc: false` in your maven/gradle plugin.
 
 .Script routes
 [source,java, role="primary"]

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

@@ -42,6 +42,8 @@ public class OpenAPITask extends BaseTask {
 
   private List<File> adoc;
 
+  private String javadoc;
+
   /**
    * Creates an OpenAPI task.
    */
@@ -85,6 +87,9 @@ public void generate() throws Throwable {
     }
     trim(includes).ifPresent(tool::setIncludes);
     trim(excludes).ifPresent(tool::setExcludes);
+    if (javadoc != null && !javadoc.trim().isEmpty()) {
+      tool.setJavadoc(javadoc.trim());
+    }
 
     OpenAPI result = tool.generate(mainClass);
 
@@ -195,6 +200,29 @@ public void setSpecVersion(String specVersion) {
     this.specVersion = specVersion;
   }
 
+  /**
+   * True/On to enabled javadoc output. Default is: <code>on</code>.
+   *
+   * @return True/On to enabled javadoc output. Default is: <code>on</code>.
+   */
+  @Input
+  @org.gradle.api.tasks.Optional
+  public String getJavadoc() {
+    return javadoc;
+  }
+
+
+  /**
+   * Enabled or disabled javadoc generation. Set to off/false to turn it off.
+   * Default is: <code>on</code>.
+   *
+   * @param javadoc Enabled or disabled javadoc generation. Set to off/false to turn it off.
+   *                Default is: <code>on</code>.
+   */
+  public void setJavadoc(String javadoc) {
+    this.javadoc = javadoc;
+  }
+
   /**
    * Optionally generates adoc output.
    *

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

@@ -49,6 +49,9 @@ public class OpenAPIMojo extends BaseMojo {
   @Parameter(property = "openAPI.specVersion")
   private String specVersion;
 
+  @Parameter(property = "openAPI.javadoc")
+  private String javadoc;
+
   @Parameter private List<File> adoc;
 
   @Override
@@ -76,6 +79,9 @@ protected void doExecute(@NonNull List<MavenProject> projects, @NonNull String m
     tool.setSources(sources);
     trim(includes).ifPresent(tool::setIncludes);
     trim(excludes).ifPresent(tool::setExcludes);
+    if (javadoc != null && !javadoc.trim().isEmpty()) {
+      tool.setJavadoc(javadoc.trim());
+    }
 
     var result = tool.generate(mainClass);
 
@@ -129,19 +135,57 @@ public void setExcludes(@Nullable String excludes) {
     this.excludes = excludes;
   }
 
+  /**
+   * Spec version. Default is <code>3.0</code>.
+   *
+   * @return Spec version. Default is <code>3.0</code>.
+   */
   public String getSpecVersion() {
     return specVersion;
   }
 
+  /**
+   * Set the desired spec output. Default is <code>3.0</code>.
+   *
+   * @param specVersion One of <code>3.0</code> or <code>3.0</code>.
+   */
   public void setSpecVersion(String specVersion) {
     this.specVersion = specVersion;
   }
 
+  /**
+   * List of asciidoc files to generate documentation.
+   *
+   * @return List of asciidoc files to generate documentation.
+   */
   public List<File> getAdoc() {
     return adoc;
   }
 
+  /**
+   * List of asciidoc files to generate documentation.
+   *
+   * @param adoc List of asciidoc files to generate documentation.
+   */
   public void setAdoc(List<File> adoc) {
     this.adoc = adoc;
   }
+
+  /**
+   * True/On to enabled. By default is: <code>on</code>.
+   *
+   * @param javadoc True/On to enabled.
+   */
+  public void setJavadoc(String javadoc) {
+    this.javadoc = javadoc;
+  }
+
+  /**
+   * True/On to enabled.
+   *
+   * @return True/On to enabled.
+   */
+  public String getJavadoc() {
+    return javadoc;
+  }
 }

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

@@ -531,9 +531,9 @@ public void setOutputDir(@NonNull Path outputDir) {
   }
 
   /**
-   * Set the desired spec output. Default is <code>3.1</code>.
+   * Set the desired spec output. Default is <code>3.0</code>.
    *
-   * @param specVersion One of <code>3.0</code> or <code>3.1</code>.
+   * @param specVersion One of <code>3.0</code> or <code>3.0</code>.
    */
   private void setSpecVersion(SpecVersion specVersion) {
     this.specVersion = specVersion;