public class EmptyTreeIterator extends AbstractTreeIterator
attributesNode, DEFAULT_PATH_SIZE, mode, parent, path, pathLen, pathOffset, zeroid
Constructor and Description |
---|
EmptyTreeIterator()
Create a new iterator with no parent.
|
EmptyTreeIterator(AbstractTreeIterator p,
byte[] childPath,
int childPathOffset)
Create an iterator for a subtree of an existing iterator.
|
Modifier and Type | Method and Description |
---|---|
void |
back(int delta)
Move to prior entry, populating this iterator with the entry data.
|
AbstractTreeIterator |
createSubtreeIterator(ObjectReader reader)
Create a new iterator for the current entry's subtree.
|
boolean |
eof()
Is this tree iterator at its EOF point (no more entries)?
|
boolean |
first()
Is this tree iterator positioned on its first entry?
|
ObjectId |
getEntryObjectId()
Get the object id of the current entry.
|
boolean |
hasId()
Whether the entry has a valid ObjectId.
|
byte[] |
idBuffer()
Get the byte array buffer object IDs must be copied out of.
|
int |
idOffset()
Get the position within
AbstractTreeIterator.idBuffer() of this entry's ObjectId. |
protected boolean |
needsStopWalk()
Whether the iterator implements
AbstractTreeIterator.stopWalk() . |
void |
next(int delta)
Move to next entry, populating this iterator with the entry data.
|
void |
reset()
Position this iterator on the first entry.
|
void |
stopWalk()
Indicates to the iterator that no more entries will be read.
|
createEmptyTreeIterator, createSubtreeIterator, ensurePathCapacity, findFile, findFile, getEntryFileMode, getEntryObjectId, getEntryPathBuffer, getEntryPathHashCode, getEntryPathLength, getEntryPathString, getEntryRawMode, getName, getNameLength, getNameOffset, growPath, idEqual, isWorkTree, pathCompare, pathCompare, skip, toString
public EmptyTreeIterator()
public EmptyTreeIterator(AbstractTreeIterator p, byte[] childPath, int childPathOffset)
The caller is responsible for setting up the path of the child iterator.
p
- parent tree iterator.childPath
- path array to be used by the child iterator. This path must
contain the path from the top of the walk to the first child
and must end with a '/'.childPathOffset
- position within childPath
where the child can
insert its data. The value at
childPath[childPathOffset-1]
must be '/'.public AbstractTreeIterator createSubtreeIterator(ObjectReader reader) throws IncorrectObjectTypeException, IOException
The parent reference of the iterator must be this
,
otherwise the caller would not be able to exit out of the subtree
iterator correctly and return to continue walking this
.
createSubtreeIterator
in class AbstractTreeIterator
reader
- reader to load the tree data from.IncorrectObjectTypeException
- the current entry is not actually a tree and cannot be parsed
as though it were a tree.IOException
- a loose object or pack file could not be read.public boolean hasId()
hasId
in class AbstractTreeIterator
true
if the entry has a valid ObjectId.public ObjectId getEntryObjectId()
getEntryObjectId
in class AbstractTreeIterator
public byte[] idBuffer()
The id buffer contains the bytes necessary to construct an ObjectId for the current entry of this iterator. The buffer can be the same buffer for all entries, or it can be a unique buffer per-entry. Implementations are encouraged to expose their private buffer whenever possible to reduce garbage generation and copying costs.
idBuffer
in class AbstractTreeIterator
AbstractTreeIterator.getEntryObjectId()
public int idOffset()
AbstractTreeIterator.idBuffer()
of this entry's ObjectId.idOffset
in class AbstractTreeIterator
AbstractTreeIterator.idBuffer()
where the
ObjectId must be copied out of.public void reset()
back(1)
until
first()
is true. This is most likely not the most efficient
method of repositioning the iterator to its first entry, so subclasses
are strongly encouraged to override the method.reset
in class AbstractTreeIterator
public boolean first()
An iterator is positioned on the first entry if back(1)
would be an invalid request as there is no entry before the current one.
An empty iterator (one with no entries) will be
first() && eof()
.
first
in class AbstractTreeIterator
public boolean eof()
An iterator is at EOF if there is no current entry.
eof
in class AbstractTreeIterator
public void next(int delta) throws CorruptObjectException
The delta indicates how many moves forward should occur. The most common delta is 1 to move to the next entry.
Implementations must populate the following members:
AbstractTreeIterator.mode
AbstractTreeIterator.path
(from AbstractTreeIterator.pathOffset
to AbstractTreeIterator.pathLen
)AbstractTreeIterator.pathLen
AbstractTreeIterator.idBuffer()
and AbstractTreeIterator.idOffset()
when demanded.next
in class AbstractTreeIterator
delta
- number of entries to move the iterator by. Must be a positive,
non-zero integer.CorruptObjectException
- the tree is invalid.public void back(int delta) throws CorruptObjectException
The delta indicates how many moves backward should occur.The most common delta is 1 to move to the prior entry.
Implementations must populate the following members:
AbstractTreeIterator.mode
AbstractTreeIterator.path
(from AbstractTreeIterator.pathOffset
to AbstractTreeIterator.pathLen
)AbstractTreeIterator.pathLen
AbstractTreeIterator.idBuffer()
and AbstractTreeIterator.idOffset()
when demanded.back
in class AbstractTreeIterator
delta
- number of entries to move the iterator by. Must be a positive,
non-zero integer.CorruptObjectException
- the tree is invalid.public void stopWalk()
This is only invoked by TreeWalk when the iteration is aborted early due
to a StopWalkException
being thrown from
within a TreeFilter.
stopWalk
in class AbstractTreeIterator
protected boolean needsStopWalk()
AbstractTreeIterator.stopWalk()
.needsStopWalk
in class AbstractTreeIterator
true
if the iterator implements AbstractTreeIterator.stopWalk()
.Copyright © 2020 Eclipse JGit Project. All rights reserved.