com.puppycrawl.tools.checkstyle

Class DefaultLogger

java.lang.Object

com.puppycrawl.tools.checkstyle.api.AutomaticBean

com.puppycrawl.tools.checkstyle.DefaultLogger

All Implemented Interfaces:

AuditListener, Configurable, Contextualizable, EventListener

public class DefaultLogger
extends AutomaticBean
implements AuditListener

Simple plain logger for text output. This is maybe not very suitable for a text output into a file since it does not need all 'audit finished' and so on stuff, but it looks good on stdout anyway. If there is really a problem this is what XMLLogger is for. It gives structure.

Author:

Stephane Bailliez

See Also:

XMLLogger

Nested Class Summary

Nested classes/interfaces inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean

AutomaticBean.OutputStreamOptions

Field Summary

Fields

Modifier and Type	Field and Description
static String	ADD_EXCEPTION_MESSAGE A key pointing to the add exception message in the "messages.properties" file.
static String	AUDIT_FINISHED_MESSAGE A key pointing to the finished audit message in the "messages.properties" file.
static String	AUDIT_STARTED_MESSAGE A key pointing to the started audit message in the "messages.properties" file.

Constructor Summary

Constructors

Constructor and Description
DefaultLogger(OutputStream outputStream, AutomaticBean.OutputStreamOptions outputStreamOptions) Creates a new DefaultLogger instance.
DefaultLogger(OutputStream infoStream, AutomaticBean.OutputStreamOptions infoStreamOptions, OutputStream errorStream, AutomaticBean.OutputStreamOptions errorStreamOptions) Creates a new DefaultLogger instance.
DefaultLogger(OutputStream infoStream, AutomaticBean.OutputStreamOptions infoStreamOptions, OutputStream errorStream, AutomaticBean.OutputStreamOptions errorStreamOptions, AuditEventFormatter messageFormatter) Creates a new DefaultLogger instance.
DefaultLogger(OutputStream outputStream, boolean closeStreamsAfterUse) Deprecated. in order to fulfill demands of BooleanParameter IDEA check.
DefaultLogger(OutputStream infoStream, boolean closeInfoAfterUse, OutputStream errorStream, boolean closeErrorAfterUse) Deprecated. in order to fulfill demands of BooleanParameter IDEA check.
DefaultLogger(OutputStream infoStream, boolean closeInfoAfterUse, OutputStream errorStream, boolean closeErrorAfterUse, AuditEventFormatter messageFormatter) Deprecated. in order to fulfill demands of BooleanParameter IDEA check.

Method Summary

Modifier and Type	Method and Description
void	addError(AuditEvent event) Print an Emacs compliant line on the error stream.
void	addException(AuditEvent event, Throwable throwable) Notify that an exception happened while performing audit.
void	auditFinished(AuditEvent event) Notify that the audit is finished.
void	auditStarted(AuditEvent event) Notify that the audit is about to start.
void	fileFinished(AuditEvent event) Notify that audit is finished on a specific file.
void	fileStarted(AuditEvent event) Notify that audit is about to start on a specific file.
protected void	finishLocalSetup() Provides a hook to finish the part of this component's setup that was not handled by the bean introspection.

Methods inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean

configure, contextualize, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Field Detail

ADD_EXCEPTION_MESSAGE

public static final String ADD_EXCEPTION_MESSAGE

A key pointing to the add exception message in the "messages.properties" file.

See Also:

Constant Field Values

AUDIT_STARTED_MESSAGE

public static final String AUDIT_STARTED_MESSAGE

A key pointing to the started audit message in the "messages.properties" file.

See Also:

Constant Field Values

AUDIT_FINISHED_MESSAGE

public static final String AUDIT_FINISHED_MESSAGE

A key pointing to the finished audit message in the "messages.properties" file.

See Also:

Constant Field Values

Constructor Detail

DefaultLogger

@Deprecated
public DefaultLogger(OutputStream outputStream,
                                 boolean closeStreamsAfterUse)

Deprecated. in order to fulfill demands of BooleanParameter IDEA check.

Creates a new DefaultLogger instance.

Parameters:

outputStream - where to log infos and errors

closeStreamsAfterUse - if oS should be closed in auditFinished()

DefaultLogger

