Package org.apache.tools.ant.listener

Class BigProjectLogger

java.lang.Object

org.apache.tools.ant.DefaultLogger

org.apache.tools.ant.NoBannerLogger

org.apache.tools.ant.listener.SimpleBigProjectLogger

org.apache.tools.ant.listener.BigProjectLogger

All Implemented Interfaces:

EventListener, BuildListener, BuildLogger, SubBuildListener

public class BigProjectLogger
extends SimpleBigProjectLogger
implements SubBuildListener

This is a special logger that is designed to make it easier to work with big projects, those that use imports and subant to build complex systems.

Since:

Ant1.7.1

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FOOTER	Footer string for the log.
static final String	HEADER	Header string for the log.

Fields inherited from class org.apache.tools.ant.NoBannerLogger

targetName

Fields inherited from class org.apache.tools.ant.DefaultLogger

emacsMode, err, LEFT_COLUMN_SIZE, lSep, msgOutputLevel, out

Constructor Summary

Constructors

Constructor	Description
BigProjectLogger()

Method Summary

Modifier and Type	Method	Description
void	buildFinished(BuildEvent event)	Prints whether the build succeeded or failed, any errors the occurred during the build, and how long the build took.
protected String	extractNameOrDefault(BuildEvent event)	Get the name of an event
protected String	getBuildFailedMessage()	This is an override point: the message that indicates whether a build failed.
protected String	getBuildSuccessfulMessage()	This is an override point: the message that indicates that a build succeeded.
protected String	getFooter()	Override point: return the footer string for the entry/exit message
protected String	getHeader()	Override point: return the header string for the entry/exit message
void	messageLogged(BuildEvent event)	Logs a message for a target if it is of an appropriate priority, also logging the name of the target if this is the first message which needs to be logged for the target.
void	subBuildFinished(BuildEvent event)	Signals that the last target has finished.
void	subBuildStarted(BuildEvent event)	Signals that a subbuild has started.
void	targetStarted(BuildEvent event)	Notes the name of the target so it can be logged if it generates any messages.
void	taskStarted(BuildEvent event)	No-op implementation.

Methods inherited from class org.apache.tools.ant.listener.SimpleBigProjectLogger

extractTargetName

Methods inherited from class org.apache.tools.ant.NoBannerLogger

targetFinished

Methods inherited from class org.apache.tools.ant.DefaultLogger

buildStarted, extractProjectName, formatTime, getMessageOutputLevel, getTimestamp, log, printMessage, setEmacsMode, setErrorPrintStream, setMessageOutputLevel, setOutputPrintStream, taskFinished

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tools.ant.BuildListener

buildStarted, targetFinished, taskFinished

Field Details

HEADER

public static final String HEADER

Header string for the log. "======================================================================"

See Also:

• Constant Field Values

FOOTER

public static final String FOOTER

Footer string for the log. "======================================================================"

See Also:

• Constant Field Values

Constructor Details

BigProjectLogger

public BigProjectLogger()

Method Details

getBuildFailedMessage

protected String getBuildFailedMessage()

This is an override point: the message that indicates whether a build failed. Subclasses can change/enhance the message.

Overrides:

getBuildFailedMessage in class DefaultLogger

Returns:

The classic "BUILD FAILED" plus a timestamp

getBuildSuccessfulMessage

protected String getBuildSuccessfulMessage()

This is an override point: the message that indicates that a build succeeded. Subclasses can change/enhance the message.

Overrides:

getBuildSuccessfulMessage in class DefaultLogger

Returns:

The classic "BUILD SUCCESSFUL" plus a timestamp

targetStarted

public void targetStarted(BuildEvent event)

Notes the name of the target so it can be logged if it generates any messages.

Specified by:

targetStarted in interface BuildListener

Overrides:

targetStarted in class NoBannerLogger

Parameters:

event - BuildEvent

See Also:

• BuildEvent.getTarget()

taskStarted

public void taskStarted(BuildEvent event)

No-op implementation.

Specified by:

taskStarted in interface BuildListener

Overrides:

taskStarted in class DefaultLogger

Parameters:

event - BuildEvent

See Also:

• BuildEvent.getTask()

buildFinished

public void buildFinished(BuildEvent event)

Prints whether the build succeeded or failed, any errors the occurred during the build, and how long the build took.

Specified by:

buildFinished in interface BuildListener

Overrides:

buildFinished in class DefaultLogger

Parameters:

event - BuildEvent

See Also:

• BuildEvent.getException()

messageLogged

public void messageLogged(BuildEvent event)

Logs a message for a target if it is of an appropriate priority, also logging the name of the target if this is the first message which needs to be logged for the target.

Specified by:

messageLogged in interface BuildListener

Overrides:

messageLogged in class NoBannerLogger

Parameters:

event - BuildEvent

See Also:

• BuildEvent.getMessage()
• BuildEvent.getException()
• BuildEvent.getPriority()

subBuildStarted

public void subBuildStarted(BuildEvent event)

Signals that a subbuild has started. This event is fired before any targets have started.

Specified by:

subBuildStarted in interface SubBuildListener

Parameters:

event - An event with any relevant extra information. Must not be null.

extractNameOrDefault

protected String extractNameOrDefault(BuildEvent event)

Get the name of an event

Parameters:

event - the event name

Returns:

the name or a default string

subBuildFinished

public void subBuildFinished(BuildEvent event)

Signals that the last target has finished. This event will still be fired if an error occurred during the build.

Specified by:

subBuildFinished in interface SubBuildListener

Parameters:

event - An event with any relevant extra information. Must not be null.

See Also:

• BuildEvent.getException()

getHeader

protected String getHeader()

Override point: return the header string for the entry/exit message

Returns:

the header string

getFooter

protected String getFooter()

Override point: return the footer string for the entry/exit message

Returns:

the footer string