Package com.puppycrawl.tools.checkstyle.api

Class AuditEvent

java.lang.Object

java.util.EventObject

com.puppycrawl.tools.checkstyle.api.AuditEvent

All Implemented Interfaces:

Serializable

public final class AuditEvent
extends EventObject

Raw event for audit.

I'm not very satisfied about the design of this event since there are optional methods that will return null in most of the case. This will need some work to clean it up especially if we want to introduce a more sequential reporting action rather than a packet reporting. This will allow for example to follow the process quickly in an interface or a servlet (yep, that's cool to run a check via a web interface in a source repository ;-)

See Also:

AuditListener, Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private String	fileName	Filename event associated with.
private static long	serialVersionUID	Record a version.
private Violation	violation	Violation associated with the event.

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor	Description
AuditEvent(Object source)	Creates a new instance.
AuditEvent(Object src, String fileName)	Creates a new AuditEvent instance.
AuditEvent(Object src, String fileName, Violation violation)	Creates a new AuditEvent instance.

Method Summary

Modifier and Type	Method	Description
int	getColumn()	Gets the column associated with the violation.
String	getFileName()	Returns name of file being audited.
int	getLine()	Return the line number on the source file where the event occurred.
String	getMessage()	Return the violation associated to the event.
String	getModuleId()	Returns id of module.
SeverityLevel	getSeverityLevel()	Gets the audit event severity level.
String	getSourceName()	Gets the name of the source for the violation.
Violation	getViolation()	Gets the violation.

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

Record a version.

See Also:

Constant Field Values

fileName

private final String fileName

Filename event associated with.

violation

private final Violation violation

Violation associated with the event.

Constructor Detail

AuditEvent

public AuditEvent(Object source)

Creates a new instance.

Parameters:

source - the object that created the event

AuditEvent

public AuditEvent(Object src,
                  String fileName)

Creates a new AuditEvent instance.

Parameters:

src - source of the event

fileName - file associated with the event

AuditEvent

public AuditEvent(Object src,
                  String fileName,
                  Violation violation)

Creates a new AuditEvent instance.

Parameters:

src - source of the event

fileName - file associated with the event

violation - the actual violation

Method Detail

getFileName

public String getFileName()

Returns name of file being audited.

Returns:

the file name currently being audited or null if there is no relation to a file.

getLine

public int getLine()

Return the line number on the source file where the event occurred. This may be 0 if there is no relation to a file content.

Returns:

an integer representing the line number in the file source code.

getMessage

public String getMessage()

Return the violation associated to the event.

Returns:

the event violation

getColumn

public int getColumn()

Gets the column associated with the violation.

Returns:

the column associated with the violation

getSeverityLevel

public SeverityLevel getSeverityLevel()

Gets the audit event severity level.

Returns:

the audit event severity level

getModuleId

public String getModuleId()

Returns id of module.

Returns:

the identifier of the module that generated the event. Can return null.

getSourceName

public String getSourceName()

Gets the name of the source for the violation.

Returns:

the name of the source for the violation

getViolation

public Violation getViolation()

Gets the violation.

Returns:

the violation