com.puppycrawl.tools.checkstyle.api

Class Violation

java.lang.Object

com.puppycrawl.tools.checkstyle.api.Violation

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Violation>

public final class Violation
extends java.lang.Object
implements java.lang.Comparable<Violation>, java.io.Serializable

Represents a violation that can be localised. The translations come from message.properties files. The underlying implementation uses java.text.MessageFormat.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Violation.Utf8Control Custom ResourceBundle.Control implementation which allows explicitly read the properties files as UTF-8.

Constructor Summary

Constructors

Constructor and Description
Violation(int lineNo, int columnNo, int columnCharIndex, int tokenType, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, SeverityLevel severityLevel, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.
Violation(int lineNo, int columnNo, int tokenType, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, SeverityLevel severityLevel, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.
Violation(int lineNo, int columnNo, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, SeverityLevel severityLevel, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.
Violation(int lineNo, int columnNo, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.
Violation(int lineNo, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, SeverityLevel severityLevel, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.
Violation(int lineNo, java.lang.String bundle, java.lang.String key, java.lang.Object[] args, java.lang.String moduleId, java.lang.Class<?> sourceClass, java.lang.String customMessage) Creates a new Violation instance.

Method Summary

Modifier and Type	Method and Description
static void	clearCache() Clears the cache.
int	compareTo(Violation other)
boolean	equals(java.lang.Object object) Indicates whether some other object is "equal to" this one.
int	getColumnCharIndex() Gets the column char index.
int	getColumnNo() Gets the column number.
java.lang.String	getKey() Returns the violation key to locate the translation, can also be used in IDE plugins to map audit event violations to corrective actions.
int	getLineNo() Gets the line number.
java.lang.String	getModuleId() Returns id of module.
SeverityLevel	getSeverityLevel() Gets the severity level.
java.lang.String	getSourceName() Gets the name of the source for this Violation.
int	getTokenType() Gets the token type.
java.lang.String	getViolation() Gets the translated violation.
int	hashCode()
static void	setLocale(java.util.Locale locale) Sets a locale to use for localization.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Violation

public Violation(int lineNo,
                 int columnNo,
                 int columnCharIndex,
                 int tokenType,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 SeverityLevel severityLevel,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance.

Parameters:

lineNo - line number associated with the violation

columnNo - column number associated with the violation

columnCharIndex - column char index associated with the violation

tokenType - token type of the event associated with violation. See TokenTypes

bundle - resource bundle name

key - the key to locate the translation

args - arguments for the translation

severityLevel - severity level for the violation

moduleId - the id of the module the violation is associated with

sourceClass - the Class that is the source of the violation

customMessage - optional custom violation overriding the default

Violation

public Violation(int lineNo,
                 int columnNo,
                 int tokenType,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 SeverityLevel severityLevel,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance.

Parameters:

lineNo - line number associated with the violation

columnNo - column number associated with the violation

tokenType - token type of the event associated with violation. See TokenTypes

bundle - resource bundle name

key - the key to locate the translation

args - arguments for the translation

severityLevel - severity level for the violation

moduleId - the id of the module the violation is associated with

sourceClass - the Class that is the source of the violation

customMessage - optional custom violation overriding the default

Violation

public Violation(int lineNo,
                 int columnNo,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 SeverityLevel severityLevel,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance.

Parameters:

lineNo - line number associated with the violation

columnNo - column number associated with the violation

bundle - resource bundle name

key - the key to locate the translation

args - arguments for the translation

severityLevel - severity level for the violation

moduleId - the id of the module the violation is associated with

sourceClass - the Class that is the source of the violation

customMessage - optional custom violation overriding the default

Violation

public Violation(int lineNo,
                 int columnNo,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance.

Parameters:

lineNo - line number associated with the violation

columnNo - column number associated with the violation

bundle - resource bundle name

key - the key to locate the translation

args - arguments for the translation

moduleId - the id of the module the violation is associated with

sourceClass - the Class that is the source of the violation

customMessage - optional custom violation overriding the default

Violation

public Violation(int lineNo,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 SeverityLevel severityLevel,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance.

Parameters:

lineNo - line number associated with the violation

bundle - resource bundle name

key - the key to locate the translation

args - arguments for the translation

severityLevel - severity level for the violation

moduleId - the id of the module the violation is associated with

sourceClass - the source class for the violation

customMessage - optional custom violation overriding the default

Violation

public Violation(int lineNo,
                 java.lang.String bundle,
                 java.lang.String key,
                 java.lang.Object[] args,
                 java.lang.String moduleId,
                 java.lang.Class<?> sourceClass,
                 java.lang.String customMessage)

Creates a new Violation instance. The column number defaults to 0.

Parameters:

lineNo - line number associated with the violation

bundle - name of a resource bundle that contains audit event violations

key - the key to locate the translation

args - arguments for the translation

moduleId - the id of the module the violation is associated with

sourceClass - the name of the source for the violation

customMessage - optional custom violation overriding the default

Method Detail

getLineNo

public int getLineNo()

Gets the line number.

Returns:

the line number

getColumnNo

public int getColumnNo()

Gets the column number.

Returns:

the column number

getColumnCharIndex

public int getColumnCharIndex()

Gets the column char index.

Returns:

the column char index

getTokenType

public int getTokenType()

Gets the token type.

Returns:

the token type

getSeverityLevel

public SeverityLevel getSeverityLevel()

Gets the severity level.

Returns:

the severity level

getModuleId

public java.lang.String getModuleId()

Returns id of module.

Returns:

the module identifier.

getKey

public java.lang.String getKey()

Returns the violation key to locate the translation, can also be used in IDE plugins to map audit event violations to corrective actions.

Returns:

the violation key

getSourceName

public java.lang.String getSourceName()

Gets the name of the source for this Violation.

Returns:

the name of the source for this Violation

setLocale

public static void setLocale(java.util.Locale locale)

Sets a locale to use for localization.

Parameters:

locale - the locale to use for localization

clearCache

public static void clearCache()

Clears the cache.

equals

public boolean equals(java.lang.Object object)

Indicates whether some other object is "equal to" this one. Suppression on enumeration is needed so code stays consistent.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(Violation other)

Specified by:

compareTo in interface java.lang.Comparable<Violation>

getViolation

public java.lang.String getViolation()

Gets the translated violation.

Returns:

the translated violation