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.MavenReport
- Direct Known Subclasses:
AggregatorTestJavadocReport,TestJavadocNoForkReport
@Mojo(name="test-javadoc", requiresDependencyResolution=TEST, threadSafe=true) @Execute(phase=GENERATE_TEST_SOURCES) public class TestJavadocReport extends JavadocReportGenerates documentation for theJava Test codein an NON aggregator project using the standard Javadoc Tool.- Since:
- 2.3
- Version:
- $Id: TestJavadocReport.java 1747985 2016-06-12 12:04:55Z rfscholte $
- Author:
- Vincent Siveton
- See Also:
- Javadoc Tool, Javadoc Options
-
-
Field Summary
-
Fields inherited from class org.apache.maven.plugins.javadoc.AbstractJavadocMojo
ARGFILE_FILE_NAME, DEBUG_JAVADOC_SCRIPT_NAME, DEFAULT_JAVA_API_LINKS, failOnError, failOnWarnings, FILES_FILE_NAME, JAVADOC_RESOURCES_ATTACHMENT_CLASSIFIER, links, OPTIONS_FILE_NAME, outputDirectory, PACKAGES_FILE_NAME, project, session, skip, TEST_JAVADOC_RESOURCES_ATTACHMENT_CLASSIFIER, useStandardDocletOptions
-
-
Constructor Summary
Constructors Constructor Description TestJavadocReport()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected SourceResolverConfigconfigureDependencySourceResolution(SourceResolverConfig config)Overridden to enable the resolution of -test-sources jar files.protected voidexecuteReport(java.util.Locale unusedLocale)The package documentation details the Javadoc Options used by this Plugin.protected org.apache.maven.shared.artifact.filter.resolve.ScopeFiltergetDependencyScopeFilter()java.lang.StringgetDescription(java.util.Locale locale)protected java.lang.StringgetDoctitle()protected java.util.List<java.lang.String>getExecutionProjectSourceRoots(org.apache.maven.project.MavenProject p)protected java.io.FilegetJavadocDirectory()java.lang.StringgetName(java.util.Locale locale)java.lang.StringgetOutputName()protected java.io.FilegetOverview()protected java.util.List<java.io.File>getProjectBuildOutputDirs(org.apache.maven.project.MavenProject p)protected java.util.List<java.lang.String>getProjectSourceRoots(org.apache.maven.project.MavenProject p)java.io.FilegetReportOutputDirectory()protected java.lang.StringgetWindowtitle()protected booleanisTest()Indicates whether this goal generates documentation for theJava Test code.voidsetDestDir(java.lang.String destDir)voidsetReportOutputDirectory(java.io.File reportOutputDirectory)Method to set the directory where the generated reports will be put-
Methods inherited from class org.apache.maven.plugins.javadoc.JavadocReport
canGenerateReport, doExecute, generate, getCategoryName, isExternalReport
-
Methods inherited from class org.apache.maven.plugins.javadoc.AbstractJavadocMojo
buildJavadocOptions, canGenerateReport, collect, execute, failOnError, getAttachmentClassifier, getDependencySourcePaths, getDoclint, getFiles, getJavadocOptionsFile, getOutputDirectory, getProject, getSourcePaths, getToolchain, isAggregator, isValidJavadocLink, logError, resolveDependency, verifyRemovedParameter
-
-
-
-
Method Detail
-
executeReport
protected void executeReport(java.util.Locale unusedLocale) throws org.apache.maven.reporting.MavenReportExceptionDescription 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
public java.lang.String getName(java.util.Locale locale)
Description copied from class:JavadocReport- Specified by:
getNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getNamein classJavadocReport
-
getDescription
public java.lang.String getDescription(java.util.Locale locale)
Description copied from class:JavadocReport- Specified by:
getDescriptionin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getDescriptionin classJavadocReport
-
getOutputName
public java.lang.String getOutputName()
Description copied from class:JavadocReport- Specified by:
getOutputNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getOutputNamein classJavadocReport
-
getReportOutputDirectory
public java.io.File getReportOutputDirectory()
Description copied from class:JavadocReport- Specified by:
getReportOutputDirectoryin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getReportOutputDirectoryin classJavadocReport
-
setReportOutputDirectory
public void setReportOutputDirectory(java.io.File reportOutputDirectory)
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
public void setDestDir(java.lang.String destDir)
- Overrides:
setDestDirin classJavadocReport- Parameters:
destDir- The destiation directory.
-
getProjectBuildOutputDirs
protected java.util.List<java.io.File> getProjectBuildOutputDirs(org.apache.maven.project.MavenProject p)
- 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 in the javadoc classpath.
-
getProjectSourceRoots
protected java.util.List<java.lang.String> getProjectSourceRoots(org.apache.maven.project.MavenProject p)
- Overrides:
getProjectSourceRootsin classAbstractJavadocMojo- Parameters:
p- not null maven project- Returns:
- the list of source paths for the given project
-
getExecutionProjectSourceRoots
protected java.util.List<java.lang.String> getExecutionProjectSourceRoots(org.apache.maven.project.MavenProject p)
- Overrides:
getExecutionProjectSourceRootsin classAbstractJavadocMojo- Parameters:
p- not null maven project- Returns:
- the list of source paths for the execution project of the given project
-
getJavadocDirectory
protected java.io.File getJavadocDirectory()
- Overrides:
getJavadocDirectoryin classAbstractJavadocMojo- Returns:
- the current javadoc directory
-
getDoctitle
protected java.lang.String getDoctitle()
- Overrides:
getDoctitlein classAbstractJavadocMojo- Returns:
- the title to be placed near the top of the overview summary file
-
getOverview
protected java.io.File getOverview()
- Overrides:
getOverviewin classAbstractJavadocMojo- Returns:
- the overview documentation file from the user parameter or from the
javadocdirectory
-
getWindowtitle
protected java.lang.String getWindowtitle()
- Overrides:
getWindowtitlein classAbstractJavadocMojo- Returns:
- the title to be placed in the HTML title tag
-
getDependencyScopeFilter
protected org.apache.maven.shared.artifact.filter.resolve.ScopeFilter getDependencyScopeFilter()
- Overrides:
getDependencyScopeFilterin classAbstractJavadocMojo
-
configureDependencySourceResolution
protected SourceResolverConfig configureDependencySourceResolution(SourceResolverConfig config)
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.
-
-