Class FileModeCache

java.lang.Object

org.eclipse.jgit.lib.FileModeCache

public class FileModeCache
extends Object

A hierarchical cache of FileModes per git path.

Since:

6.6.1

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FileModeCache.CacheItem	An item from a FileModeCache, recording information about a git path (known from context).

Field Summary

Fields

Modifier and Type	Field	Description
private final Repository	repo
private final FileModeCache.CacheItem	root

Constructor Summary

Constructors

Constructor	Description
FileModeCache(Repository repo)	Creates a new FileModeCache for a Repository.

Method Summary

Modifier and Type	Method	Description
private FileModeCache.CacheItem	add(String gitPath, FileMode finalMode)	Records the given FileMode for the given git path in the cache.
private void	deleteSymlinkParent(FS fs, String gitPath, File workingTree)
Repository	getRepository()	Retrieves the Repository.
FileModeCache.CacheItem	getRoot()	Obtains the FileModeCache.CacheItem for the working tree root.
FileModeCache.CacheItem	safeCreateDirectory(String gitPath, File dir, boolean makeSpace)	Ensures the given directory dir with the given git path exists.
void	safeCreateParentDirectory(String gitPath, File parentDir, boolean makeSpace)	Ensure that the given parent directory exists, and cache the information that gitPath refers to a file.

Methods inherited from class Object

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

Field Details

root

@NonNull
private final FileModeCache.CacheItem root

repo

@NonNull
private final Repository repo

Constructor Details

FileModeCache

public FileModeCache(@NonNull
 Repository repo)

Creates a new FileModeCache for a Repository.

Parameters:

repo - Repository this cache is for

Method Details

getRepository

@NonNull
public Repository getRepository()

Retrieves the Repository.

Returns:

the Repository this FileModeCache was created for

getRoot

@NonNull
public FileModeCache.CacheItem getRoot()

Obtains the FileModeCache.CacheItem for the working tree root.

Returns:

the FileModeCache.CacheItem

safeCreateParentDirectory

public void safeCreateParentDirectory(String gitPath,
 File parentDir,
 boolean makeSpace)
                               throws IOException

Ensure that the given parent directory exists, and cache the information that gitPath refers to a file.

Parameters:

gitPath - of the file to be written

parentDir - directory in which the file shall be placed, assumed to be the parent of the gitPath

makeSpace - whether to delete a possibly existing file at parentDir

Throws:

IOException - if the directory cannot be created, if necessary

safeCreateDirectory

public FileModeCache.CacheItem safeCreateDirectory(String gitPath,
 File dir,
 boolean makeSpace)
                                            throws IOException

Ensures the given directory dir with the given git path exists.

Parameters:

gitPath - of a file to be written

dir - directory in which the file shall be placed, assumed to be the parent of the gitPath

makeSpace - whether to remove a file that already at that name

Returns:

A FileModeCache.CacheItem describing the directory, which is guaranteed to exist

Throws:

IOException - if the directory cannot be made to exist at the given location

deleteSymlinkParent

private void deleteSymlinkParent(FS fs,
 String gitPath,
 File workingTree)
                          throws IOException

Throws:

IOException

add

@NonNull
private FileModeCache.CacheItem add(String gitPath,
 FileMode finalMode)

Records the given FileMode for the given git path in the cache. If an entry already exists for the given path, the previously cached file mode is overwritten.

Parameters:

gitPath - to cache the FileMode for

finalMode - FileMode to cache

Returns:

the FileModeCache.CacheItem for the path