Package org.kohsuke.stapler

Class TaglibDocMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.kohsuke.stapler.TaglibDocMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.apache.maven.reporting.MavenMultiPageReport, org.apache.maven.reporting.MavenReport

@Mojo(name="jelly-taglibdoc",
      requiresDependencyResolution=COMPILE)
@Execute(phase=GENERATE_SOURCES)
public class TaglibDocMojo
extends org.apache.maven.plugin.AbstractMojo
implements org.apache.maven.reporting.MavenMultiPageReport

Scans Jelly tag libraries from tag files, and generate taglib.xml compatible with jellydoc-maven-plugin

For productive debugging of this mojo, run "mvn site:run" with debugger. Every request will trigger a whole rendering, and you can do hot-swap of byte code for changes.

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field	Description
protected org.apache.maven.project.MavenProject	project	The Maven Project Object
protected org.apache.maven.execution.MavenSession	session	The Maven session object.

Fields inherited from interface org.apache.maven.reporting.MavenReport

CATEGORY_PROJECT_INFORMATION, CATEGORY_PROJECT_REPORTS, ROLE

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

ROLE

Constructor Summary

Constructors

Constructor	Description
TaglibDocMojo()

Method Summary

Modifier and Type	Method	Description
boolean	canGenerateReport()
void	execute()
void	generate(org.apache.maven.doxia.sink.Sink sink, Locale locale)	Deprecated. use generate(Sink, SinkFactory, Locale) instead.
void	generate(org.apache.maven.doxia.sink.Sink sink, org.apache.maven.doxia.sink.SinkFactory sinkFactory, Locale locale)	This method is called when the report generation is invoked by maven-site-plugin.
void	generate(org.codehaus.doxia.sink.Sink sink, Locale locale)	Deprecated. use generate(Sink, SinkFactory, Locale) instead.
String	getCategoryName()
String	getDescription(Locale locale)
String	getName(Locale locale)
String	getOutputName()
File	getReportOutputDirectory()
boolean	isExternalReport()
void	setReportOutputDirectory(File outputDirectory)

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

Field Details

project

@Parameter(defaultValue="${project}",
           required=true,
           readonly=true)
protected org.apache.maven.project.MavenProject project

The Maven Project Object

session

@Parameter(defaultValue="${session}",
           required=true,
           readonly=true)
protected org.apache.maven.execution.MavenSession session

The Maven session object.

Constructor Details

TaglibDocMojo

public TaglibDocMojo()

Method Details

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException

Specified by:

execute in interface org.apache.maven.plugin.Mojo

Throws:

org.apache.maven.plugin.MojoExecutionException

generate

@Deprecated
public void generate(org.codehaus.doxia.sink.Sink sink,
 Locale locale)
              throws org.apache.maven.reporting.MavenReportException

Deprecated.

use generate(Sink, SinkFactory, Locale) instead.

Generate a report.

Specified by:

generate in interface org.apache.maven.reporting.MavenReport

Parameters:

sink - The sink to use for the generation.

locale - The desired locale in which to generate the report; could be null.

Throws:

org.apache.maven.reporting.MavenReportException - if any error occurs

generate

@Deprecated
public void generate(org.apache.maven.doxia.sink.Sink sink,
 Locale locale)
              throws org.apache.maven.reporting.MavenReportException

Deprecated.

use generate(Sink, SinkFactory, Locale) instead.

Generate a report.

Parameters:

sink - The sink to use for the generation.

locale - The desired locale in which to generate the report; could be null.

Throws:

org.apache.maven.reporting.MavenReportException - if any error occurs

generate

public void generate(org.apache.maven.doxia.sink.Sink sink,
 org.apache.maven.doxia.sink.SinkFactory sinkFactory,
 Locale locale)
              throws org.apache.maven.reporting.MavenReportException

This method is called when the report generation is invoked by maven-site-plugin.

Specified by:

generate in interface org.apache.maven.reporting.MavenMultiPageReport

Parameters:

sink - The sink to use for the generation.

sinkFactory - The sink factory to use for the generation; could be null.

locale - The desired locale in which to generate the report; could be null.

Throws:

org.apache.maven.reporting.MavenReportException - if any error occurs

getOutputName

public String getOutputName()

Specified by:

getOutputName in interface org.apache.maven.reporting.MavenReport

getName

public String getName(Locale locale)

Specified by:

getName in interface org.apache.maven.reporting.MavenReport

getCategoryName

public String getCategoryName()

Specified by:

getCategoryName in interface org.apache.maven.reporting.MavenReport

getDescription

public String getDescription(Locale locale)

Specified by:

getDescription in interface org.apache.maven.reporting.MavenReport

setReportOutputDirectory

public void setReportOutputDirectory(File outputDirectory)

Specified by:

setReportOutputDirectory in interface org.apache.maven.reporting.MavenReport

getReportOutputDirectory

public File getReportOutputDirectory()

Specified by:

getReportOutputDirectory in interface org.apache.maven.reporting.MavenReport

isExternalReport

public boolean isExternalReport()

Specified by:

isExternalReport in interface org.apache.maven.reporting.MavenReport

canGenerateReport

public boolean canGenerateReport()

Specified by:

canGenerateReport in interface org.apache.maven.reporting.MavenReport