org.eclipse.jgit.internal.storage.file

Class ObjectDirectory

java.lang.Object

org.eclipse.jgit.lib.ObjectDatabase

org.eclipse.jgit.internal.storage.file.FileObjectDatabase

org.eclipse.jgit.internal.storage.file.ObjectDirectory

public class ObjectDirectory
extends FileObjectDatabase

Traditional file system based ObjectDatabase.

This is the classical object database representation for a Git repository, where objects are stored loose by hashing them into directories by their ObjectId, or are stored in compressed containers known as PackFiles.

Optionally an object database can reference one or more alternates; other ObjectDatabase instances that are searched in addition to the current database.

Databases are divided into two halves: a half that is considered to be fast to search (the PackFiles), and a half that is considered to be slow to search (loose objects). When alternates are present the fast half is fully searched (recursively through all alternates) before the slow half is considered.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	ObjectDirectory.AlternateHandle
(package private) static class	ObjectDirectory.AlternateRepository
private static class	ObjectDirectory.PackList

Nested classes/interfaces inherited from class org.eclipse.jgit.internal.storage.file.FileObjectDatabase

FileObjectDatabase.InsertLooseObjectResult

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.concurrent.atomic.AtomicReference<ObjectDirectory.AlternateHandle[]>	alternates
private java.io.File	alternatesFile
private Config	config
private FS	fs
private ObjectDirectory.AlternateHandle	handle
private java.io.File	infoDirectory
private static org.slf4j.Logger	LOG
private static ObjectDirectory.PackList	NO_PACKS
private java.io.File	objects
private java.io.File	packDirectory
private java.util.concurrent.atomic.AtomicReference<ObjectDirectory.PackList>	packList
private java.io.File	preservedDirectory
private static int	RESOLVE_ABBREV_LIMIT Maximum number of candidates offered as resolutions of abbreviation.
private java.util.Set<ObjectId>	shallowCommitsIds
private java.io.File	shallowFile
private FileSnapshot	shallowFileSnapshot
private UnpackedObjectCache	unpackedObjectCache

Constructor Summary

Constructors

Constructor and Description
ObjectDirectory(Config cfg, java.io.File dir, java.io.File[] alternatePaths, FS fs, java.io.File shallowFile) Initialize a reference to an on-disk object directory.

Method Summary

