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 error 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 inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
AuditEvent(Object source) Creates a new instance.
AuditEvent(Object src, String fileName) Creates a new AuditEvent instance.
AuditEvent(Object src, String fileName, LocalizedMessage localizedMessage) Creates a new AuditEvent instance.

Method Summary

Modifier and Type	Method and Description
int	getColumn() Gets the column associated with the message.
String	getFileName() Returns name of file being audited.
int	getLine() Return the line number on the source file where the event occurred.
LocalizedMessage	getLocalizedMessage() Gets the localized message.
String	getMessage() Return the message 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 message.

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

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,
                  LocalizedMessage localizedMessage)

Creates a new AuditEvent instance.

Parameters:

src - source of the event

fileName - file associated with the event

localizedMessage - the actual message

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 message associated to the event.

Returns:

the event message

getColumn

public int getColumn()

Gets the column associated with the message.

Returns:

the column associated with the message

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 message.

Returns:

the name of the source for the message

getLocalizedMessage

public LocalizedMessage getLocalizedMessage()

Gets the localized message.

Returns:

the localized message