com.atlassian.bamboo.build.logger

Class AbstractBuildLogger

java.lang.Object

com.atlassian.bamboo.build.logger.AbstractBuildLogger

All Implemented Interfaces:

BuildLogger

Direct Known Subclasses:

BuildLoggerImpl, RemoteBuildLogger

public abstract class AbstractBuildLogger
extends Object
implements BuildLogger

Constructor Summary

Constructors

Constructor and Description
AbstractBuildLogger(String linePrefix)

Method Summary

Modifier and Type	Method and Description
String	addBuildLogEntry(LogEntry logEntry) Add a new build log entry.
String	addBuildLogEntry(String logString) Create a new build log entry from text to append to logs
String	addBuildLogHeader(String logString, boolean showBothBanner)
String	addErrorLogEntry(LogEntry logEntry) Add a new build error log entry.
String	addErrorLogEntry(String logString) Add a new build error log entry from text.
void	addErrorLogEntry(String logString, Throwable e) Adds an error log entry and each frame of the stack trace as a new error log entry
protected String	addErrorLogEntryInternal(LogEntry logEntry)
protected String	addLogEntry(LogEntry logEntry)
void	clearBuildLog() Reset the build log, ready for the next build
void	close()
List<LogEntry>	getBuildLog() Provide the latest build details (last 100 lines of logs).
List<LogEntry>	getErrorLog() Provide the latest error logs.
LogInterceptorStack	getInterceptorStack()
List<LogEntry>	getLastNLogEntries(int n) Provide the latest build details (last n lines of logs).
LogMutatorStack	getMutatorStack()
List<String>	getStringErrorLogs()
long	getTimeOfLastLog() last time a log entry was added.
protected LogEntry	interceptAndMutate(LogEntry logEntry)
protected LogEntry	interceptAndMutateError(LogEntry logEntry)
abstract void	onAddLogEntry(LogEntry logEntry)
abstract void	stopStreamingBuildLogs() Stop streaming any logs to the build logs file

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractBuildLogger

public AbstractBuildLogger(String linePrefix)

Method Detail

onAddLogEntry

public abstract void onAddLogEntry(@NotNull
                                   LogEntry logEntry)

stopStreamingBuildLogs

public abstract void stopStreamingBuildLogs()

Description copied from interface: BuildLogger

Stop streaming any logs to the build logs file

Specified by:

stopStreamingBuildLogs in interface BuildLogger

getBuildLog

@NotNull
public List<LogEntry> getBuildLog()

Description copied from interface: BuildLogger

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

Specified by:

getBuildLog in interface BuildLogger

Returns:

The list of LogEntrys.

getErrorLog

@NotNull
public List<LogEntry> getErrorLog()

Description copied from interface: BuildLogger

Provide the latest error logs. This is not persisted

Specified by:

getErrorLog in interface BuildLogger

Returns:

The list of LogEntrys.

getLastNLogEntries

@NotNull
public List<LogEntry> getLastNLogEntries(int n)

Description copied from interface: BuildLogger

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

Specified by:

getLastNLogEntries in interface BuildLogger

Returns:

The list of LogEntrys.

getStringErrorLogs

@NotNull
public List<String> getStringErrorLogs()

Specified by:

getStringErrorLogs in interface BuildLogger

addBuildLogEntry

@NotNull
public String addBuildLogEntry(@NotNull
                                        LogEntry logEntry)

Description copied from interface: BuildLogger

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

Specified by:

addBuildLogEntry in interface BuildLogger

Parameters:

logEntry - The data being logged

Returns:

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

addErrorLogEntry

@NotNull
public String addErrorLogEntry(@NotNull
                                        LogEntry logEntry)

Description copied from interface: BuildLogger

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

Specified by:

addErrorLogEntry in interface BuildLogger

Parameters:

logEntry - The data being logged

Returns:

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

addErrorLogEntryInternal

protected String addErrorLogEntryInternal(@NotNull
                                          LogEntry logEntry)

interceptAndMutate

@NotNull
protected LogEntry interceptAndMutate(@NotNull
                                               LogEntry logEntry)

interceptAndMutateError

@NotNull
protected LogEntry interceptAndMutateError(@NotNull
                                                    LogEntry logEntry)

addLogEntry

@NotNull
protected String addLogEntry(@NotNull
                                      LogEntry logEntry)

addBuildLogEntry

@NotNull
public String addBuildLogEntry(@NotNull
                                        String logString)

Description copied from interface: BuildLogger

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

Specified by:

addBuildLogEntry in interface BuildLogger

Parameters:

logString - text to create log entry from

Returns:

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

addErrorLogEntry

@NotNull
public String addErrorLogEntry(String logString)

Description copied from interface: BuildLogger

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.

Specified by:

addErrorLogEntry in interface BuildLogger

Parameters:

logString - The text to create log entry from

Returns:

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

addErrorLogEntry

public void addErrorLogEntry(String logString,
                             @Nullable
                             Throwable e)

Description copied from interface: BuildLogger

Adds an error log entry and each frame of the stack trace as a new error log entry

Specified by:

addErrorLogEntry in interface BuildLogger

addBuildLogHeader

@NotNull
public String addBuildLogHeader(String logString,
                                         boolean showBothBanner)

Specified by:

addBuildLogHeader in interface BuildLogger

clearBuildLog

public void clearBuildLog()

Description copied from interface: BuildLogger

Reset the build log, ready for the next build

Specified by:

clearBuildLog in interface BuildLogger

getTimeOfLastLog

public long getTimeOfLastLog()

Description copied from interface: BuildLogger

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

Specified by:

getTimeOfLastLog in interface BuildLogger

Returns:

getInterceptorStack

@NotNull
public LogInterceptorStack getInterceptorStack()

Specified by:

getInterceptorStack in interface BuildLogger

Returns:

stack of log interceptors attached to this build logger

getMutatorStack

@NotNull
public LogMutatorStack getMutatorStack()

Specified by:

getMutatorStack in interface BuildLogger

Returns:

stack of log mutators attached to this build logger

close

public void close()

Specified by:

close in interface BuildLogger