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

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

All Implemented Interfaces:

com.sun.tools.doclets.Taglet

public class MojoComponentFieldTaglet
extends AbstractMojoFieldTaglet

The @parameter tag is used to populate Plexus component and has annotation parameters.
The following is a sample declaration:

 public class MyMojo extends AbstractMojo
 {
   /**
    * Dummy parameter.
    *
    * @component <role="..."> <roleHint="...">
    * ...
    */
   private Object parameterName;
 }
 

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

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

Version:

$Id: MojoComponentFieldTaglet.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

MojoComponentFieldTaglet()

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

MojoComponentFieldTaglet

public MojoComponentFieldTaglet()

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 @component has no value.

See Also:

AbstractMojoTaglet.getAllowedValue()

getAllowedParameterNames

public String[] getAllowedParameterNames()

Specified by:

getAllowedParameterNames in class AbstractMojoTaglet

Returns:

MojoComponentFieldTaglet#COMPONENTS_NAME since @component 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.