|
Groovy Documentation | |||||||
FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | PROPERTY | CONSTR | METHOD | DETAIL: FIELD | PROPERTY | CONSTR | METHOD |
java.lang.Objectorg.codenarc.rule.AbstractRule
org.codenarc.rule.AbstractAstVisitorRule
org.codenarc.rule.generic.StatelessClassRule
class StatelessClassRule extends AbstractAstVisitorRule
Rule that checks for non-final
fields on a class. The intent of this rule is
to check a configured set of classes that should remain "stateless" and reentrant. One
example might be Grails service classes, which are, by default, a singleton, and so they
should be reentrant.
final
fields (either instance or static). Fields that are
static
and non-final
, however, do cause a violation.
You can configure this rule to ignore certain fields either by name or by type. This can be
useful to ignore fields that hold references to (static) dependencies (such as DAOs or
Service objects) or static configuration.
The ignoreFieldNames
property specifies one or more (comma-separated) field names
that should be ignored (i.e., that should not cause a rule violation). The name(s) may optionally
include wildcard characters ('*' or '?'). You can add to the field names to be ignored by setting
the (write-only) addIgnoreFieldNames
property. This is a "special" property -- each
call to setAddIgnoreFieldNames()
adds to the existing ignoreFieldNames
property value.
The ignoreFieldTypes
property specifies one or more (comma-separated) field type names
that should be ignored (i.e., that should not cause a rule violation). The type name(s) may optionally
include wildcard characters ('*' or '?').
Note: The ignoreFieldTypes
property matches the field type name as indicated
in the field declaration, only including a full package specification IF it is included in
the source code. For example, the field declaration BigDecimal value
matches
an ignoreFieldTypes
value of BigDecimal
, but not
java.lang.BigDecimal
.
There is one exception for the ignoreFieldTypes
property: if the field is declared
with a modifier/type of def
, then the type resolves to java.lang.Object
.
Property Summary | |
---|---|
Class |
astVisitorClass
|
String |
ignoreFieldNames
|
String |
ignoreFieldTypes
|
String |
name
|
int |
priority
|
Constructor Summary | |
StatelessClassRule()
|
Method Summary | |
---|---|
void
|
setAddToIgnoreFieldNames(String moreFieldNames)
Add more field names to the existing |
Methods inherited from class AbstractAstVisitorRule | |
---|---|
shouldApplyThisRuleTo |
Property Detail |
---|
Class astVisitorClass
String ignoreFieldNames
String ignoreFieldTypes
String name
int priority
Constructor Detail |
---|
StatelessClassRule()
Method Detail |
---|
void setAddToIgnoreFieldNames(String moreFieldNames)
ignoreFieldNames
property value.
ignoreFieldNames
property value.
Groovy Documentation