Class SeparatorWrapCheck
java.lang.Object
com.puppycrawl.tools.checkstyle.api.AutomaticBean
com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter
com.puppycrawl.tools.checkstyle.api.AbstractCheck
com.puppycrawl.tools.checkstyle.checks.whitespace.SeparatorWrapCheck
- All Implemented Interfaces:
Configurable,Contextualizable
Checks line wrapping with separators.
-
Property
option- Specify policy on how to wrap lines. Type iscom.puppycrawl.tools.checkstyle.checks.whitespace.WrapOption. Default value iseol. -
Property
tokens- tokens to check Type isjava.lang.String[]. Validation type istokenSet. Default value is: DOT, COMMA.
To configure the check:
<module name="SeparatorWrap"/>
Example:
import java.io.
IOException; // OK
class Test {
String s;
public void foo(int a,
int b) { // OK
}
public void bar(int p
, int q) { // violation, separator comma on new line
if (s
.isEmpty()) { // violation, separator dot on new line
}
}
}
To configure the check for METHOD_REF at new line:
<module name="SeparatorWrap"> <property name="tokens" value="METHOD_REF"/> <property name="option" value="nl"/> </module>
Example:
import java.util.Arrays;
class Test2 {
String[] stringArray = {"foo", "bar"};
void fun() {
Arrays.sort(stringArray, String::
compareToIgnoreCase); // violation, separator method reference on same line
Arrays.sort(stringArray, String
::compareTo); // OK
}
}
To configure the check for comma at the new line:
<module name="SeparatorWrap"> <property name="tokens" value="COMMA"/> <property name="option" value="nl"/> </module>
Example:
class Test3 {
String s;
int a,
b; // violation, separator comma on same line
public void foo(int a,
int b) { // violation, separator comma on the same line
int r
, t; // OK
}
public void bar(int p
, int q) { // OK
}
}
Parent is com.puppycrawl.tools.checkstyle.TreeWalker
Violation Message Keys:
-
line.new -
line.previous
- Since:
- 5.8
-
Nested Class Summary
Nested classes/interfaces inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean
AutomaticBean.OutputStreamOptions -
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionint[]The configurable token set.int[]Returns the default token a check is interested in.int[]The tokens that this check must be registered for.voidSetter to specify policy on how to wrap lines.voidvisitToken(DetailAST ast) Called to process a token.Methods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractCheck
beginTree, clearMessages, destroy, finishTree, getFileContents, getLine, getLines, getMessages, getTabWidth, getTokenNames, init, isCommentNodesRequired, leaveToken, log, log, log, setFileContents, setTabWidth, setTokensMethods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter
finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverityMethods inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean
configure, contextualize, getConfiguration, setupChild
-
Field Details
-
MSG_LINE_PREVIOUS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
MSG_LINE_NEW
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
-
Constructor Details
-
SeparatorWrapCheck
public SeparatorWrapCheck()
-
-
Method Details
-
setOption
Setter to specify policy on how to wrap lines.- Parameters:
optionStr- string to decode option from- Throws:
IllegalArgumentException- if unable to decode
-
getDefaultTokens
public int[] getDefaultTokens()Description copied from class:AbstractCheckReturns the default token a check is interested in. Only used if the configuration for a check does not define the tokens.- Specified by:
getDefaultTokensin classAbstractCheck- Returns:
- the default tokens
- See Also:
-
getAcceptableTokens
public int[] getAcceptableTokens()Description copied from class:AbstractCheckThe configurable token set. Used to protect Checks against malicious users who specify an unacceptable token set in the configuration file. The default implementation returns the check's default tokens.- Specified by:
getAcceptableTokensin classAbstractCheck- Returns:
- the token set this check is designed for.
- See Also:
-
getRequiredTokens
public int[] getRequiredTokens()Description copied from class:AbstractCheckThe tokens that this check must be registered for.- Specified by:
getRequiredTokensin classAbstractCheck- Returns:
- the token set this must be registered for.
- See Also:
-
visitToken
Description copied from class:AbstractCheckCalled to process a token.- Overrides:
visitTokenin classAbstractCheck- Parameters:
ast- the token to process
-