Class Javadoc

java.lang.Object

org.jdrupes.builder.core.AbstractProvider

org.jdrupes.builder.core.AbstractGenerator

org.jdrupes.builder.java.JavaTool

org.jdrupes.builder.java.Javadoc

All Implemented Interfaces:

Generator, ResourceProvider

public class Javadoc
extends JavaTool

The Javadoc generator provides the resource JavadocDirectory, a directory that contains generated javadoc files.

No attempt has been made to define types for the options of the javadoc tool. Rather, the options are passed as strings as the ToolProvider API suggests. There are some noteworthy exceptions for options that are directly related to resource types (files, directory trees, paths) from the builder context.

By default, the generator builds the javadoc for the project passed to the constructor. In some cases, e.g. when building a common javadoc for multiple projects, this is not the desired behavior. In this case, the project(s) to generate javadoc can be set with projects.

The sources processed default to the project's JavaSourceFiles, i.e. the resources obtained by invoking get(new ResourceRequest<FileTree<JavaSourceFile>>(new ResourceType<>() {})) on the project(s). This can be overridden by setting the sources with one or several invocations of the addSources-methods.

Field Summary

Fields inherited from class AbstractProvider

log

Constructor Summary

Constructors

Constructor	Description
Javadoc(Project project)	Instantiates a new java compiler.

Method Summary

Modifier and Type	Method	Description
final Javadoc	addSources(Path directory, String pattern)	Adds the files from the given directory matching the given pattern.
final Javadoc	addSources(Stream<FileTree<JavaSourceFile>> sources)	Adds the sources.
final Javadoc	addSources(FileTree<JavaSourceFile>... sources)	Adds the source tree.
Path	destination()	Returns the destination directory.
Javadoc	destination(Path destination)	Sets the destination directory.
protected <T extends Resource> Stream<T>	doProvide(ResourceRequest<T> requested)	Invoked by AbstractProvider.provide(ResourceRequest) after checking if the invocation is allowed.
Javadoc	projects(Stream<Project> projects)	Sets the projects to generate javadoc for.
Javadoc	tagletpath(Stream<ClasspathElement> classpathElements)	Adds the given elements to the taglepath.
Javadoc	taglets(Stream<String> taglets)	Adds the given taglets.

Methods inherited from class JavaTool

logDiagnostic, logDiagnostics, optionArgument, options, options, options

Methods inherited from class AbstractGenerator

cleanup, name, name, newResource, project, toString

Methods inherited from class AbstractProvider

provide

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ResourceProvider

provide

Constructor Details

Javadoc

public Javadoc(Project project)

Instantiates a new java compiler.

Parameters:

project - the project

Method Details

projects

public Javadoc projects(Stream<Project> projects)

Sets the projects to generate javadoc for.

Parameters:

projects - the projects

Returns:

the javadoc

destination

public Path destination()

Returns the destination directory. Defaults to "doc".

Returns:

the destination

destination

public Javadoc destination(Path destination)

Sets the destination directory. The Path is resolved against the project's build directory (see Project.buildDirectory()).

Parameters:

destination - the new destination

Returns:

the java compiler

addSources

@SafeVarargs
public final Javadoc addSources(FileTree<JavaSourceFile>... sources)

Adds the source tree.

Parameters:

sources - the sources

Returns:

the java compiler

addSources

public final Javadoc addSources(Path directory,
 String pattern)

Adds the files from the given directory matching the given pattern. Short for addSources(project().newFileTree(directory, pattern, JavaSourceFile.class)).

Parameters:

directory - the directory

pattern - the pattern

Returns:

the resources collector

addSources

public final Javadoc addSources(Stream<FileTree<JavaSourceFile>> sources)

Adds the sources.

Parameters:

sources - the sources

Returns:

the java compiler

tagletpath

public Javadoc tagletpath(Stream<ClasspathElement> classpathElements)

Adds the given elements to the taglepath.

Parameters:

classpathElements - the classpath elements

Returns:

the javadoc

taglets

public Javadoc taglets(Stream<String> taglets)

Adds the given taglets.

Parameters:

taglets - the taglets

Returns:

the javadoc

doProvide

protected <T extends Resource> Stream<T> doProvide(ResourceRequest<T> requested)

Description copied from class: AbstractProvider

Invoked by AbstractProvider.provide(ResourceRequest) after checking if the invocation is allowed.

Specified by:

doProvide in class AbstractProvider

Type Parameters:

T - the generic type

Parameters:

requested - the requested

Returns:

the stream