public class SummaryJavadocCheck extends AbstractJavadocCheck
Checks that Javadoc summary sentence does not contain phrases that are not recommended to use. By default Check validate that first sentence is not empty:
<module name="SummaryJavadocCheck"/>
To ensure that summary do not contain phrase like "This method returns" , use following config:
<module name="SummaryJavadocCheck"> <property name="forbiddenSummaryFragments" value="^This method returns.*"/> </module>
To specify period symbol at the end of first javadoc sentence - use following config:
<module name="SummaryJavadocCheck"> <property name="period" value="period"/> </module>
Constructor and Description |
---|
SummaryJavadocCheck() |
Modifier and Type | Method and Description |
---|---|
int[] |
getDefaultJavadocTokens()
Returns the default token types a check is interested in.
|
void |
setForbiddenSummaryFragments(String pattern)
Sets custom value of regular expression for forbidden summary fragments.
|
void |
setPeriod(String period)
Sets value of period symbol at the end of first javadoc sentence.
|
void |
visitJavadocToken(DetailNode ast)
Called to process a Javadoc token.
|
beginJavadocTree, beginTree, finishJavadocTree, finishTree, getAcceptableTokens, getBlockCommentAst, getDefaultTokens, getRequiredTokens, isCommentNodesRequired, leaveJavadocToken, leaveToken, visitToken
destroy, getClassLoader, getFileContents, getLine, getLines, getTabWidth, getTokenNames, init, log, log, setClassLoader, setFileContents, setMessages, setTabWidth, setTokens
getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, log, setId, setSeverity
configure, contextualize, finishLocalSetup, getConfiguration, setupChild
public SummaryJavadocCheck()
public void setForbiddenSummaryFragments(String pattern)
pattern
- user's value.public void setPeriod(String period)
period
- period's value.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–2015. All rights reserved.