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 JavadocReportGenerates documentation for theJava Test codein an NON aggregator project using the standard Javadoc Tool.- Since:
- 2.3
- Author:
- Vincent Siveton
- See Also:
- Javadoc Tool
-
-
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, mojoExecution, OPTIONS_FILE_NAME, outputDirectory, outputTimestamp, PACKAGES_FILE_NAME, project, reactorProjects, 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(Locale unusedLocale)The package documentation details the Javadoc Options used by this Plugin.protected org.eclipse.aether.util.filter.ScopeDependencyFiltergetDependencyScopeFilter()StringgetDescription(Locale locale)protected StringgetDoctitle()protected List<String>getExecutionProjectSourceRoots(org.apache.maven.project.MavenProject p)protected FilegetJavadocDirectory()StringgetName(Locale locale)StringgetOutputName()protected FilegetOverview()protected List<File>getProjectBuildOutputDirs(org.apache.maven.project.MavenProject p)protected List<String>getProjectSourceRoots(org.apache.maven.project.MavenProject p)FilegetReportOutputDirectory()protected StringgetWindowtitle()protected 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 put-
Methods inherited from class org.apache.maven.plugins.javadoc.JavadocReport
canGenerateReport, doExecute, generate, generate, generate, getCategoryName, isExternalReport
-
Methods inherited from class org.apache.maven.plugins.javadoc.AbstractJavadocMojo
buildJavadocOptions, canGenerateReport, execute, failOnError, getAttachmentClassifier, getClassesFile, getDefaultJavadocApiLink, getDependencySourcePaths, getDoclint, getFiles, getJavadocOptionsFile, getOutputDirectory, getProject, getReactorProjects, getSourcePaths, getToolchain, isAggregator, isSkippedJavadoc, isSkippedModule, isValidJavadocLink, logError, resolveDependency, verifyRemovedParameter
-
-
-
-
Method Detail
-
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
public String getName(Locale locale)
Description copied from class:JavadocReport- Specified by:
getNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getNamein classJavadocReport
-
getDescription
public String getDescription(Locale locale)
Description copied from class:JavadocReport- Specified by:
getDescriptionin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getDescriptionin classJavadocReport
-
getOutputName
public String getOutputName()
Description copied from class:JavadocReport- Specified by:
getOutputNamein interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getOutputNamein classJavadocReport
-
getReportOutputDirectory
public File getReportOutputDirectory()
Description copied from class:JavadocReport- Specified by:
getReportOutputDirectoryin interfaceorg.apache.maven.reporting.MavenReport- Overrides:
getReportOutputDirectoryin classJavadocReport
-
setReportOutputDirectory
public void setReportOutputDirectory(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(String destDir)
- Overrides:
setDestDirin classJavadocReport- Parameters:
destDir- the destination directory
-
getProjectBuildOutputDirs
protected List<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 to the javadoc classpath.
-
getProjectSourceRoots
protected List<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 List<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 File getJavadocDirectory()
- Overrides:
getJavadocDirectoryin classAbstractJavadocMojo- Returns:
- the current javadoc directory
-
getDoctitle
protected String getDoctitle()
- Overrides:
getDoctitlein classAbstractJavadocMojo- Returns:
- the title to be placed near the top of the overview summary file
-
getOverview
protected File getOverview()
- Overrides:
getOverviewin classAbstractJavadocMojo- Returns:
- the overview documentation file from the user parameter or from the
javadocdirectory
-
getWindowtitle
protected String 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
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.
-
-