org.apache.maven.tools.plugin.javadoc
Class MojoParameterFieldTaglet

java.lang.Object
  org.apache.maven.tools.plugin.javadoc.AbstractMojoTaglet
      org.apache.maven.tools.plugin.javadoc.AbstractMojoFieldTaglet
          org.apache.maven.tools.plugin.javadoc.MojoParameterFieldTaglet

All Implemented Interfaces:

com.sun.tools.doclets.Taglet

public class MojoParameterFieldTaglet
extends AbstractMojoFieldTaglet

The @parameter tag is used to define a Mojo parameter and has annotation parameter.
The following is a sample declaration:

 public class MyMojo extends AbstractMojo
 {
   /**
    * Dummy parameter.
    *
    * @parameter <alias="..."> <default-value="..."> <expression="...">
    * <implementation="..."> <property="...">
    * ...
    */
   private Object parameterName;
 }
 

To use it, calling the Javadoc tool with the following:

 javadoc ... -taglet 'org.apache.maven.tools.plugin.javadoc.MojoParameterFieldTaglet'
 

Version:

$Id: MojoParameterFieldTaglet.java 1133707 2011-06-09 08:28:59Z stephenc $

Author:

Vincent Siveton

See Also:

package-summary.html

Field Summary

protected static String

HEADER The Javadoc text which will be added to the generated page.

Constructor Summary

MojoParameterFieldTaglet()

Method Summary

String[]	getAllowedParameterNames()
String	getAllowedValue()
String	getHeader()
String	getName()
static void	register(Map<String,com.sun.tools.doclets.Taglet> tagletMap) Register this Taglet.

Methods inherited from class org.apache.maven.tools.plugin.javadoc.AbstractMojoFieldTaglet

inConstructor, inField, inMethod, inOverview, inPackage, inType, isInlineTag

Methods inherited from class org.apache.maven.tools.plugin.javadoc.AbstractMojoTaglet

hasAnnotationParameters, hasAnnotationValue, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

HEADER

protected static final String HEADER

The Javadoc text which will be added to the generated page.

See Also:

Constant Field Values

Constructor Detail

MojoParameterFieldTaglet

public MojoParameterFieldTaglet()

Method Detail

getHeader

public String getHeader()

Specified by:

getHeader in class AbstractMojoTaglet

Returns:

By default, return the string defined in HEADER.

See Also:

AbstractMojoTaglet.getHeader(), HEADER

getAllowedValue

public String getAllowedValue()

Specified by:

getAllowedValue in class AbstractMojoTaglet

Returns:

null since @parameter has no value.

See Also:

AbstractMojoTaglet.getAllowedValue()

getAllowedParameterNames

public String[] getAllowedParameterNames()

Specified by:

getAllowedParameterNames in class AbstractMojoTaglet

Returns:

MojoParameterFieldTaglet#PARAMETERS_NAME since @parameter has parameters.

See Also:

AbstractMojoTaglet.getAllowedParameterNames()

getName

public String getName()

Returns:

By default, return the name of this taglet.

See Also:

Taglet.getName(), NAME

register

public static void register(Map<String,com.sun.tools.doclets.Taglet> tagletMap)

Register this Taglet.

Parameters:

tagletMap - the map to register this tag to.