@Deprecated
public DefaultLogger(OutputStream infoStream,
                                 boolean closeInfoAfterUse,
                                 OutputStream errorStream,
                                 boolean closeErrorAfterUse)

Deprecated. in order to fulfill demands of BooleanParameter IDEA check.

Creates a new DefaultLogger instance.

Parameters:

infoStream - the OutputStream for info messages.

closeInfoAfterUse - auditFinished should close infoStream.

errorStream - the OutputStream for error messages.

closeErrorAfterUse - auditFinished should close errorStream

DefaultLogger

@Deprecated
public DefaultLogger(OutputStream infoStream,
                                 boolean closeInfoAfterUse,
                                 OutputStream errorStream,
                                 boolean closeErrorAfterUse,
                                 AuditEventFormatter messageFormatter)

Deprecated. in order to fulfill demands of BooleanParameter IDEA check.

Creates a new DefaultLogger instance.

Parameters:

infoStream - the OutputStream for info messages

closeInfoAfterUse - auditFinished should close infoStream

errorStream - the OutputStream for error messages

closeErrorAfterUse - auditFinished should close errorStream

messageFormatter - formatter for the log message.

DefaultLogger

public DefaultLogger(OutputStream outputStream,
                     AutomaticBean.OutputStreamOptions outputStreamOptions)

Creates a new DefaultLogger instance.

Parameters:

outputStream - where to log infos and errors

outputStreamOptions - if CLOSE that should be closed in auditFinished()

DefaultLogger

public DefaultLogger(OutputStream infoStream,
                     AutomaticBean.OutputStreamOptions infoStreamOptions,
                     OutputStream errorStream,
                     AutomaticBean.OutputStreamOptions errorStreamOptions)

Creates a new DefaultLogger instance.

Parameters:

infoStream - the OutputStream for info messages.

infoStreamOptions - if CLOSE info should be closed in auditFinished()

errorStream - the OutputStream for error messages.

errorStreamOptions - if CLOSE error should be closed in auditFinished()

DefaultLogger

public DefaultLogger(OutputStream infoStream,
                     AutomaticBean.OutputStreamOptions infoStreamOptions,
                     OutputStream errorStream,
                     AutomaticBean.OutputStreamOptions errorStreamOptions,
                     AuditEventFormatter messageFormatter)

Creates a new DefaultLogger instance.

Parameters:

infoStream - the OutputStream for info messages

infoStreamOptions - if CLOSE info should be closed in auditFinished()

errorStream - the OutputStream for error messages

errorStreamOptions - if CLOSE error should be closed in auditFinished()

messageFormatter - formatter for the log message.

Method Detail

finishLocalSetup

protected void finishLocalSetup()
                         throws CheckstyleException

Description copied from class: AutomaticBean

Provides a hook to finish the part of this component's setup that was not handled by the bean introspection.

The default implementation does nothing.

Specified by:

finishLocalSetup in class AutomaticBean

Throws:

CheckstyleException - if there is a configuration error.

addError

public void addError(AuditEvent event)

Print an Emacs compliant line on the error stream. If the column number is non zero, then also display it.

Specified by:

addError in interface AuditListener

Parameters:

event - the event details

See Also:

AuditListener

addException

public void addException(AuditEvent event,
                         Throwable throwable)

Description copied from interface: AuditListener

Notify that an exception happened while performing audit.

Specified by:

addException in interface AuditListener

Parameters:

event - the event details

throwable - details of the exception

auditStarted

public void auditStarted(AuditEvent event)

Description copied from interface: AuditListener

Notify that the audit is about to start.

Specified by:

auditStarted in interface AuditListener

Parameters:

event - the event details

auditFinished

public void auditFinished(AuditEvent event)

Description copied from interface: AuditListener

Notify that the audit is finished.

Specified by:

auditFinished in interface AuditListener

Parameters:

event - the event details

fileStarted

public void fileStarted(AuditEvent event)

Description copied from interface: AuditListener

Notify that audit is about to start on a specific file.

Specified by:

fileStarted in interface AuditListener

Parameters:

event - the event details

fileFinished

public void fileFinished(AuditEvent event)

Description copied from interface: AuditListener

Notify that audit is finished on a specific file.

Specified by:

fileFinished in interface AuditListener

Parameters:

event - the event details