com.puppycrawl.tools.checkstyle.checks.javadoc

Class WriteTagCheck

public class WriteTagCheck extends Check

Outputs a JavaDoc tag as information. Can be used e.g. with the stylesheets that sort the report by author name. To define the format for a tag, set property tagFormat to a regular expression. This check uses two different severity levels. The normal one is used for reporting when the tag is missing. The additional one (tagSeverity) is used for the level of reporting when the tag exists. The default value for tagSeverity is info.

An example of how to configure the check for printing author name is:

 <module name="WriteTag">
    <property name="tag" value="@author"/>
    <property name="tagFormat" value="\S"/>
 </module>
 

An example of how to configure the check to print warnings if an "@incomplete" tag is found, and not print anything if it is not found:

 <module name="WriteTag">
    <property name="tag" value="@incomplete"/>
    <property name="tagFormat" value="\S"/>
    <property name="severity" value="ignore"/>
    <property name="tagSeverity" value="warning"/>
 </module>
 

Version: 1.0

Author: Daniel Grenner

Method Summary
int[]getAcceptableTokens()
int[]getDefaultTokens()
protected voidlogTag(int aLine, String aTag, String aTagValue)
Log a message.
voidsetTag(String aTag)
Sets the tag to check.
voidsetTagFormat(String aFormat)
Set the tag format.
voidsetTagSeverity(String aSeverity)
Sets the tag severity level.
voidvisitToken(DetailAST aAST)

Method Detail

getAcceptableTokens

public int[] getAcceptableTokens()
{@inheritDoc }

getDefaultTokens

public int[] getDefaultTokens()
{@inheritDoc }

logTag

protected final void logTag(int aLine, String aTag, String aTagValue)
Log a message.

Parameters: aLine the line number where the error was found aTag the javdoc tag to be logged aTagValue the contents of the tag

See Also: java.text.MessageFormat

setTag

public void setTag(String aTag)
Sets the tag to check.

Parameters: aTag tag to check

Throws: ConversionException If the tag is not a valid regular exception.

setTagFormat

public void setTagFormat(String aFormat)
Set the tag format.

Parameters: aFormat a String value

Throws: ConversionException unable to parse aFormat

setTagSeverity

public final void setTagSeverity(String aSeverity)
Sets the tag severity level. The string should be one of the names defined in the SeverityLevel class.

Parameters: aSeverity The new severity level

See Also: SeverityLevel

visitToken

public void visitToken(DetailAST aAST)
{@inheritDoc }