Package org.apache.tools.ant.listener
Class CommonsLoggingListener
java.lang.Object
org.apache.tools.ant.listener.CommonsLoggingListener
- All Implemented Interfaces:
- EventListener,- 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 SummaryFields
- 
Constructor SummaryConstructorsConstructorDescriptionConstruct the listener and make sure that a LogFactory can be obtained.
- 
Method SummaryModifier and TypeMethodDescriptionvoidbuildFinished(BuildEvent event) Signals that the last target has finished.voidbuildStarted(BuildEvent event) Signals that a build has started.intvoidmessageLogged(BuildEvent event) Signals a message logging event.voidsetEmacsMode(boolean emacsMode) Set emacs mode.voidSet the error print stream.voidsetMessageOutputLevel(int level) Set the the output level.voidsetOutputPrintStream(PrintStream output) Set the output print stream.voidtargetFinished(BuildEvent event) Signals that a target has finished.voidtargetStarted(BuildEvent event) Signals that a target is starting.voidtaskFinished(BuildEvent event) Signals that a task has finished.voidtaskStarted(BuildEvent event) Signals that a task is starting.
- 
Field Details- 
TARGET_LOGname of the category under which target events are logged- See Also:
 
- 
PROJECT_LOGname of the category under which project events are logged- See Also:
 
 
- 
- 
Constructor Details- 
CommonsLoggingListenerpublic CommonsLoggingListener()Construct the listener and make sure that a LogFactory can be obtained.
 
- 
- 
Method Details- 
buildStartedSignals 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:
- buildStartedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
 
- 
buildFinishedSignals that the last target has finished. This event will still be fired if an error occurred during the build..- Specified by:
- buildFinishedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
targetStartedDescription copied from interface:BuildListenerSignals that a target is starting.- Specified by:
- targetStartedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
targetFinishedDescription copied from interface:BuildListenerSignals that a target has finished. This event will still be fired if an error occurred during the build.- Specified by:
- targetFinishedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
taskStartedDescription copied from interface:BuildListenerSignals that a task is starting.- Specified by:
- taskStartedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
taskFinishedDescription copied from interface:BuildListenerSignals that a task has finished. This event will still be fired if an error occurred during the build.- Specified by:
- taskFinishedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
messageLoggedDescription copied from interface:BuildListenerSignals a message logging event.- Specified by:
- messageLoggedin interface- BuildListener
- Parameters:
- event- An event with any relevant extra information. Must not be- null.
- See Also:
 
- 
setMessageOutputLevelpublic void setMessageOutputLevel(int level) Set the the output level. This is not used, the logger config is used instead.- Specified by:
- setMessageOutputLevelin interface- BuildLogger
- Parameters:
- level- ignored
 
- 
getMessageOutputLevelpublic int getMessageOutputLevel()- Specified by:
- getMessageOutputLevelin interface- BuildLogger
- Returns:
- Returns the currently setmessage output level. Thedefaultimplementation of this method returnsMSG_INFO.
 
- 
setOutputPrintStreamSet the output print stream.- Specified by:
- setOutputPrintStreamin interface- BuildLogger
- Parameters:
- output- the output stream
 
- 
setEmacsModepublic void setEmacsMode(boolean emacsMode) Set emacs mode. This is ignored.- Specified by:
- setEmacsModein interface- BuildLogger
- Parameters:
- emacsMode- ignored
 
- 
setErrorPrintStreamSet the error print stream.- Specified by:
- setErrorPrintStreamin interface- BuildLogger
- Parameters:
- err- the error stream
 
 
-