com.atlassian.bamboo.build.logger
Interface BuildLogger

All Known Implementing Classes:

BuildLoggerImpl, NullBuildLogger, RemoteBuildLogger, SimpleBuildLogger

public interface BuildLogger

This interface represents a logger for a given build

Method Summary

java.lang.String	addBuildLogEntry(LogEntry logEntry) Add a new build log entry.
java.lang.String	addBuildLogEntry(java.lang.String logString) Create a new build log entry from text to append to logs
java.lang.String	addBuildLogHeader(java.lang.String logString, boolean showBothBanner)
java.lang.String	addErrorLogEntry(LogEntry logEntry) Add a new build error log entry.
java.lang.String	addErrorLogEntry(java.lang.String logString) Add a new build error log entry from text.
void	clearBuildLog() Reset the build log, ready for the next build
java.util.List<LogEntry>	getBuildLog() Provide the latest build details (last 100 lines of logs).
java.util.List<LogEntry>	getErrorLog() Provide the latest error logs.
java.util.List<java.lang.String>	getStringErrorLogs()
long	getTimeOfLastLog() last time a log entry was added.
void	startStreamingBuildLogs(int buildNum, java.lang.String planKey) Begin streaming any logs to build logs file
void	stopStreamingBuildLogs() Stop streaming any logs to the build logs file

Method Detail

getBuildLog

java.util.List<LogEntry> getBuildLog()

Provide the latest build details (last 100 lines of logs). This is not persisted.

Returns:

The list of LogEntrys. May return null.

getErrorLog

java.util.List<LogEntry> getErrorLog()

Provide the latest error logs. This is not persisted

Returns:

The list of LogEntrys. May return null.

getStringErrorLogs

java.util.List<java.lang.String> getStringErrorLogs()

addBuildLogEntry

java.lang.String addBuildLogEntry(LogEntry logEntry)

Add a new build log entry. This will get appended to the end of the log.

Parameters:

logEntry - The data being logged

Returns:

The line of text being logged. From LogEntry.getUnstyledLog().

addBuildLogEntry

java.lang.String addBuildLogEntry(java.lang.String logString)

Create a new build log entry from text to append to logs

Parameters:

logString - text to create log entry from

Returns:

The line of text being logged. From LogEntry.getUnstyledLog().

addBuildLogHeader

java.lang.String addBuildLogHeader(java.lang.String logString,
                                   boolean showBothBanner)

addErrorLogEntry

java.lang.String addErrorLogEntry(LogEntry logEntry)

Add a new build error log entry. This will get appended to the end of the log and to the end of the errors.

Parameters:

logEntry - The data being logged

Returns:

The line of text being logged. From LogEntry.getUnstyledLog().

addErrorLogEntry

java.lang.String addErrorLogEntry(java.lang.String logString)

Add a new build error log entry from text. This will get appended to the end of the log and to the end of the errors.

Parameters:

logString - The text to create log entry from

Returns:

The line of text being logged. From LogEntry.getUnstyledLog().

startStreamingBuildLogs

void startStreamingBuildLogs(int buildNum,
                             java.lang.String planKey)

Begin streaming any logs to build logs file

Parameters:

buildNum -

planKey -

stopStreamingBuildLogs

void stopStreamingBuildLogs()

Stop streaming any logs to the build logs file

clearBuildLog

void clearBuildLog()

Reset the build log, ready for the next build

getTimeOfLastLog

long getTimeOfLastLog()

last time a log entry was added. If no logs, returns 0

Returns: