|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object | +--org.apache.tools.ant.DefaultLogger
Writes build events to a PrintStream. Currently, it only writes which targets are being executed, and any messages that get logged.
| Field Summary | |
protected boolean |
emacsMode
Whether or not to use emacs-style output |
protected java.io.PrintStream |
err
PrintStream to write error messages to |
static int |
LEFT_COLUMN_SIZE
Size of left-hand column for right-justified task name. |
protected static java.lang.String |
lSep
Line separator |
protected int |
msgOutputLevel
Lowest level of message to write out |
protected java.io.PrintStream |
out
PrintStream to write non-error messages to |
| Constructor Summary | |
DefaultLogger()
Sole constructor. |
|
| Method Summary | |
void |
buildFinished(BuildEvent event)
Prints whether the build succeeded or failed, any errors the occurred during the build, and how long the build took. |
void |
buildStarted(BuildEvent event)
Responds to a build being started by just remembering the current time. |
protected static java.lang.String |
formatTime(long millis)
Convenience method to format a specified length of time. |
protected void |
log(java.lang.String message)
Empty implementation which allows subclasses to receive the same output that is generated here. |
void |
messageLogged(BuildEvent event)
Logs a message, if the priority is suitable. |
protected void |
printMessage(java.lang.String message,
java.io.PrintStream stream,
int priority)
Prints a message to a PrintStream. |
void |
setEmacsMode(boolean emacsMode)
Sets this logger to produce emacs (and other editor) friendly output. |
void |
setErrorPrintStream(java.io.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(java.io.PrintStream output)
Sets the output stream to which this logger is to send its output. |
void |
targetFinished(BuildEvent event)
No-op implementation. |
void |
targetStarted(BuildEvent event)
Logs a message to say that the target has started if this logger allows information-level messages. |
void |
taskFinished(BuildEvent event)
No-op implementation. |
void |
taskStarted(BuildEvent event)
No-op implementation. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
public static final int LEFT_COLUMN_SIZE
messageLogged(BuildEvent),
Constant Field Valuesprotected java.io.PrintStream out
protected java.io.PrintStream err
protected int msgOutputLevel
protected static final java.lang.String lSep
protected boolean emacsMode
| Constructor Detail |
public DefaultLogger()
| Method Detail |
public void setMessageOutputLevel(int level)
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.
The default message level for DefaultLogger is Project.MSG_ERR.
setMessageOutputLevel in interface BuildLoggerlevel - the logging level for the logger.public void setOutputPrintStream(java.io.PrintStream output)
setOutputPrintStream in interface BuildLoggeroutput - The output stream for the logger.
Must not be null.public void setErrorPrintStream(java.io.PrintStream err)
setErrorPrintStream in interface BuildLoggererr - The error stream for the logger.
Must not be null.public void setEmacsMode(boolean emacsMode)
setEmacsMode in interface BuildLoggeremacsMode - true if output is to be unadorned so that
emacs and other editors can parse files names, etc.public void buildStarted(BuildEvent event)
buildStarted in interface BuildListenerevent - Ignored.public void buildFinished(BuildEvent event)
buildFinished in interface BuildListenerevent - An event with any relevant extra information.
Must not be null.BuildEvent.getException()public void targetStarted(BuildEvent event)
targetStarted in interface BuildListenerevent - An event with any relevant extra information.
Must not be null.BuildEvent.getTarget()public void targetFinished(BuildEvent event)
targetFinished in interface BuildListenerevent - Ignored.BuildEvent.getException()public void taskStarted(BuildEvent event)
taskStarted in interface BuildListenerevent - Ignored.BuildEvent.getTask()public void taskFinished(BuildEvent event)
taskFinished in interface BuildListenerevent - Ignored.BuildEvent.getException()public void messageLogged(BuildEvent event)
messageLogged in interface BuildListenerevent - A BuildEvent containing message information.
Must not be null.BuildEvent.getMessage(),
BuildEvent.getPriority()protected static java.lang.String formatTime(long millis)
millis - Length of time to format, in milliseconds.
DateUtils.formatElapsedTime(long)
protected void printMessage(java.lang.String message,
java.io.PrintStream stream,
int priority)
message - The message to print.
Should not be null.stream - A PrintStream to print the message to.
Must not be null.priority - The priority of the message.
(Ignored in this implementation.)protected void log(java.lang.String message)
message - Message being logged. Should not be null.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||