org.apache.tools.ant.listener

Class CommonsLoggingListener

Implemented Interfaces:
BuildListener, EventListener, BuildListener, BuildLogger

public class CommonsLoggingListener
extends java.lang.Object
implements BuildListener, BuildLogger

Jakarta Commons Logging listener. Note: do not use the SimpleLog as your logger implementation as it causes an infinite loop since it writes to System.err, which Ant traps and reroutes to the logger/listener layer. The following names are used for the log: org.apache.tools.ant.Project.PROJECT_NAME - for project events org.apache.tools.ant.Target.TARGET_NAME - for target events TASK_CLASS_NAME.TARGET_NAME - for events in individual targets. In all target and project names we replace "." and " " with "-". TODO: we should use the advanced context logging features (and expose them in c-l first :-) TODO: this is _very_ inefficient. Switching the out and tracking the logs can be optimized a lot - but may require few more changes to the core.
Since:
Ant 1.5

Field Summary

static String
PROJECT_LOG
name of the category under which project events are logged
static String
TARGET_LOG
name of the category under which target events are logged

Constructor Summary

CommonsLoggingListener()
Construct the listener and make sure that a LogFactory can be obtained.

Method Summary

void
buildFinished(BuildEvent event)
.
void
buildStarted(BuildEvent event)
.
void
messageLogged(BuildEvent event)
.
void
setEmacsMode(boolean emacsMode)
Set emacs mode.
void
setErrorPrintStream(PrintStream err)
Set the error print stream.
void
setMessageOutputLevel(int level)
Set the the output level.
void
setOutputPrintStream(PrintStream output)
Set the output print stream.
void
targetFinished(BuildEvent event)
.
void
targetStarted(BuildEvent event)
.
void
taskFinished(BuildEvent event)
.
void
taskStarted(BuildEvent event)
.

Field Details

PROJECT_LOG

public static final String PROJECT_LOG
name of the category under which project events are logged

TARGET_LOG

public static final String TARGET_LOG
name of the category under which target events are logged

Constructor Details

CommonsLoggingListener

public CommonsLoggingListener()
Construct the listener and make sure that a LogFactory can be obtained.

Method Details

buildFinished

public void buildFinished(BuildEvent event)
.
Specified by:
buildFinished in interface BuildListener

buildStarted

public void buildStarted(BuildEvent event)
.
Specified by:
buildStarted in interface BuildListener

messageLogged

public void messageLogged(BuildEvent event)
.
Specified by:
messageLogged in interface BuildListener

setEmacsMode

public void setEmacsMode(boolean emacsMode)
Set emacs mode. This is ignored.
Specified by:
setEmacsMode in interface BuildLogger
Parameters:
emacsMode - ignored

setErrorPrintStream

public void setErrorPrintStream(PrintStream err)
Set the error print stream.
Specified by:
setErrorPrintStream in interface BuildLogger
Parameters:
err - the error stream

setMessageOutputLevel

public void setMessageOutputLevel(int level)
Set the the output level. This is not used, the logger config is used instead.
Specified by:
setMessageOutputLevel in interface BuildLogger
Parameters:
level - ignored

setOutputPrintStream

public void setOutputPrintStream(PrintStream output)
Set the output print stream.
Specified by:
setOutputPrintStream in interface BuildLogger
Parameters:
output - the output stream

targetFinished

public void targetFinished(BuildEvent event)
.
Specified by:
targetFinished in interface BuildListener

targetStarted

public void targetStarted(BuildEvent event)
.
Specified by:
targetStarted in interface BuildListener

taskFinished

public void taskFinished(BuildEvent event)
.
Specified by:
taskFinished in interface BuildListener

taskStarted

public void taskStarted(BuildEvent event)
.
Specified by:
taskStarted in interface BuildListener