com.judoscript.util
Class AntWriterLogger

java.lang.Object
  com.judoscript.util.AntWriterLogger

All Implemented Interfaces:

java.util.EventListener, org.apache.tools.ant.BuildListener

public class AntWriterLogger
extends java.lang.Object
implements org.apache.tools.ant.BuildListener

Writes build events to a PrintWrite. 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.PrintWriter	err PrintWriter 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.PrintWriter	out PrintWriter to write non-error messages to

Constructor Summary

AntWriterLogger(java.io.PrintWriter out, java.io.PrintWriter err)
Sole constructor.

Method Summary

void	buildFinished(org.apache.tools.ant.BuildEvent event) Prints whether the build succeeded or failed, any errors the occured during the build, and how long the build took.
void	buildStarted(org.apache.tools.ant.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(org.apache.tools.ant.BuildEvent event) Logs a message, if the priority is suitable.
protected void	printMessage(java.lang.String message, java.io.PrintWriter stream, int priority) Prints a message to a PrintWriter.
void	setEmacsMode(boolean emacsMode) Sets this logger to produce emacs (and other editor) friendly output.
void	setErrorPrintStream(java.io.PrintWriter 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.PrintWriter out) Sets the output stream to which this logger is to send its output.
void	targetFinished(org.apache.tools.ant.BuildEvent event) No-op implementation.
void	targetStarted(org.apache.tools.ant.BuildEvent event) Logs a message to say that the target has started if this logger allows information-level messages.
void	taskFinished(org.apache.tools.ant.BuildEvent event) No-op implementation.
void	taskStarted(org.apache.tools.ant.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

LEFT_COLUMN_SIZE

public static final int LEFT_COLUMN_SIZE

Size of left-hand column for right-justified task name.

See Also:

messageLogged(BuildEvent), Constant Field Values

out

protected java.io.PrintWriter out

PrintWriter to write non-error messages to

err

protected java.io.PrintWriter err

PrintWriter to write error messages to

msgOutputLevel

protected int msgOutputLevel

Lowest level of message to write out

lSep

protected static final java.lang.String lSep

Line separator

emacsMode

protected boolean emacsMode

Whether or not to use emacs-style output

Constructor Detail

AntWriterLogger

public AntWriterLogger(java.io.PrintWriter out,
                       java.io.PrintWriter err)

Sole constructor.

Method Detail

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.

The default message level for DefaultLogger is Project.MSG_ERR.

Parameters:

level - the logging level for the logger.

setOutputPrintStream

public void setOutputPrintStream(java.io.PrintWriter out)

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

Parameters:

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

setErrorPrintStream

public void setErrorPrintStream(java.io.PrintWriter err)

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

Parameters:

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

setEmacsMode

public void setEmacsMode(boolean emacsMode)

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

Parameters:

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

buildStarted

public void buildStarted(org.apache.tools.ant.BuildEvent event)

Responds to a build being started by just remembering the current time.

Specified by:

buildStarted in interface org.apache.tools.ant.BuildListener

Parameters:

event - Ignored.

buildFinished

public void buildFinished(org.apache.tools.ant.BuildEvent event)

Prints whether the build succeeded or failed, any errors the occured during the build, and how long the build took.

Specified by:

buildFinished in interface org.apache.tools.ant.BuildListener

Parameters:

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

targetStarted

public void targetStarted(org.apache.tools.ant.BuildEvent event)

Logs a message to say that the target has started if this logger allows information-level messages.

Specified by:

targetStarted in interface org.apache.tools.ant.BuildListener

Parameters:

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

targetFinished

public void targetFinished(org.apache.tools.ant.BuildEvent event)

No-op implementation.

Specified by:

targetFinished in interface org.apache.tools.ant.BuildListener

Parameters:

event - Ignored.

taskStarted

public void taskStarted(org.apache.tools.ant.BuildEvent event)

No-op implementation.

Specified by:

taskStarted in interface org.apache.tools.ant.BuildListener

Parameters:

event - Ignored.

taskFinished

public void taskFinished(org.apache.tools.ant.BuildEvent event)

No-op implementation.

Specified by:

taskFinished in interface org.apache.tools.ant.BuildListener

Parameters:

event - Ignored.

messageLogged

public void messageLogged(org.apache.tools.ant.BuildEvent event)

Logs a message, if the priority is suitable. In non-emacs mode, task level messages are prefixed by the task name which is right-justified.

Specified by:

messageLogged in interface org.apache.tools.ant.BuildListener

Parameters:

event - A BuildEvent containing message information. Must not be null.

formatTime

protected static java.lang.String formatTime(long millis)

Convenience method to format a specified length of time.

Parameters:

millis - Length of time to format, in milliseonds.

Returns:

the time as a formatted string.

See Also:

DateUtils.formatElapsedTime(long)

printMessage

protected void printMessage(java.lang.String message,
                            java.io.PrintWriter stream,
                            int priority)

Prints a message to a PrintWriter.

Parameters:

message - The message to print. Should not be null.

stream - A PrintWriter to print the message to. Must not be null.

priority - The priority of the message. (Ignored in this implementation.)

log

protected void log(java.lang.String message)

Empty implementation which allows subclasses to receive the same output that is generated here.

Parameters:

message - Message being logged. Should not be null.