io.jenkins.plugins.forensics.blame

Class FileLocations

java.lang.Object

io.jenkins.plugins.forensics.util.FilteredLog

io.jenkins.plugins.forensics.blame.FileLocations

All Implemented Interfaces:

Serializable

public class FileLocations
extends FilteredLog

Defines a set of file locations. A file location is identified by the file name (relative to the workspace location) and line number. File locations are grouped by file name, i.e. you can obtain a mapping of a file to all affected lines in that file.

Author:

Ullrich Hafner

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileLocations.FileSystem File system facade for test cases.

Constructor Summary

Constructors

Constructor and Description
FileLocations(File workspace) Creates a new instance of FileLocations.
FileLocations(String workspace) Creates a new instance of FileLocations.
FileLocations(String workspace, FileLocations.FileSystem fileSystem) Creates a new instance of FileLocations.

Method Summary

Modifier and Type	Method and Description
void	addLine(String fileName, int lineStart) Adds the specified affected file and line number.
boolean	contains(String fileName) Returns whether the specified file has been added.
Set<String>	getAbsolutePaths() Returns the absolute file names of all files.
Set<Integer>	getLines(String fileName) Returns the added lines for the specified file.
Set<String>	getRelativePaths() Returns the relative file names of all files.
Set<String>	getSkippedFiles()
String	getWorkspace()
boolean	isEmpty() Returns whether some files have been added.
int	size() Returns the number of files that have been added.

Methods inherited from class io.jenkins.plugins.forensics.util.FilteredLog

getErrorMessages, getInfoMessages, logError, logException, logInfo, logSummary

Methods inherited from class java.lang.Object

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

Constructor Detail

FileLocations

public FileLocations(String workspace)

Creates a new instance of FileLocations.

Parameters:

workspace - the workspace to get the Git repository from

FileLocations

public FileLocations(File workspace)

Creates a new instance of FileLocations.

Parameters:

workspace - the workspace to get the Git repository from

FileLocations

public FileLocations(String workspace,
                     FileLocations.FileSystem fileSystem)

Creates a new instance of FileLocations.

Parameters:

workspace - the workspace to get the Git repository from

fileSystem - file system stub

Method Detail

getWorkspace

public String getWorkspace()

getSkippedFiles

public Set<String> getSkippedFiles()

addLine

public void addLine(String fileName,
                    int lineStart)

Adds the specified affected file and line number. This file and line will be processed by Git blame later on. Only files that are part of the workspace will be processed.

Parameters:

fileName - the absolute file name that will be used as a key

lineStart - the line number to find the blame for

isEmpty

public boolean isEmpty()

Returns whether some files have been added.

Returns:

true if there a no blames available, false otherwise

size

public int size()

Returns the number of files that have been added.

Overrides:

size in class FilteredLog

Returns:

number of affected files with blames

contains

public boolean contains(String fileName)

Returns whether the specified file has been added.

Parameters:

fileName - the relative or absolute path of the file

Returns:

true if the file already has been added, false otherwise

getRelativePaths

public Set<String> getRelativePaths()

Returns the relative file names of all files.

Returns:

the relative file names

getAbsolutePaths

public Set<String> getAbsolutePaths()

Returns the absolute file names of all files.

Returns:

the absolute file names

getLines

public Set<Integer> getLines(String fileName)

Returns the added lines for the specified file.

Parameters:

fileName - the relative or absolute path of the file

Returns:

the lines for that file

Throws:

NoSuchElementException - if the file name is not registered