Package org.gradle.api.tasks.javadoc

Class Javadoc

java.lang.Object
org.gradle.api.internal.AbstractTask
org.gradle.api.DefaultTask
org.gradle.api.internal.ConventionTask
org.gradle.api.tasks.SourceTask
org.gradle.api.tasks.javadoc.Javadoc
All Implemented Interfaces:
Comparable<Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.IConventionAware, org.gradle.api.internal.TaskInternal, Named, ExtensionAware, Task, PatternFilterable, Configurable<Task>
@CacheableTask public abstract class Javadoc extends SourceTask

Generates HTML API documentation for Java classes.

If you create your own Javadoc tasks remember to specify the 'source' property! Without source the Javadoc task will not create any documentation. Example: 

 plugins {
     id 'java'
 }

 task myJavadocs(type: Javadoc) {
   source = sourceSets.main.allJava
 }

An example how to create a task that runs a custom doclet implementation: 

 plugins {
     id 'java'
 }

 configurations {
   jaxDoclet
 }

 dependencies {
   // jaxDoclet "some.interesting:Dependency:1.0"
 }

 task generateRestApiDocs(type: Javadoc) {
   source = sourceSets.main.allJava

   options.docletpath = configurations.jaxDoclet
   options.doclet = "com.lunatech.doclets.jax.jaxrs.JAXRSDoclet"
   options.addStringOption("jaxrscontext", "http://localhost:8080/myapp")
 }

  • Constructor Details

    • Javadoc

      public Javadoc()

  • Method Details

    • generate

      protected void generate()

    • getSource

      @PathSensitive(RELATIVE) public FileTree getSource()
      Returns the source for this task, after the include and exclude patterns have been applied. Ignores source files which do not exist.

      The PathSensitivity for the sources is configured to be PathSensitivity.ABSOLUTE. If your sources are less strict, please change it accordingly by overriding this method in your subclass.

      Overrides:
      getSource in class SourceTask
      Returns:
      The source.

    • getJavadocTool

      public abstract Property<JavadocTool> getJavadocTool()
      Configures the javadoc executable to be used to generate javadoc documentation.
      Since:
      6.7

    • getDestinationDir

      @Internal public abstract DirectoryProperty getDestinationDir()

      Returns the directory to generate the documentation into.

      Returns:
      The directory.

    • getOutputDirectory

      @OutputDirectory protected Provider<Directory> getOutputDirectory()

    • getMaxMemory

      @Internal public abstract Property<String> getMaxMemory()
      Returns the amount of memory allocated to this task.

    • getTitle

      @Optional @Input public abstract Property<String> getTitle()

      Returns the title for the generated documentation.

      Returns:
      The title, possibly null.

    • getClasspath

      @Classpath public abstract ConfigurableFileCollection getClasspath()
      Returns the classpath to use to resolve type references in the source code.
      Returns:
      The classpath.

    • getModularity

      public ModularitySpec getModularity()
      Returns the module path handling of this javadoc task.
      Since:
      6.4

    • getOptions

      public MinimalJavadocOptions getOptions()
      Returns the Javadoc generation options.
      Returns:
      The options. Never returns null.

    • options

      public void options(@DelegatesTo(MinimalJavadocOptions.class) Closure<?> block)
      Convenience method for configuring Javadoc generation options.
      Parameters:
      block - The configuration block for Javadoc generation options.

    • options

      public void options(Action<? super MinimalJavadocOptions> action)
      Convenience method for configuring Javadoc generation options.
      Parameters:
      action - The action for Javadoc generation options.
      Since:
      3.5

    • getFailOnError

      @Input public abstract Property<Boolean> getFailOnError()
      Specifies whether this task should fail when errors are encountered during Javadoc generation. When true, this task will fail on Javadoc error. When false, this task will ignore Javadoc errors.

    • getIsFailOnError

      @ReplacedBy("getFailOnError()") public Property<Boolean> getIsFailOnError()

    • getOptionsFile

      @Internal public Provider<RegularFile> getOptionsFile()

    • getExecutable

      @Optional @Input public abstract Property<String> getExecutable()
      Returns the Javadoc executable to use to generate the Javadoc. When null, the Javadoc executable for the current JVM is used or from the toolchain if configured.
      Returns:
      The executable. May be null.
      See Also:

    • getDeleter

      @Inject protected abstract org.gradle.internal.file.Deleter getDeleter()

    • getProjectLayout

      @Inject protected abstract ProjectLayout getProjectLayout()

    • getObjectFactory

      @Inject protected abstract ObjectFactory getObjectFactory()

    • getPropertyFactory

      @Inject protected abstract org.gradle.api.internal.provider.PropertyFactory getPropertyFactory()

    • getJavaModuleDetector

      @Inject protected abstract org.gradle.internal.jvm.JavaModuleDetector getJavaModuleDetector()

    • getJavaToolchainService

      @Inject protected abstract JavaToolchainService getJavaToolchainService()

    • getProviderFactory

      @Inject protected abstract ProviderFactory getProviderFactory()