Modifier and Type	Class and Description
pack-priv static class	FileReftableStack.CompactionStats
pack-priv static class	FileReftableStack.Segment A segment is a consecutive list of reftables of the same approximate size.
private static class	FileReftableStack.StackEntry
public static interface	FileReftableStack.Writer Writer is a callable that writes data to a reftable under construction.

Modifier and Type	Field and Description
private final Supplier<Config>	configSupplier
private long	lastNextUpdateIndex
private MergedReftable	mergedReftable
private final Runnable	onChange
private static long	OVERHEAD
private final SecureRandom	random
private final File	reftableDir
private AtomicReference<FileSnapshot>	snapshot
private List<FileReftableStack.StackEntry>	stack
private final File	stackPath
private final FileReftableStack.CompactionStats	stats
private final CoreConfig.TrustStat	trustTablesListStat

Access	Constructor and Description
public	FileReftableStack(File the filename for the stack. stackPath, File the dir holding the tables. reftableDir, Runnable hook to call if we notice a new write onChange, Supplier<Config> Config supplier configSupplier) Creates a stack corresponding to the list of reftables in the argument

Method Summary

Modifier and Type	Method and Description
public boolean	Returns: true if the transaction was successful. addReftable(FileReftableStack.Writer writer to write data to a reftable under construction w) Tries to add a new reftable to the stack.
private void	autoCompact() Heuristically tries to compact the stack if the stack has a suitable shape.
private static Optional<FileReftableStack.Segment>	autoCompactCandidate(long[] sizes)
public void	close() Implements java.lang.AutoCloseable.close. Closes this resource, relinquishing any underlying resources.
pack-priv void	compactFully()
private File	Returns: the file holding the replacement table. compactLocked(int index of first stack entry to be written first, int index of last stack entry to be written last) Write the reftable for the given range into a temp file.
pack-priv boolean	Returns: true if a compaction was successfully applied. compactRange(int index of first stack entry to be considered in compaction first, int index of last stack entry to be considered in compaction last) Compacts a range of the stack, following the file locking protocol documented in the spec.
private String	filename(long low, long high)
public MergedReftable	Returns: the merged reftable getMergedReftable() Get merged reftable
pack-priv FileReftableStack.CompactionStats	getStats()
pack-priv boolean	Returns: true if the on-disk file corresponds to the in-memory data. isUpToDate()
pack-priv static int	Returns: log2 log(long the number to compute an approximate log2 for sz) Calculate an approximate log2.
private long	nextUpdateIndex()
private List<String>	readTableNames()
private ReftableConfig	reftableConfig()
pack-priv void	reload()
private void	reloadOnce(List<String> holds the names of the tables to load. names) Reloads the stack, potentially reusing opened reftableReaders.
pack-priv static List<FileReftableStack.Segment>	segmentSizes(long[] sizes)
private long[]	tableSizes()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

configSupplier	back to summary
private final Supplier<Config> configSupplier

lastNextUpdateIndex	back to summary
private long lastNextUpdateIndex

mergedReftable	back to summary
private MergedReftable mergedReftable

onChange	back to summary
private final Runnable onChange

OVERHEAD	back to summary
private static long OVERHEAD

random	back to summary
private final SecureRandom random

reftableDir	back to summary
private final File reftableDir

snapshot	back to summary
private AtomicReference<FileSnapshot> snapshot

stack	back to summary
private List<FileReftableStack.StackEntry> stack

stackPath	back to summary
private final File stackPath

stats	back to summary
private final FileReftableStack.CompactionStats stats

trustTablesListStat	back to summary
private final CoreConfig.TrustStat trustTablesListStat

FileReftableStack	back to summary
public FileReftableStack(File stackPath, File reftableDir, Runnable onChange, Supplier<Config> configSupplier) throws IOException Creates a stack corresponding to the list of reftables in the argument Parameters stackPath:File the filename for the stack. reftableDir:File the dir holding the tables. onChange:Runnable hook to call if we notice a new write configSupplier:Supplier<Config> Config supplier Exceptions IOException: on I/O problems

Method Detail

addReftable	back to summary
public boolean addReftable(FileReftableStack.Writer w) throws IOException Tries to add a new reftable to the stack. Returns true if it succeeded, or false if there was a lock failure, due to races with other processes. This is package private so FileReftableDatabase can call into here. Parameters w:FileReftableStack.Writer writer to write data to a reftable under construction Returns:boolean true if the transaction was successful. Annotations @SuppressWarnings:nls Exceptions IOException: on I/O problems

addReftable

back to summary

public boolean addReftable(FileReftableStack.Writer w) throws IOException

Tries to add a new reftable to the stack. Returns true if it succeeded, or false if there was a lock failure, due to races with other processes. This is package private so FileReftableDatabase can call into here.

Parameters

w:FileReftableStack.Writer: writer to write data to a reftable under construction

Returns:boolean

true if the transaction was successful.

Annotations

@SuppressWarnings:nls

Exceptions

IOException:: on I/O problems

autoCompact	back to summary
private void autoCompact() throws IOException Heuristically tries to compact the stack if the stack has a suitable shape. Exceptions IOException: if an IO error occurred

autoCompact

back to summary

private void autoCompact() throws IOException

Heuristically tries to compact the stack if the stack has a suitable shape.

Exceptions

IOException:: if an IO error occurred

autoCompactCandidate	back to summary
private static Optional<FileReftableStack.Segment> autoCompactCandidate(long[] sizes)

close back to summary

close	back to summary
public void close() Implements java.lang.AutoCloseable.close. Doc from java.lang.AutoCloseable.close. Closes this resource, relinquishing any underlying resources. This method is invoked automatically on objects managed by the `try`-with-resources statement. Annotations @Override

