Package org.apache.maven.tools.plugin.generator

Class PluginDescriptorFilesGenerator

java.lang.Object

org.apache.maven.tools.plugin.generator.PluginDescriptorFilesGenerator

All Implemented Interfaces:

Generator

public class PluginDescriptorFilesGenerator
extends Object
implements Generator

Serializes

1. a standard Maven Plugin Descriptor XML file
2. a descriptor containing a limited set of attributes for PluginHelpGenerator
3. an enhanced descriptor containing HTML values for some elements (instead of plain text as for the other two) for
   invalid reference

   PluginXdocGenerator

from a given in-memory descriptor. The in-memory descriptor acting as source is supposed to contain XHTML values for description elements.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static enum	PluginDescriptorFilesGenerator.DescriptorType	The type of the plugin descriptor file

Field Summary

Fields

Modifier and Type	Field	Description
private static final org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor	Description
PluginDescriptorFilesGenerator()

Method Summary

Modifier and Type	Method	Description
void	execute(File destinationDirectory, PluginToolsRequest request)	Execute the generation for a given plugin descriptor.
static File	getEnhancedDescriptorFilePath(org.apache.maven.project.MavenProject project)
private String	getExpression(org.apache.maven.plugin.descriptor.Parameter parameter)	Get the expression value, eventually surrounding it with ${ }.
(package private) static URI	getJavadocUrlForType(JavadocLinkGenerator javadocLinkGenerator, String type)
private static String	getTextValue(PluginDescriptorFilesGenerator.DescriptorType type, boolean containsXhtmlValue, String text)
private String	getVersion()
protected void	processMojoDescriptor(org.apache.maven.plugin.descriptor.MojoDescriptor mojoDescriptor, org.codehaus.plexus.util.xml.XMLWriter w, PluginDescriptorFilesGenerator.DescriptorType type, JavadocLinkGenerator javadocLinkGenerator)
void	writeDescriptor(File destinationFile, PluginToolsRequest request, PluginDescriptorFilesGenerator.DescriptorType type)
protected void	writeParameterType(org.codehaus.plexus.util.xml.XMLWriter w, PluginDescriptorFilesGenerator.DescriptorType type, JavadocLinkGenerator javadocLinkGenerator, org.apache.maven.plugin.descriptor.Parameter parameter, String goal)	Writes parameter type information and potentially also the related javadoc URL.

Methods inherited from class java.lang.Object

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

Field Details

LOG

private static final org.slf4j.Logger LOG

Constructor Details

PluginDescriptorFilesGenerator

public PluginDescriptorFilesGenerator()

Method Details

execute

public void execute(File destinationDirectory,
 PluginToolsRequest request)
             throws GeneratorException

Description copied from interface: Generator

Execute the generation for a given plugin descriptor.

Specified by:

execute in interface Generator

Parameters:

destinationDirectory - required

request - required

Throws:

GeneratorException - if any

getEnhancedDescriptorFilePath

public static File getEnhancedDescriptorFilePath(org.apache.maven.project.MavenProject project)

getVersion

private String getVersion()

writeDescriptor

public void writeDescriptor(File destinationFile,
 PluginToolsRequest request,
 PluginDescriptorFilesGenerator.DescriptorType type)
                     throws IOException

Throws:

IOException

getTextValue

private static String getTextValue(PluginDescriptorFilesGenerator.DescriptorType type,
 boolean containsXhtmlValue,
 String text)

Parameters:

type -

containsXhtmlValue -

text -

Returns:

the normalized text value (i.e. potentially converted to XHTML)

processMojoDescriptor

protected void processMojoDescriptor(org.apache.maven.plugin.descriptor.MojoDescriptor mojoDescriptor,
 org.codehaus.plexus.util.xml.XMLWriter w,
 PluginDescriptorFilesGenerator.DescriptorType type,
 JavadocLinkGenerator javadocLinkGenerator)

writeParameterType

protected void writeParameterType(org.codehaus.plexus.util.xml.XMLWriter w,
 PluginDescriptorFilesGenerator.DescriptorType type,
 JavadocLinkGenerator javadocLinkGenerator,
 org.apache.maven.plugin.descriptor.Parameter parameter,
 String goal)

Writes parameter type information and potentially also the related javadoc URL.

Parameters:

w -

type -

javadocLinkGenerator -

parameter -

goal -

getJavadocUrlForType

static URI getJavadocUrlForType(JavadocLinkGenerator javadocLinkGenerator,
 String type)

getExpression

private String getExpression(org.apache.maven.plugin.descriptor.Parameter parameter)

Get the expression value, eventually surrounding it with ${ }.

Parameters:

parameter - the parameter

Returns:

the expression value