public class NonEmptyAtclauseDescriptionCheck extends AbstractJavadocCheck
Checks that the at-clause tag is followed by description.
violateExecutionOnNonTightHtml
- Control when to print violations
if the Javadoc being examined by this check violates the tight html rules defined at
Tight-HTML Rules.
Type is boolean
.
Default value is false
.
javadocTokens
- javadoc tokens to check
Type is int[]
.
Default value is
PARAM_LITERAL,
RETURN_LITERAL,
THROWS_LITERAL,
EXCEPTION_LITERAL,
DEPRECATED_LITERAL.
Default configuration that will check @param
, @return
,
@throws
, @deprecated
:
<module name="NonEmptyAtclauseDescription"/>
To configure the check to validate only @param
and @return
tags:
<module name="NonEmptyAtclauseDescription"> <property name="javadocTokens" value="PARAM_LITERAL,RETURN_LITERAL"/> </module>
Parent is com.puppycrawl.tools.checkstyle.TreeWalker
Violation Message Keys:
javadoc.missed.html.close
javadoc.parse.rule.error
javadoc.wrong.singleton.html.tag
non.empty.atclause
AutomaticBean.OutputStreamOptions
Modifier and Type | Field and Description |
---|---|
static String |
MSG_KEY
A key is pointing to the warning message text in "messages.properties"
file.
|
MSG_JAVADOC_MISSED_HTML_CLOSE, MSG_JAVADOC_PARSE_RULE_ERROR, MSG_JAVADOC_WRONG_SINGLETON_TAG
Constructor and Description |
---|
NonEmptyAtclauseDescriptionCheck() |
Modifier and Type | Method and Description |
---|---|
int[] |
getDefaultJavadocTokens()
Returns the default javadoc token types a check is interested in.
|
void |
visitJavadocToken(DetailNode ast)
Called to process a Javadoc token.
|
acceptJavadocWithNonTightHtml, beginJavadocTree, beginTree, destroy, finishJavadocTree, finishTree, getAcceptableJavadocTokens, getAcceptableTokens, getBlockCommentAst, getDefaultTokens, getRequiredJavadocTokens, getRequiredTokens, init, isCommentNodesRequired, leaveJavadocToken, setJavadocTokens, setViolateExecutionOnNonTightHtml, visitToken
clearMessages, getFileContents, getLine, getLines, getMessages, getTabWidth, getTokenNames, leaveToken, log, log, log, setFileContents, setTabWidth, setTokens
finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverity
configure, contextualize, getConfiguration, setupChild
public static final String MSG_KEY
public NonEmptyAtclauseDescriptionCheck()
public int[] getDefaultJavadocTokens()
AbstractJavadocCheck
getDefaultJavadocTokens
in class AbstractJavadocCheck
JavadocTokenTypes
public void visitJavadocToken(DetailNode ast)
AbstractJavadocCheck
visitJavadocToken
in class AbstractJavadocCheck
ast
- the token to processCopyright © 2001–2020. All rights reserved.