org.eclipse.jgit.internal.storage.reftable

Class ReftableReader

java.lang.Object

org.eclipse.jgit.internal.storage.reftable.Reftable

org.eclipse.jgit.internal.storage.reftable.ReftableReader

All Implemented Interfaces:

AutoCloseable

public class ReftableReader
extends Reftable

Reads a reftable formatted file.

ReftableReader is not thread-safe. Concurrent readers need their own instance to read from the same file.

Field Summary

Fields inherited from class org.eclipse.jgit.internal.storage.reftable.Reftable

includeDeletes

Constructor Summary

Constructors

Constructor and Description
ReftableReader(BlockSource src) Initialize a new reftable reader.

Method Summary

Modifier and Type	Method and Description
LogCursor	allLogs() Seek reader to read log records.
RefCursor	allRefs() Seek to the first reference, to iterate in order.
int	blockSize() Get the block size in bytes chosen for this file by the writer.
RefCursor	byObjectId(AnyObjectId id) Match references pointing to a specific object.
void	close()
long	maxUpdateIndex() Get the maximum update index for log entries that appear in this reftable.
long	minUpdateIndex() Get the minimum update index for log entries that appear in this reftable.
LogCursor	seekLog(String refName, long updateIndex) Seek to an update index in a reference's log.
RefCursor	seekRef(String refName) Seek either to a reference, or a reference subtree.
long	size() Get size of the reftable, in bytes.

Methods inherited from class org.eclipse.jgit.internal.storage.reftable.Reftable

exactRef, from, hasId, hasRef, resolve, seekLog, setIncludeDeletes

Methods inherited from class java.lang.Object

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

Constructor Detail

ReftableReader

public ReftableReader(BlockSource src)

Initialize a new reftable reader.

Parameters:

src - the file content to read.

Method Detail

blockSize

public int blockSize()
              throws IOException

Get the block size in bytes chosen for this file by the writer.

Returns:

the block size in bytes chosen for this file by the writer. Most reads from the BlockSource will be aligned to the block size.

Throws:

IOException - file cannot be read.

minUpdateIndex

public long minUpdateIndex()
                    throws IOException

Get the minimum update index for log entries that appear in this reftable.

Returns:

the minimum update index for log entries that appear in this reftable. This should be 1 higher than the prior reftable's maxUpdateIndex if this table is used in a stack.

Throws:

IOException - file cannot be read.

maxUpdateIndex

public long maxUpdateIndex()
                    throws IOException

Get the maximum update index for log entries that appear in this reftable.

Returns:

the maximum update index for log entries that appear in this reftable. This should be 1 higher than the prior reftable's maxUpdateIndex if this table is used in a stack.

Throws:

IOException - file cannot be read.

allRefs

public RefCursor allRefs()
                  throws IOException

Seek to the first reference, to iterate in order.

Specified by:

allRefs in class Reftable

Returns:

cursor to iterate.

Throws:

IOException - if references cannot be read.

seekRef

public RefCursor seekRef(String refName)
                  throws IOException

Seek either to a reference, or a reference subtree.

If refName ends with "/" the method will seek to the subtree of all references starting with refName as a prefix. If no references start with this prefix, an empty cursor is returned.

Otherwise exactly refName will be looked for. If present, the returned cursor will iterate exactly one entry. If not found, an empty cursor is returned.

Specified by:

seekRef in class Reftable

Parameters:

refName - reference name or subtree to find.

Returns:

cursor to iterate; empty cursor if no references match.

Throws:

IOException - if references cannot be read.

byObjectId

public RefCursor byObjectId(AnyObjectId id)
                     throws IOException

Match references pointing to a specific object.

Specified by:

byObjectId in class Reftable

Parameters:

id - object to find.

Returns:

cursor to iterate; empty cursor if no references match.

Throws:

IOException - if references cannot be read.

allLogs

public LogCursor allLogs()
                  throws IOException

Seek reader to read log records.

Specified by:

allLogs in class Reftable

Returns:

cursor to iterate; empty cursor if no logs are present.

Throws:

IOException - if logs cannot be read.

seekLog

public LogCursor seekLog(String refName,
                         long updateIndex)
                  throws IOException

Seek to an update index in a reference's log.

Specified by:

seekLog in class Reftable

Parameters:

refName - exact name of the reference whose log to read.

updateIndex - most recent index to return first in the log cursor. Log records at or before updateIndex will be returned.

Returns:

cursor to iterate; empty cursor if no logs match.

Throws:

IOException - if logs cannot be read.

size

public long size()
          throws IOException

Get size of the reftable, in bytes.

Returns:

size of the reftable, in bytes.

Throws:

IOException - size cannot be obtained.

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in class Reftable

Throws:

IOException