Package org.apache.maven.plugins.javadoc
Class TestJavadocReport
java.lang.Object
org.apache.maven.plugin.AbstractMojo
org.apache.maven.plugins.javadoc.AbstractJavadocMojo
org.apache.maven.plugins.javadoc.JavadocReport
org.apache.maven.plugins.javadoc.TestJavadocReport
- All Implemented Interfaces:
org.apache.maven.plugin.ContextEnabled,org.apache.maven.plugin.Mojo,org.apache.maven.reporting.MavenMultiPageReport,org.apache.maven.reporting.MavenReport
- Direct Known Subclasses:
AggregatorTestJavadocReport,TestJavadocNoForkReport
@Mojo(name="test-javadoc",
requiresDependencyResolution=TEST,
threadSafe=true)
@Execute(phase=GENERATE_TEST_SOURCES)
public class TestJavadocReport
extends JavadocReport
Generates documentation for the
Java Test code in an NON aggregator project using the standard
Javadoc Tool.- Since:
- 2.3
- Author:
- Vincent Siveton
- See Also:
-
Field Summary
Fields inherited from class org.apache.maven.plugins.javadoc.AbstractJavadocMojo
ARGFILE_FILE_NAME, DEBUG_JAVADOC_SCRIPT_NAME, failOnError, failOnWarnings, FILES_FILE_NAME, JAVADOC_RESOURCES_ATTACHMENT_CLASSIFIER, links, OPTIONS_FILE_NAME, outputDirectory, outputTimestamp, PACKAGES_FILE_NAME, project, session, skip, TEST_JAVADOC_RESOURCES_ATTACHMENT_CLASSIFIER, useStandardDocletOptionsFields inherited from interface org.apache.maven.reporting.MavenReport
CATEGORY_PROJECT_INFORMATION, CATEGORY_PROJECT_REPORTS, ROLEFields inherited from interface org.apache.maven.plugin.Mojo
ROLE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected SourceResolverConfigOverridden to enable the resolution of -test-sources jar files.protected voidexecuteReport(Locale unusedLocale) The package documentation details the Javadoc Options used by this Plugin.protected org.eclipse.aether.util.filter.ScopeDependencyFiltergetDescription(Locale locale) protected StringgetExecutionProjectSourceRoots(org.apache.maven.project.MavenProject p) protected Fileprotected FilegetProjectBuildOutputDirs(org.apache.maven.project.MavenProject p) getProjectSourceRoots(org.apache.maven.project.MavenProject p) protected Stringprotected booleanisTest()Indicates whether this goal generates documentation for theJava Test code.voidsetDestDir(String destDir) voidsetReportOutputDirectory(File reportOutputDirectory) Method to set the directory where the generated reports will be putMethods inherited from class org.apache.maven.plugins.javadoc.JavadocReport
canGenerateReport, doExecute, generate, generate, generate, getCategoryName, isExternalReportMethods inherited from class org.apache.maven.plugins.javadoc.AbstractJavadocMojo
buildJavadocOptions, canGenerateReport, execute, failOnError, getAttachmentClassifier, getClassesFile, getDefaultJavadocApiLink, getDependencySourcePaths, getDoclint, getFiles, getJavadocOptionsFile, getOutputDirectory, getProject, getSourcePaths, getToolchain, isAggregator, isSkippedJavadoc, isSkippedModule, isValidJavadocLink, logError, resolveDependency, verifyRemovedParameterMethods inherited from class org.apache.maven.plugin.AbstractMojo
getLog, getPluginContext, setLog, setPluginContext
-
Constructor Details
-
TestJavadocReport
public TestJavadocReport()
-
-
Method Details
-
executeReport
protected void executeReport(Locale unusedLocale) throws org.apache.maven.reporting.MavenReportException Description copied from class:AbstractJavadocMojoThe package documentation details the Javadoc Options used by this Plugin.- Overrides:
executeReportin classAbstractJavadocMojo- Parameters:
unusedLocale- the wanted locale (actually unused).- Throws:
org.apache.maven.reporting.MavenReportException- if any
-
getName
Description copied from class:JavadocReport- Specified by:
getNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getNamein classJavadocReport
-
getDescription
Description copied from class:JavadocReport- Specified by:
getDescriptionin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getDescriptionin classJavadocReport
-
getOutputName
Description copied from class:JavadocReport- Specified by:
getOutputNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getOutputNamein classJavadocReport
-
getReportOutputDirectory
Description copied from class:JavadocReport- Specified by:
getReportOutputDirectoryin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getReportOutputDirectoryin classJavadocReport
-
setReportOutputDirectory
Method to set the directory where the generated reports will be put- Specified by:
setReportOutputDirectoryin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
setReportOutputDirectoryin classJavadocReport- Parameters:
reportOutputDirectory- the directory file to be set
-
setDestDir
- Overrides:
setDestDirin classJavadocReport- Parameters:
destDir- The destination directory.
-
getProjectBuildOutputDirs
- Overrides:
getProjectBuildOutputDirsin classAbstractJavadocMojo- Parameters:
p- not null maven project- Returns:
- the list of directories where compiled classes are placed for the given project. These dirs are added to the javadoc classpath.
-
getProjectSourceRoots
- Overrides:
getProjectSourceRootsin classAbstractJavadocMojo- Parameters:
p- not null maven project- Returns:
- the list of source paths for the given project
-
getExecutionProjectSourceRoots
- Overrides:
getExecutionProjectSourceRootsin classAbstractJavadocMojo- Parameters:
p- not null maven project- Returns:
- the list of source paths for the execution project of the given project
-
getJavadocDirectory
- Overrides:
getJavadocDirectoryin classAbstractJavadocMojo- Returns:
- the current javadoc directory
-
getDoctitle
- Overrides:
getDoctitlein classAbstractJavadocMojo- Returns:
- the title to be placed near the top of the overview summary file
-
getOverview
- Overrides:
getOverviewin classAbstractJavadocMojo- Returns:
- the overview documentation file from the user parameter or from the
javadocdirectory
-
getWindowtitle
- Overrides:
getWindowtitlein classAbstractJavadocMojo- Returns:
- the title to be placed in the HTML title tag
-
getDependencyScopeFilter
protected org.eclipse.aether.util.filter.ScopeDependencyFilter getDependencyScopeFilter()- Overrides:
getDependencyScopeFilterin classAbstractJavadocMojo
-
configureDependencySourceResolution
Overridden to enable the resolution of -test-sources jar files. Override this method to customize the configuration for resolving dependency sources. The default behavior enables the resolution of -sources jar files.- Overrides:
configureDependencySourceResolutionin classAbstractJavadocMojo- Parameters:
config-SourceResolverConfig- Returns:
SourceResolverConfig
-
isTest
protected boolean isTest()Description copied from class:AbstractJavadocMojoIndicates whether this goal generates documentation for theJava Test code.- Overrides:
isTestin classAbstractJavadocMojo- Returns:
trueif the goal generates Test Javadocs,falseotherwise.
-