org.eclipse.jgit.revwalk

Class DepthWalk.RevWalk

java.lang.Object

org.eclipse.jgit.revwalk.RevWalk

org.eclipse.jgit.revwalk.DepthWalk.RevWalk

All Implemented Interfaces:

java.lang.AutoCloseable, java.lang.Iterable<RevCommit>, DepthWalk

Enclosing interface:

DepthWalk

public static class DepthWalk.RevWalk
extends RevWalk
implements DepthWalk

Subclass of RevWalk that performs depth filtering.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jgit.revwalk.DepthWalk

DepthWalk.Commit, DepthWalk.ObjectWalk, DepthWalk.RevWalk

Field Summary

Fields

Modifier and Type	Field and Description
private int	depth
private RevFlag	REINTERESTING
private RevFlag	UNSHALLOW

Fields inherited from class org.eclipse.jgit.revwalk.RevWalk

carryFlags, freeFlags, idBuffer, objects, PARSED, pending, queue, reader, RESERVED_FLAGS, REWRITE, roots, SEEN, shallowCommitsInitialized, TEMP_MARK, TOPO_DELAY, UNINTERESTING

Constructor Summary

Constructors

Constructor and Description
RevWalk(ObjectReader or, int depth)
RevWalk(Repository repo, int depth)

Method Summary

Modifier and Type	Method and Description
protected RevCommit	createCommit(AnyObjectId id) Construct a new unparsed commit for the given object.
int	getDepth() Get depth to filter to.
RevFlag	getReinterestingFlag() Get flag marking commits that are interesting again.
RevFlag	getUnshallowFlag() Get flag marking commits that should become unshallow.
void	markRoot(RevCommit c) Mark a root commit (i.e., one whose depth should be considered 0.)
DepthWalk.ObjectWalk	toObjectWalkWithSameObjects() Create and return an ObjectWalk using the same objects.

Methods inherited from class org.eclipse.jgit.revwalk.RevWalk

allocFlag, assertNotStarted, assumeShallow, carry, carry, carryFlagsImpl, close, dispose, disposeFlag, freeFlag, getCachedBytes, getCachedBytes, getObjectReader, getRevFilter, getRevSort, getRewriteParents, getTreeFilter, hasRevSort, initializeShallowCommits, isMergedInto, isRetainBody, iterator, lookupAny, lookupBlob, lookupCommit, lookupOrNull, lookupTag, lookupTree, markStart, markStart, markUninteresting, newFlag, next, parseAny, parseAny, parseBody, parseCommit, parseHeaders, parseTag, parseTree, peel, reset, reset, resetRetain, resetRetain, retainOnReset, retainOnReset, setRetainBody, setRevFilter, setRewriteParents, setTreeFilter, sort, sort

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

depth

private final int depth

UNSHALLOW

private final RevFlag UNSHALLOW

REINTERESTING

private final RevFlag REINTERESTING

Constructor Detail

RevWalk

public RevWalk(Repository repo,
               int depth)

Parameters:

repo - Repository to walk

depth - Maximum depth to return

RevWalk

public RevWalk(ObjectReader or,
               int depth)

Parameters:

or - ObjectReader to use

depth - Maximum depth to return

Method Detail

markRoot

public void markRoot(RevCommit c)
              throws MissingObjectException,
                     IncorrectObjectTypeException,
                     java.io.IOException

Mark a root commit (i.e., one whose depth should be considered 0.)

Parameters:

c - Commit to mark

Throws:

java.io.IOException

IncorrectObjectTypeException

MissingObjectException

createCommit

protected RevCommit createCommit(AnyObjectId id)

Description copied from class: RevWalk

Construct a new unparsed commit for the given object.

Overrides:

createCommit in class RevWalk

Parameters:

id - the object this walker requires a commit reference for.

Returns:

a new unparsed reference for the object.

getDepth

public int getDepth()

Description copied from interface: DepthWalk

Get depth to filter to.

Specified by:

getDepth in interface DepthWalk

Returns:

Depth to filter to.

getUnshallowFlag

public RevFlag getUnshallowFlag()

Description copied from interface: DepthWalk

Get flag marking commits that should become unshallow.

Specified by:

getUnshallowFlag in interface DepthWalk

Returns:

flag marking commits that should become unshallow.

getReinterestingFlag

public RevFlag getReinterestingFlag()

Description copied from interface: DepthWalk

Get flag marking commits that are interesting again.

Specified by:

getReinterestingFlag in interface DepthWalk

Returns:

flag marking commits that are interesting again.

toObjectWalkWithSameObjects

public DepthWalk.ObjectWalk toObjectWalkWithSameObjects()

Description copied from class: RevWalk

Create and return an ObjectWalk using the same objects.

Prior to using this method, the caller must reset this RevWalk to clean any flags that were used during the last traversal.

The returned ObjectWalk uses the same ObjectReader, internal object pool, and free RevFlags. Once the ObjectWalk is created, this RevWalk should not be used anymore.

Overrides:

toObjectWalkWithSameObjects in class RevWalk

Returns:

a new walk, using the exact same object pool.

Since:

4.5