Modifier and Type	Method and Description
(package private) java.util.Set<ObjectDirectory.AlternateHandle.Id>	addMe(java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
void	close() Close any resources held by this database.
(package private) void	closeAllPackHandles(java.io.File packFile)
void	create() Initialize a new object database at this location.
private boolean	doLogExponentialBackoff(int n)
boolean	exists() Does this database exist yet?
java.io.File	fileFor(AnyObjectId objectId)
(package private) ObjectDirectory.AlternateHandle.Id	getAlternateId()
(package private) Config	getConfig()
java.io.File	getDirectory()
(package private) FS	getFS()
private long	getLooseObjectSize(WindowCursor curs, AnyObjectId id)
private long	getLooseSizeFromSelfOrAlternate(WindowCursor curs, AnyObjectId id, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
(package private) long	getObjectSize(WindowCursor curs, AnyObjectId id)
java.io.File	getPackDirectory() Getter for the field packDirectory.
private long	getPackedObjectSize(WindowCursor curs, AnyObjectId id)
private long	getPackedSizeFromSelfOrAlternate(WindowCursor curs, AnyObjectId id, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
java.util.Collection<PackFile>	getPacks()
java.io.File	getPreservedDirectory() Getter for the field preservedDirectory.
(package private) java.util.Set<ObjectId>	getShallowCommits()
private void	handlePackError(java.io.IOException e, PackFile p)
boolean	has(AnyObjectId objectId) Does the requested object exist in this database?
private boolean	hasLooseInSelfOrAlternate(AnyObjectId objectId, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
private boolean	hasPackedInSelfOrAlternate(AnyObjectId objectId, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
(package private) boolean	hasPackedObject(AnyObjectId objectId)
private static int	indexOf(PackFile[] list, PackFile pack)
private void	insertPack(PackFile pf)
(package private) FileObjectDatabase.InsertLooseObjectResult	insertUnpackedObject(java.io.File tmp, ObjectId id, boolean createDuplicate)
private java.util.Set<java.lang.String>	listPackDirectory()
private ObjectDirectory.AlternateHandle[]	loadAlternates()
(package private) ObjectDirectory.AlternateHandle[]	myAlternates()
ObjectDatabase	newCachedDatabase() Create a new cached database instance over this database.
(package private) CachedObjectDirectory	newCachedFileObjectDatabase()
ObjectDirectoryInserter	newInserter() Create a new ObjectInserter to insert new objects.
PackInserter	newPackInserter() Create a new inserter that inserts all objects as pack files, not loose objects.
private static java.io.BufferedReader	open(java.io.File f)
private ObjectDirectory.AlternateHandle	openAlternate(java.io.File objdir)
private ObjectDirectory.AlternateHandle	openAlternate(java.lang.String location)
private ObjectLoader	openLooseFromSelfOrAlternate(WindowCursor curs, AnyObjectId objectId, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
(package private) ObjectLoader	openLooseObject(WindowCursor curs, AnyObjectId id)
(package private) ObjectLoader	openObject(WindowCursor curs, AnyObjectId objectId)
PackFile	openPack(java.io.File pack)
private ObjectLoader	openPackedFromSelfOrAlternate(WindowCursor curs, AnyObjectId objectId, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
(package private) ObjectLoader	openPackedObject(WindowCursor curs, AnyObjectId objectId)
private void	removePack(PackFile deadPack)
(package private) void	resolve(java.util.Set<ObjectId> matches, AbbreviatedObjectId id)
private void	resolve(java.util.Set<ObjectId> matches, AbbreviatedObjectId id, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
private static java.util.Map<java.lang.String,PackFile>	reuseMap(ObjectDirectory.PackList old)
private ObjectDirectory.PackList	scanPacks(ObjectDirectory.PackList original)
private ObjectDirectory.PackList	scanPacksImpl(ObjectDirectory.PackList old)
private boolean	searchPacksAgain(ObjectDirectory.PackList old)
(package private) void	selectObjectRepresentation(PackWriter packer, ObjectToPack otp, WindowCursor curs)
private void	selectObjectRepresentation(PackWriter packer, ObjectToPack otp, WindowCursor curs, java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
java.lang.String	toString()

Methods inherited from class org.eclipse.jgit.internal.storage.file.FileObjectDatabase

newReader

Methods inherited from class org.eclipse.jgit.lib.ObjectDatabase

open, open

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

NO_PACKS

private static final ObjectDirectory.PackList NO_PACKS

RESOLVE_ABBREV_LIMIT

private static final int RESOLVE_ABBREV_LIMIT

Maximum number of candidates offered as resolutions of abbreviation.

See Also:

Constant Field Values

handle

private final ObjectDirectory.AlternateHandle handle

config

private final Config config

objects

private final java.io.File objects

infoDirectory

private final java.io.File infoDirectory

packDirectory

private final java.io.File packDirectory

preservedDirectory

private final java.io.File preservedDirectory

alternatesFile

private final java.io.File alternatesFile

packList

private final java.util.concurrent.atomic.AtomicReference<ObjectDirectory.PackList> packList

fs

private final FS fs

alternates

private final java.util.concurrent.atomic.AtomicReference<ObjectDirectory.AlternateHandle[]> alternates

unpackedObjectCache

private final UnpackedObjectCache unpackedObjectCache

shallowFile

private final java.io.File shallowFile

shallowFileSnapshot

private FileSnapshot shallowFileSnapshot

shallowCommitsIds

private java.util.Set<ObjectId> shallowCommitsIds

Constructor Detail

ObjectDirectory

public ObjectDirectory(Config cfg,
                       java.io.File dir,
                       java.io.File[] alternatePaths,
                       FS fs,
                       java.io.File shallowFile)
                throws java.io.IOException

Initialize a reference to an on-disk object directory.

Parameters:

cfg - configuration this directory consults for write settings.

dir - the location of the objects directory.

alternatePaths - a list of alternate object directories

fs - the file system abstraction which will be necessary to perform certain file system operations.

shallowFile - file which contains IDs of shallow commits, null if shallow commits handling should be turned off

Throws:

java.io.IOException - an alternate object cannot be opened.

Method Detail

getDirectory

public final java.io.File getDirectory()

Specified by:

getDirectory in class FileObjectDatabase

getPackDirectory

public final java.io.File getPackDirectory()

Getter for the field packDirectory.

Returns:

the location of the pack directory.

Since:

4.10

getPreservedDirectory

public final java.io.File getPreservedDirectory()

Getter for the field preservedDirectory.

Returns:

the location of the preserved directory.

exists

public boolean exists()

Does this database exist yet?

Overrides:

exists in class ObjectDatabase

Returns:

true if this database is already created; false if the caller should invoke ObjectDatabase.create() to create this database location.

create

public void create()
            throws java.io.IOException

Initialize a new object database at this location.

Overrides:

create in class ObjectDatabase

Throws:

java.io.IOException - the database could not be created.

newInserter

public ObjectDirectoryInserter newInserter()

Create a new ObjectInserter to insert new objects.

The returned inserter is not itself thread-safe, but multiple concurrent inserter instances created from the same ObjectDatabase must be thread-safe.

Overrides:

newInserter in class FileObjectDatabase

Returns:

writer the caller can use to create objects in this database.

newPackInserter

public PackInserter newPackInserter()

Create a new inserter that inserts all objects as pack files, not loose objects.

Returns:

new inserter.

close

public void close()

Close any resources held by this database.

Specified by:

close in class ObjectDatabase

getPacks

public java.util.Collection<PackFile> getPacks()

Specified by:

getPacks in class FileObjectDatabase

openPack

public PackFile openPack(java.io.File pack)
                  throws java.io.IOException

Add a single existing pack to the list of available pack files.

Specified by:

openPack in class FileObjectDatabase

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

has

public boolean has(AnyObjectId objectId)

Does the requested object exist in this database?

This is a one-shot call interface which may be faster than allocating a ObjectDatabase.newReader() to perform the lookup.

Overrides:

has in class ObjectDatabase

Parameters:

objectId - identity of the object to test for existence of.

Returns:

true if the specified object is stored in this database.

hasPackedInSelfOrAlternate

private boolean hasPackedInSelfOrAlternate(AnyObjectId objectId,
                                           java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)

hasLooseInSelfOrAlternate

private boolean hasLooseInSelfOrAlternate(AnyObjectId objectId,
                                          java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)

hasPackedObject

boolean hasPackedObject(AnyObjectId objectId)

resolve

void resolve(java.util.Set<ObjectId> matches,
             AbbreviatedObjectId id)
      throws java.io.IOException

Specified by:

resolve in class FileObjectDatabase

Throws:

java.io.IOException

resolve

private void resolve(java.util.Set<ObjectId> matches,
                     AbbreviatedObjectId id,
                     java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
              throws java.io.IOException

Throws:

java.io.IOException

openObject

ObjectLoader openObject(WindowCursor curs,
                        AnyObjectId objectId)
                 throws java.io.IOException

Specified by:

openObject in class FileObjectDatabase

Throws:

java.io.IOException

openPackedFromSelfOrAlternate

private ObjectLoader openPackedFromSelfOrAlternate(WindowCursor curs,
                                                   AnyObjectId objectId,
                                                   java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)

openLooseFromSelfOrAlternate

private ObjectLoader openLooseFromSelfOrAlternate(WindowCursor curs,
                                                  AnyObjectId objectId,
                                                  java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
                                           throws java.io.IOException

Throws:

java.io.IOException

openPackedObject

ObjectLoader openPackedObject(WindowCursor curs,
                              AnyObjectId objectId)

openLooseObject

ObjectLoader openLooseObject(WindowCursor curs,
                             AnyObjectId id)
                      throws java.io.IOException

Specified by:

openLooseObject in class FileObjectDatabase

Throws:

java.io.IOException

getObjectSize

long getObjectSize(WindowCursor curs,
                   AnyObjectId id)
            throws java.io.IOException

Specified by:

getObjectSize in class FileObjectDatabase

Throws:

java.io.IOException

getPackedSizeFromSelfOrAlternate

private long getPackedSizeFromSelfOrAlternate(WindowCursor curs,
                                              AnyObjectId id,
                                              java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)

getLooseSizeFromSelfOrAlternate

private long getLooseSizeFromSelfOrAlternate(WindowCursor curs,
                                             AnyObjectId id,
                                             java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
                                      throws java.io.IOException

Throws:

java.io.IOException

getPackedObjectSize

private long getPackedObjectSize(WindowCursor curs,
                                 AnyObjectId id)

getLooseObjectSize

private long getLooseObjectSize(WindowCursor curs,
                                AnyObjectId id)
                         throws java.io.IOException

Throws:

java.io.IOException

selectObjectRepresentation

void selectObjectRepresentation(PackWriter packer,
                                ObjectToPack otp,
                                WindowCursor curs)
                         throws java.io.IOException

Specified by:

selectObjectRepresentation in class FileObjectDatabase

Throws:

java.io.IOException

selectObjectRepresentation

private void selectObjectRepresentation(PackWriter packer,
                                        ObjectToPack otp,
                                        WindowCursor curs,
                                        java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)
                                 throws java.io.IOException

Throws:

java.io.IOException

handlePackError

private void handlePackError(java.io.IOException e,
                             PackFile p)

doLogExponentialBackoff

private boolean doLogExponentialBackoff(int n)

Parameters:

n - count of consecutive failures

Returns:

@{code true} if i is a power of 2

insertUnpackedObject

FileObjectDatabase.InsertLooseObjectResult insertUnpackedObject(java.io.File tmp,
                                                                ObjectId id,
                                                                boolean createDuplicate)
                                                         throws java.io.IOException

Specified by:

insertUnpackedObject in class FileObjectDatabase

Throws:

java.io.IOException

searchPacksAgain

private boolean searchPacksAgain(ObjectDirectory.PackList old)

getConfig

Config getConfig()

Specified by:

getConfig in class FileObjectDatabase

getFS

FS getFS()

Specified by:

getFS in class FileObjectDatabase

getShallowCommits

java.util.Set<ObjectId> getShallowCommits()
                                   throws java.io.IOException

Specified by:

getShallowCommits in class FileObjectDatabase

Throws:

java.io.IOException

insertPack

private void insertPack(PackFile pf)

removePack

private void removePack(PackFile deadPack)

indexOf

private static int indexOf(PackFile[] list,
                           PackFile pack)

scanPacks

private ObjectDirectory.PackList scanPacks(ObjectDirectory.PackList original)

scanPacksImpl

private ObjectDirectory.PackList scanPacksImpl(ObjectDirectory.PackList old)

reuseMap

private static java.util.Map<java.lang.String,PackFile> reuseMap(ObjectDirectory.PackList old)

listPackDirectory

private java.util.Set<java.lang.String> listPackDirectory()

closeAllPackHandles

void closeAllPackHandles(java.io.File packFile)

myAlternates

ObjectDirectory.AlternateHandle[] myAlternates()

addMe

java.util.Set<ObjectDirectory.AlternateHandle.Id> addMe(java.util.Set<ObjectDirectory.AlternateHandle.Id> skips)

loadAlternates

private ObjectDirectory.AlternateHandle[] loadAlternates()
                                                  throws java.io.IOException

Throws:

java.io.IOException

open

private static java.io.BufferedReader open(java.io.File f)
                                    throws java.io.FileNotFoundException

Throws:

java.io.FileNotFoundException

openAlternate

private ObjectDirectory.AlternateHandle openAlternate(java.lang.String location)
                                               throws java.io.IOException

Throws:

java.io.IOException

openAlternate

private ObjectDirectory.AlternateHandle openAlternate(java.io.File objdir)
                                               throws java.io.IOException

Throws:

java.io.IOException

fileFor

public java.io.File fileFor(AnyObjectId objectId)

Compute the location of a loose object file.

Specified by:

fileFor in class FileObjectDatabase

newCachedDatabase

public ObjectDatabase newCachedDatabase()

Create a new cached database instance over this database. This instance might optimize queries by caching some information about database. So some modifications done after instance creation might fail to be noticed.

Overrides:

newCachedDatabase in class ObjectDatabase

Returns:

new cached database instance

newCachedFileObjectDatabase

CachedObjectDirectory newCachedFileObjectDatabase()

getAlternateId

ObjectDirectory.AlternateHandle.Id getAlternateId()