public void close()

Implements java.lang.AutoCloseable.close.

Doc from java.lang.AutoCloseable.close.

Closes this resource, relinquishing any underlying resources. This method is invoked automatically on objects managed by the try-with-resources statement.

Annotations

@Override

compactFully	back to summary
pack-priv void compactFully() throws IOException

compactLocked	back to summary
private File compactLocked(int first, int last) throws IOException Write the reftable for the given range into a temp file. Parameters first:int index of first stack entry to be written last:int index of last stack entry to be written Returns:File the file holding the replacement table. Exceptions IOException: on I/O problem

compactLocked

back to summary

private File compactLocked(int first, int last) throws IOException

Write the reftable for the given range into a temp file.

Parameters

first:int: index of first stack entry to be written
last:int: index of last stack entry to be written

Returns:File

the file holding the replacement table.

Exceptions

IOException:: on I/O problem

compactRange	back to summary
pack-priv boolean compactRange(int first, int last) throws IOException Compacts a range of the stack, following the file locking protocol documented in the spec. Parameters first:int index of first stack entry to be considered in compaction last:int index of last stack entry to be considered in compaction Returns:boolean true if a compaction was successfully applied. Exceptions IOException: on I/O problem

compactRange

back to summary

pack-priv boolean compactRange(int first, int last) throws IOException

Compacts a range of the stack, following the file locking protocol documented in the spec.

Parameters

first:int: index of first stack entry to be considered in compaction
last:int: index of last stack entry to be considered in compaction

Returns:boolean

true if a compaction was successfully applied.

Exceptions

IOException:: on I/O problem

filename	back to summary
private String filename(long low, long high)

getMergedReftable	back to summary
public MergedReftable getMergedReftable() Get merged reftable Returns:MergedReftable the merged reftable

getMergedReftable

back to summary

public MergedReftable getMergedReftable()

Get merged reftable

Returns:MergedReftable: the merged reftable

getStats	back to summary
pack-priv FileReftableStack.CompactionStats getStats()

isUpToDate	back to summary
pack-priv boolean isUpToDate() throws IOException Returns:boolean true if the on-disk file corresponds to the in-memory data. Exceptions IOException: on IO problem

log	back to summary
pack-priv static int log(long sz) Calculate an approximate log2. Parameters sz:long the number to compute an approximate log2 for Returns:int log2

log

back to summary

pack-priv static int log(long sz)

Calculate an approximate log2.

Parameters

sz:long: the number to compute an approximate log2 for

Returns:int

log2

nextUpdateIndex	back to summary
private long nextUpdateIndex() throws IOException

readTableNames	back to summary
private List<String> readTableNames() throws IOException

reftableConfig	back to summary
private ReftableConfig reftableConfig()

reload	back to summary
pack-priv void reload() throws IOException

reloadOnce	back to summary
private void reloadOnce(List<String> names) throws IOException, FileNotFoundException Reloads the stack, potentially reusing opened reftableReaders. Parameters names:List<String> holds the names of the tables to load. Exceptions IOException: on other IO errors. FileNotFoundException: load must be retried.

reloadOnce

back to summary

private void reloadOnce(List<String> names) throws IOException, FileNotFoundException

Reloads the stack, potentially reusing opened reftableReaders.

Parameters

names:List<String>: holds the names of the tables to load.

Exceptions

IOException:: on other IO errors.
FileNotFoundException:: load must be retried.

segmentSizes	back to summary
pack-priv static List<FileReftableStack.Segment> segmentSizes(long[] sizes)

tableSizes	back to summary
private long[] tableSizes() throws IOException

org.eclipse.jgit.internal.storage.file back to summary

pack-priv Class FileReftableStack.CompactionStats

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jgit.internal.storage.file.FileReftableStack.CompactionStats

Field Summary

Modifier and Type	Field and Description
pack-priv int	attempted
pack-priv long	bytes
pack-priv int	failed
pack-priv long	logCount
pack-priv long	refCount
pack-priv long	tables

Constructor Summary

Access	Constructor and Description
pack-priv	CompactionStats()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

attempted	back to summary
pack-priv int attempted

bytes	back to summary
pack-priv long bytes

failed	back to summary
pack-priv int failed

logCount	back to summary
pack-priv long logCount

refCount	back to summary
pack-priv long refCount

tables	back to summary
pack-priv long tables

Constructor Detail

CompactionStats	back to summary
pack-priv CompactionStats()

org.eclipse.jgit.internal.storage.file back to summary

pack-priv Class FileReftableStack.Segment

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jgit.internal.storage.file.FileReftableStack.Segment

A segment is a consecutive list of reftables of the same approximate size.

Field Summary

Modifier and Type	Field and Description
pack-priv long	bytes
pack-priv int	end
pack-priv int	log
pack-priv int	start

Constructor Summary

Access	Constructor and Description
pack-priv	Segment(int start, int end, int log, long bytes)
pack-priv	Segment()

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object the reference object with which to compare. other) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
pack-priv int	size()
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

bytes	back to summary
pack-priv long bytes

end	back to summary
pack-priv int end

log	back to summary
pack-priv int log

start	back to summary
pack-priv int start

Constructor Detail

Segment	back to summary
pack-priv Segment(int start, int end, int log, long bytes)

Segment	back to summary
pack-priv Segment()

Method Detail

equals back to summary

public boolean equals(Object other)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

other:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

hashCode back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object

Annotations

@Override

size	back to summary
pack-priv int size()

toString back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@SuppressWarnings:boxing
@Override

public Class FileReftableStack

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class FileReftableStack.CompactionStats

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

pack-priv Class FileReftableStack.Segment

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class FileReftableStack.StackEntry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

public Interface FileReftableStack.Writer

Method Summary

Method Detail