org.apache.tools.ant.taskdefs

Class RecorderEntry

java.lang.Object

org.apache.tools.ant.taskdefs.RecorderEntry

All Implemented Interfaces:

EventListener, BuildListener, BuildLogger, SubBuildListener

public class RecorderEntry
extends Object
implements BuildLogger, SubBuildListener

This is a class that represents a recorder. This is the listener to the build process.

Since:

Ant 1.4

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RecorderEntry(String name)

Method Summary

Modifier and Type	Method and Description
void	buildFinished(BuildEvent event) Signals that the last target has finished.
void	buildStarted(BuildEvent event) Signals that a build has started.
void	cleanup()
String	getFilename()
Project	getProject() Get the project associated with this recorder entry.
void	messageLogged(BuildEvent event) Signals a message logging event.
void	setEmacsMode(boolean emacsMode) Sets this logger to produce emacs (and other editor) friendly output.
void	setErrorPrintStream(PrintStream err) Sets the output stream to which this logger is to send error messages.
void	setMessageOutputLevel(int level) Sets the highest level of message this logger should respond to.
void	setOutputPrintStream(PrintStream output) Sets the output stream to which this logger is to send its output.
void	setProject(Project project) Set the project associated with this recorder entry.
void	setRecordState(Boolean state) Turns off or on this recorder.
void	subBuildFinished(BuildEvent event) Cleans up any resources held by this recorder entry at the end of a subbuild if it has been created for the subbuild's project instance.
void	subBuildStarted(BuildEvent event) Empty implementation to satisfy the BuildListener interface.
void	targetFinished(BuildEvent event) Signals that a target has finished.
void	targetStarted(BuildEvent event) Signals that a target is starting.
void	taskFinished(BuildEvent event) Signals that a task has finished.
void	taskStarted(BuildEvent event) Signals that a task is starting.

Methods inherited from class java.lang.Object

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

Constructor Detail

RecorderEntry

protected RecorderEntry(String name)

Parameters:

name - The name of this recorder (used as the filename).

Method Detail

buildFinished

public void buildFinished(BuildEvent event)

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

Specified by:

buildFinished in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getException()

buildStarted

public void buildStarted(BuildEvent event)

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

This event is fired before the project instance is fully configured. In particular no properties have been set and the project may not know its name or default target, yet.

.

Specified by:

buildStarted in interface BuildListener

Parameters:

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

cleanup

public void cleanup()

Since:

1.6.2

getFilename

public String getFilename()

Returns:

the name of the file the output is sent to.

getProject

public Project getProject()

Get the project associated with this recorder entry.

Since:

1.8.0

messageLogged

public void messageLogged(BuildEvent event)

Signals a message logging event..

Specified by:

messageLogged in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getMessage(), BuildEvent.getException(), BuildEvent.getPriority()

setEmacsMode

public void setEmacsMode(boolean emacsMode)

Sets this logger to produce emacs (and other editor) friendly output..

Specified by:

setEmacsMode in interface BuildLogger

Parameters:

emacsMode - true if output is to be unadorned so that emacs and other editors can parse files names, etc.

setErrorPrintStream

public void setErrorPrintStream(PrintStream err)

Sets the output stream to which this logger is to send error messages..

Specified by:

setErrorPrintStream in interface BuildLogger

Parameters:

err - The error stream for the logger. Must not be null.

setMessageOutputLevel

public void setMessageOutputLevel(int level)

Sets the highest level of message this logger should respond to. Only messages with a message level lower than or equal to the given level should be written to the log.

Constants for the message levels are in the Project class. The order of the levels, from least to most verbose, is MSG_ERR, MSG_WARN, MSG_INFO, MSG_VERBOSE, MSG_DEBUG..

Specified by:

setMessageOutputLevel in interface BuildLogger

Parameters:

level - the logging level for the logger.

setOutputPrintStream

public void setOutputPrintStream(PrintStream output)

Sets the output stream to which this logger is to send its output..

Specified by:

setOutputPrintStream in interface BuildLogger

Parameters:

output - The output stream for the logger. Must not be null.

setProject

public void setProject(Project project)

Set the project associated with this recorder entry.

Parameters:

project - the project instance

Since:

1.6.2

setRecordState

public void setRecordState(Boolean state)

Turns off or on this recorder.

Parameters:

state - true for on, false for off, null for no change.

subBuildFinished

public void subBuildFinished(BuildEvent event)

Cleans up any resources held by this recorder entry at the end of a subbuild if it has been created for the subbuild's project instance.

Specified by:

subBuildFinished in interface SubBuildListener

Parameters:

event - the buildFinished event

Since:

Ant 1.6.2

See Also:

BuildEvent.getException()

subBuildStarted

public void subBuildStarted(BuildEvent event)

Empty implementation to satisfy the BuildListener interface.

Specified by:

subBuildStarted in interface SubBuildListener

Parameters:

event - the buildStarted event

Since:

Ant 1.6.2

targetFinished

public void targetFinished(BuildEvent event)

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

Specified by:

targetFinished in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getException()

targetStarted

public void targetStarted(BuildEvent event)

Signals that a target is starting..

Specified by:

targetStarted in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getTarget()

taskFinished

public void taskFinished(BuildEvent event)

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

Specified by:

taskFinished in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getException()

taskStarted

public void taskStarted(BuildEvent event)

Signals that a task is starting..

Specified by:

taskStarted in interface BuildListener

Parameters:

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

See Also:

BuildEvent.getTask()