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>
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
destinationDir = reporting.file("rest-api-docs")
options.docletpath = configurations.jaxDoclet.files.asType(List)
options.doclet = "com.lunatech.doclets.jax.jaxrs.JAXRSDoclet"
options.addStringOption("jaxrscontext", "http://localhost:8080/myapp")
}
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.gradle.api.Named
Named.Namer -
Field Summary
Fields inherited from interface org.gradle.api.Task
TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected voidgenerate()Returns the classpath to use to resolve type references in the source code.protected abstract org.gradle.internal.file.Deleter@Nullable FileReturns the directory to generate the documentation into.@Nullable StringReturns the Javadoc executable to use to generate the Javadoc.Configures the javadoc executable to be used to generate javadoc documentation.protected abstract org.gradle.internal.jvm.JavaModuleDetectorprotected abstract JavaToolchainService@Nullable StringReturns the amount of memory allocated to this task.Returns the module path handling of this javadoc task.protected abstract ObjectFactoryReturns the Javadoc generation options.protected Fileprotected abstract ProjectLayoutprotected abstract org.gradle.api.internal.provider.PropertyFactoryprotected abstract ProviderFactoryReturns the source for this task, after the include and exclude patterns have been applied.@Nullable StringgetTitle()Returns the title for the generated documentation.booleanSpecifies whether this task should fail when errors are encountered during Javadoc generation.voidConvenience method for configuring Javadoc generation options.voidoptions(Action<? super MinimalJavadocOptions> action) Convenience method for configuring Javadoc generation options.voidsetClasspath(FileCollection classpath) Sets the classpath to use to resolve type references in this source code.voidsetDestinationDir(@Nullable File destinationDir) Sets the directory to generate the documentation into.voidsetExecutable(@Nullable String executable) voidsetFailOnError(boolean failOnError) voidsetMaxMemory(@Nullable String maxMemory) Sets the amount of memory allocated to this task.voidSets the title for the generated documentation.Methods inherited from class org.gradle.api.tasks.SourceTask
exclude, exclude, exclude, exclude, getExcludes, getIncludes, getPatternSet, getPatternSetFactory, include, include, include, include, setExcludes, setIncludes, setSource, setSource, sourceMethods inherited from class org.gradle.api.internal.ConventionTask
conventionMapping, conventionMapping, getConventionMappingMethods inherited from class org.gradle.api.DefaultTask
compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesServiceMethods inherited from class org.gradle.api.internal.AbstractTask
acceptServiceReferences, appendParallelSafeAction, doNotTrackState, getAsDynamicObject, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, setImpliesSubProjectsMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.gradle.api.Task
doNotTrackState, notCompatibleWithConfigurationCache
-
Constructor Details
-
Javadoc
public Javadoc()
-
-
Method Details
-
generate
protected void generate() -
getSource
Returns the source for this task, after the include and exclude patterns have been applied. Ignores source files which do not exist.The
PathSensitivityfor the sources is configured to bePathSensitivity.ABSOLUTE. If your sources are less strict, please change it accordingly by overriding this method in your subclass.- Overrides:
getSourcein classSourceTask- Returns:
- The source.
-
getJavadocTool
Configures the javadoc executable to be used to generate javadoc documentation.- Since:
- 6.7
-
getDestinationDir
Returns the directory to generate the documentation into.
- Returns:
- The directory.
-
getOutputDirectory
-
setDestinationDir
Sets the directory to generate the documentation into.
-
getMaxMemory
Returns the amount of memory allocated to this task. -
setMaxMemory
Sets the amount of memory allocated to this task.- Parameters:
maxMemory- The amount of memory
-
getTitle
Returns the title for the generated documentation.
- Returns:
- The title, possibly null.
-
setTitle
Sets the title for the generated documentation.
-
getClasspath
Returns the classpath to use to resolve type references in the source code.- Returns:
- The classpath.
-
setClasspath
Sets the classpath to use to resolve type references in this source code.- Parameters:
classpath- The classpath. Must not be null.
-
getModularity
Returns the module path handling of this javadoc task.- Since:
- 6.4
-
getOptions
Returns the Javadoc generation options.- Returns:
- The options. Never returns null.
-
options
Convenience method for configuring Javadoc generation options.- Parameters:
block- The configuration block for Javadoc generation options.
-
options
Convenience method for configuring Javadoc generation options.- Parameters:
action- The action for Javadoc generation options.- Since:
- 3.5
-
isFailOnError
Specifies whether this task should fail when errors are encountered during Javadoc generation. Whentrue, this task will fail on Javadoc error. Whenfalse, this task will ignore Javadoc errors. -
setFailOnError
public void setFailOnError(boolean failOnError) -
getOptionsFile
-
getExecutable
Returns the Javadoc executable to use to generate the Javadoc. Whennull, the Javadoc executable for the current JVM is used or from the toolchain if configured.- Returns:
- The executable. May be null.
- See Also:
-
setExecutable
-
getDeleter
@Inject protected abstract org.gradle.internal.file.Deleter getDeleter() -
getProjectLayout
-
getObjectFactory
-
getPropertyFactory
@Inject protected abstract org.gradle.api.internal.provider.PropertyFactory getPropertyFactory() -
getJavaModuleDetector
@Inject protected abstract org.gradle.internal.jvm.JavaModuleDetector getJavaModuleDetector() -
getJavaToolchainService
-
getProviderFactory
-