Package org.apache.tools.ant

# Interface BuildListener

All Superinterfaces:
  `EventListener`

All Known Subinterfaces:
  `BuildLogger`, `SubBuildListener`

All Known Implementing Classes:
  `AnsiColorLogger`, `AntClassLoader`, `AntClassLoader2`, `AntClassLoader5`, `AntSoundPlayer`, `BigProjectLogger`, `CommonsLoggingListener`, `DefaultLogger`, `FailureRecorder`, `Log4jListener`, `MailLogger`, `ModifiedSelector`, `NoBannerLogger`, `ProfileLogger`, `Recorder`, `RecorderEntry`, `SilentLogger`, `SimpleBigProjectLogger`, `SplitClassLoader`, `TimestampedLogger`, `XmlLogger`

public interface BuildListener extends EventListener
Instances of classes that implement this interface can register to be notified when things happened during a build.

See Also:
  - `BuildEvent`
  - `Project.addBuildListener(BuildListener)`

## Method Summary

Modifier and Type
Method
Description
`void`
`buildFinished(BuildEvent event)`
Signals that the last target has finished.
`void`
`buildStarted(BuildEvent event)`
Signals that a build has started.
`void`
`messageLogged(BuildEvent event)`
Signals a message logging event.
`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.

## Method Details

### buildStarted

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.

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

### buildFinished

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

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getException()`

### targetStarted

void targetStarted(BuildEvent event)
Signals that a target is starting.

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getTarget()`

### targetFinished

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

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getException()`

### taskStarted

void taskStarted(BuildEvent event)
Signals that a task is starting.

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getTask()`

### taskFinished

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

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getException()`

### messageLogged

void messageLogged(BuildEvent event)
Signals a message logging event.

Parameters:
  `event` - An event with any relevant extra information. Must not be `null`.
See Also:
  - `BuildEvent.getMessage()`
  - `BuildEvent.getException()`
  - `BuildEvent.getPriority()`