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 theJava Test code
in 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 SourceResolverConfig
configureDependencySourceResolution(SourceResolverConfig config)
Overridden to enable the resolution of -test-sources jar files.protected void
executeReport(Locale unusedLocale)
The package documentation details the Javadoc Options used by this Plugin.protected org.eclipse.aether.util.filter.ScopeDependencyFilter
getDependencyScopeFilter()
String
getDescription(Locale locale)
protected String
getDoctitle()
protected List<String>
getExecutionProjectSourceRoots(org.apache.maven.project.MavenProject p)
protected File
getJavadocDirectory()
String
getName(Locale locale)
String
getOutputName()
protected File
getOverview()
protected List<File>
getProjectBuildOutputDirs(org.apache.maven.project.MavenProject p)
protected List<String>
getProjectSourceRoots(org.apache.maven.project.MavenProject p)
File
getReportOutputDirectory()
protected String
getWindowtitle()
protected boolean
isTest()
Indicates whether this goal generates documentation for theJava Test code
.void
setDestDir(String destDir)
void
setReportOutputDirectory(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:AbstractJavadocMojo
The package documentation details the Javadoc Options used by this Plugin.- Overrides:
executeReport
in 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:
getName
in interfaceorg.apache.maven.reporting.MavenReport
- Overrides:
getName
in classJavadocReport
-
getDescription
public String getDescription(Locale locale)
Description copied from class:JavadocReport
- Specified by:
getDescription
in interfaceorg.apache.maven.reporting.MavenReport
- Overrides:
getDescription
in classJavadocReport
-
getOutputName
public String getOutputName()
Description copied from class:JavadocReport
- Specified by:
getOutputName
in interfaceorg.apache.maven.reporting.MavenReport
- Overrides:
getOutputName
in classJavadocReport
-
getReportOutputDirectory
public File getReportOutputDirectory()
Description copied from class:JavadocReport
- Specified by:
getReportOutputDirectory
in interfaceorg.apache.maven.reporting.MavenReport
- Overrides:
getReportOutputDirectory
in classJavadocReport
-
setReportOutputDirectory
public void setReportOutputDirectory(File reportOutputDirectory)
Method to set the directory where the generated reports will be put- Specified by:
setReportOutputDirectory
in interfaceorg.apache.maven.reporting.MavenReport
- Overrides:
setReportOutputDirectory
in classJavadocReport
- Parameters:
reportOutputDirectory
- the directory file to be set
-
setDestDir
public void setDestDir(String destDir)
- Overrides:
setDestDir
in classJavadocReport
- Parameters:
destDir
- the destination directory
-
getProjectBuildOutputDirs
protected List<File> getProjectBuildOutputDirs(org.apache.maven.project.MavenProject p)
- Overrides:
getProjectBuildOutputDirs
in 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:
getProjectSourceRoots
in 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:
getExecutionProjectSourceRoots
in 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:
getJavadocDirectory
in classAbstractJavadocMojo
- Returns:
- the current javadoc directory
-
getDoctitle
protected String getDoctitle()
- Overrides:
getDoctitle
in classAbstractJavadocMojo
- Returns:
- the title to be placed near the top of the overview summary file
-
getOverview
protected File getOverview()
- Overrides:
getOverview
in classAbstractJavadocMojo
- Returns:
- the overview documentation file from the user parameter or from the
javadocdirectory
-
getWindowtitle
protected String getWindowtitle()
- Overrides:
getWindowtitle
in classAbstractJavadocMojo
- Returns:
- the title to be placed in the HTML title tag
-
getDependencyScopeFilter
protected org.eclipse.aether.util.filter.ScopeDependencyFilter getDependencyScopeFilter()
- Overrides:
getDependencyScopeFilter
in 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:
configureDependencySourceResolution
in classAbstractJavadocMojo
- Parameters:
config
-SourceResolverConfig
- Returns:
SourceResolverConfig
-
isTest
protected boolean isTest()
Description copied from class:AbstractJavadocMojo
Indicates whether this goal generates documentation for theJava Test code
.- Overrides:
isTest
in classAbstractJavadocMojo
- Returns:
true
if the goal generates Test Javadocs,false
otherwise.
-
-