com.atlassian.bamboo.build.logger
Class BuildLogFileAccessor

java.lang.Object
  com.atlassian.bamboo.build.logger.BuildLogFileAccessor

@NotThreadSafe
public class BuildLogFileAccessor
extends Object

This class provides a mechanism to perform operations on build log files. An accessor class must be instantiated for each build log file. Other notes: When using the file iterator, it is not thread safe. Be sure to open the file for iteration and close it once your done.

Field Summary

static String

ENCODING

Method Summary

void	closeFileForIteration() close the file iterator
List<LogEntry>	getLastNLogs(int numLogs) Retrives a List of the last N logs.
List<LogEntry>	getLastNLogsOfType(int numLogs, Collection<Class> types)
int	getNumberOfLinesInFile() Counts the number of lines in the file.
boolean	hasNext() Requires file to be opened for iteration
String	nextLine() Requires file to be opened for iteration
LogEntry	nextLogEntry() Requires file to be opened for iteration
boolean	openFileForIteration() Open the file contained within this accessor to perform iterations (must be called before the hasNext(), nextLogEntry() and nextLine()).
LogEntry	searchFileForEntry(String textToSearchFor, boolean searchInErrorMessages) Looks incrementally through the file to see if the specified text exists
LogEntry	searchFileForEntry(String textToSearchFor, int lastNLines, boolean searchInErrorMessages) Searchers for particular text within the last n lines of a file (eg search within the last 10 lines for a success message)

Methods inherited from class java.lang.Object

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

Field Detail

ENCODING

public static final String ENCODING

See Also:

Constant Field Values

Method Detail

openFileForIteration

public boolean openFileForIteration()

Open the file contained within this accessor to perform iterations (must be called before the hasNext(), nextLogEntry() and nextLine()).

Returns:

true if the opening of the file was successful, otherwise false.

closeFileForIteration

public void closeFileForIteration()

close the file iterator

hasNext

public boolean hasNext()

Requires file to be opened for iteration

Returns:

true if there is another line in the file, otherwise false

nextLogEntry

@Nullable
public LogEntry nextLogEntry()

Requires file to be opened for iteration

Returns:

The next line in the file as a LogEntry, null if no more lines

nextLine

@Nullable
public String nextLine()

Requires file to be opened for iteration

Returns:

The next line in the file as a String, null if no more lines

searchFileForEntry

@Nullable
public LogEntry searchFileForEntry(@Nullable
                                            String textToSearchFor,
                                            boolean searchInErrorMessages)
                            throws IOException

Looks incrementally through the file to see if the specified text exists

Parameters:

textToSearchFor - the specific text to search for

searchInErrorMessages - search also in error messages

Returns:

the LogEntry that the text was found in or null if the text was not found

Throws:

IOException - if there were errors accessing the file

searchFileForEntry

@Nullable
public LogEntry searchFileForEntry(@Nullable
                                            String textToSearchFor,
                                            int lastNLines,
                                            boolean searchInErrorMessages)
                            throws IOException

Searchers for particular text within the last n lines of a file (eg search within the last 10 lines for a success message)

Parameters:

textToSearchFor - String text to find in file

lastNLines - number of lines from end to search from

searchInErrorMessages - search also in error messages

Returns:

the LogEntry the text was found in or null if the text was not found

Throws:

IOException - if error closing the log file

getLastNLogs

public List<LogEntry> getLastNLogs(int numLogs)
                            throws IOException

Retrives a List of the last N logs. Avoid using this with large numbers as it has the potential to cause out of memory errors

Parameters:

numLogs - number of logs to retrive

Returns:

List of the last N LogEntry Objects in the file, may return an empty list

Throws:

IOException - if errors access the build log file

getLastNLogsOfType

public List<LogEntry> getLastNLogsOfType(int numLogs,
                                         Collection<Class> types)
                                  throws IOException

Throws:

IOException

getNumberOfLinesInFile

public int getNumberOfLinesInFile()
                           throws IOException

Counts the number of lines in the file.

Returns:

number of lines in file

Throws:

IOException - if errors accessing the file