org.apache.maven.plugins.site
Class AbstractSiteRenderingMojo

java.lang.Object
  org.apache.maven.plugin.AbstractMojo
      org.apache.maven.plugins.site.AbstractSiteMojo
          org.apache.maven.plugins.site.AbstractSiteRenderingMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.codehaus.plexus.personality.plexus.lifecycle.phase.Contextualizable

Direct Known Subclasses:

EffectiveSiteMojo, SiteMojo, SiteRunMojo

public abstract class AbstractSiteRenderingMojo
extends AbstractSiteMojo
implements org.codehaus.plexus.personality.plexus.lifecycle.phase.Contextualizable

Base class for site rendering mojos.

Version:

$Id: AbstractSiteRenderingMojo.java 1150948 2011-07-25 22:57:29Z hboutemy $

Author:

Brett Porter

Field Summary

protected java.io.File	generatedSiteDirectory Directory containing generated documentation.
protected org.apache.maven.execution.MavenSession	mavenSession The current Maven session.
protected java.util.List<org.apache.maven.reporting.MavenReport>	reports Reports (Maven 2).
protected org.apache.maven.doxia.siterenderer.Renderer	siteRenderer Site renderer.

Fields inherited from class org.apache.maven.plugins.site.AbstractSiteMojo

i18n, locales, localRepository, project, reactorProjects, siteDirectory, siteTool

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

AbstractSiteRenderingMojo()

Method Summary

protected java.util.Map<java.lang.String,java.util.List<org.apache.maven.reporting.MavenReport>>	categoriseReports(java.util.Collection<org.apache.maven.reporting.MavenReport> reports) Go through the collection of reports and put each report into a list for the appropriate category.
void	contextualize(org.codehaus.plexus.context.Context context)
protected org.apache.maven.doxia.siterenderer.SiteRenderingContext	createSiteRenderingContext(java.util.Locale locale)
protected java.util.List<org.apache.maven.reporting.exec.MavenReportExecution>	getReports()
protected java.util.Map<java.lang.String,org.apache.maven.doxia.siterenderer.DocumentRenderer>	locateDocuments(org.apache.maven.doxia.siterenderer.SiteRenderingContext context, java.util.List<org.apache.maven.reporting.exec.MavenReportExecution> reports, java.util.Locale locale)
protected java.util.Map<java.lang.String,org.apache.maven.reporting.MavenReport>	locateReports(java.util.List<org.apache.maven.reporting.exec.MavenReportExecution> reports, java.util.Map<java.lang.String,org.apache.maven.doxia.siterenderer.DocumentRenderer> documents, java.util.Locale locale) Go through the list of reports and process each one like this: Add the report to a map of reports keyed by filename having the report itself as value If the report is not yet in the map of documents, add it together with a suitable renderer
protected void	populateReportItems(org.apache.maven.doxia.site.decoration.DecorationModel decorationModel, java.util.Locale locale, java.util.Map<java.lang.String,org.apache.maven.reporting.MavenReport> reportsByOutputName)

Methods inherited from class org.apache.maven.plugins.site.AbstractSiteMojo

getInputEncoding, getMavenVersion, getOutputEncoding, isMaven3OrMore

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.maven.plugin.Mojo

execute

Field Detail

siteRenderer

protected org.apache.maven.doxia.siterenderer.Renderer siteRenderer

Site renderer.

reports

protected java.util.List<org.apache.maven.reporting.MavenReport> reports

Reports (Maven 2).

generatedSiteDirectory

protected java.io.File generatedSiteDirectory

Directory containing generated documentation. This is used to pick up other source docs that might have been generated at build time.

mavenSession

protected org.apache.maven.execution.MavenSession mavenSession

The current Maven session.

Constructor Detail

AbstractSiteRenderingMojo

public AbstractSiteRenderingMojo()

Method Detail

contextualize

public void contextualize(org.codehaus.plexus.context.Context context)
                   throws org.codehaus.plexus.context.ContextException

Specified by:

contextualize in interface org.codehaus.plexus.personality.plexus.lifecycle.phase.Contextualizable

Throws:

org.codehaus.plexus.context.ContextException

getReports

protected java.util.List<org.apache.maven.reporting.exec.MavenReportExecution> getReports()
                                                                                   throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

createSiteRenderingContext

protected org.apache.maven.doxia.siterenderer.SiteRenderingContext createSiteRenderingContext(java.util.Locale locale)
                                                                                       throws org.apache.maven.plugin.MojoExecutionException,
                                                                                              java.io.IOException,
                                                                                              org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

java.io.IOException

org.apache.maven.plugin.MojoFailureException

locateReports

protected java.util.Map<java.lang.String,org.apache.maven.reporting.MavenReport> locateReports(java.util.List<org.apache.maven.reporting.exec.MavenReportExecution> reports,
                                                                                               java.util.Map<java.lang.String,org.apache.maven.doxia.siterenderer.DocumentRenderer> documents,
                                                                                               java.util.Locale locale)

Go through the list of reports and process each one like this:

• Add the report to a map of reports keyed by filename having the report itself as value
• If the report is not yet in the map of documents, add it together with a suitable renderer

Parameters:

reports - A List of MavenReports

documents - A Map of documents, keyed by filename

locale - the Locale the reports are processed for.

Returns:

A map with all reports keyed by filename having the report itself as value. The map will be used to populate a menu.

categoriseReports

protected java.util.Map<java.lang.String,java.util.List<org.apache.maven.reporting.MavenReport>> categoriseReports(java.util.Collection<org.apache.maven.reporting.MavenReport> reports)

Go through the collection of reports and put each report into a list for the appropriate category. The list is put into a map keyed by the name of the category.

Parameters:

reports - A Collection of MavenReports

Returns:

A map keyed category having the report itself as value

locateDocuments

protected java.util.Map<java.lang.String,org.apache.maven.doxia.siterenderer.DocumentRenderer> locateDocuments(org.apache.maven.doxia.siterenderer.SiteRenderingContext context,
                                                                                                               java.util.List<org.apache.maven.reporting.exec.MavenReportExecution> reports,
                                                                                                               java.util.Locale locale)
                                                                                                        throws java.io.IOException,
                                                                                                               org.apache.maven.doxia.siterenderer.RendererException

Throws:

java.io.IOException

org.apache.maven.doxia.siterenderer.RendererException

populateReportItems

protected void populateReportItems(org.apache.maven.doxia.site.decoration.DecorationModel decorationModel,
                                   java.util.Locale locale,
                                   java.util.Map<java.lang.String,org.apache.maven.reporting.MavenReport> reportsByOutputName)