org.eclipse.jgit.revwalk

Class LIFORevQueue

java.lang.Object

org.eclipse.jgit.revwalk.LIFORevQueue

public class LIFORevQueue
extends Object

A queue of commits in LIFO order.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.eclipse.jgit.revwalk.BlockRevQueue.BlockFreeList	free

Constructor Summary

Constructors

Constructor and Description
LIFORevQueue() Create an empty LIFO queue.

Method Summary

Modifier and Type	Method and Description
void	add(RevCommit c) Add a commit to the queue.
void	add(RevCommit c, RevFlag queueControl) Add a commit if it does not have a flag set yet, then set the flag.
void	addParents(RevCommit c, RevFlag queueControl) Add a commit's parents if one does not have a flag set yet.
void	clear() Remove all entries from this queue.
protected static void	describe(StringBuilder s, RevCommit c) Describe this queue
RevCommit	next() Return the next commit to the application, or the next generator.
void	shareFreeList(org.eclipse.jgit.revwalk.BlockRevQueue q) Connect the supplied queue to this generator's own free list (if any).
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

free

protected org.eclipse.jgit.revwalk.BlockRevQueue.BlockFreeList free

Constructor Detail

LIFORevQueue

public LIFORevQueue()

Create an empty LIFO queue.

Method Detail

add

public void add(RevCommit c)

Add a commit to the queue.

This method always adds the commit, even if it is already in the queue or previously was in the queue but has already been removed. To control queue admission use add(RevCommit, RevFlag).

Parameters:

c - commit to add.

next

public RevCommit next()

Return the next commit to the application, or the next generator.

Remove the first commit from the queue.

Returns:

next available commit; null if no more are to be returned.

clear

public void clear()

Remove all entries from this queue.

toString

public String toString()

Overrides:

toString in class Object

shareFreeList

public void shareFreeList(org.eclipse.jgit.revwalk.BlockRevQueue q)

Connect the supplied queue to this generator's own free list (if any).

Reconfigure this queue to share the same free list as another.

Multiple revision queues can be connected to the same free list, making it less expensive for applications to shuttle commits between them. This method arranges for the receiver to take from / return to the same free list as the supplied queue.

Free lists are not thread-safe. Applications must ensure that all queues sharing the same free list are doing so from only a single thread.

Parameters:

q - another FIFO queue that wants to share our queue's free list.

add

public final void add(RevCommit c,
                      RevFlag queueControl)

Add a commit if it does not have a flag set yet, then set the flag.

This method permits the application to test if the commit has the given flag; if it does not already have the flag than the commit is added to the queue and the flag is set. This later will prevent the commit from being added twice.

Parameters:

c - commit to add.

queueControl - flag that controls admission to the queue.

addParents

public final void addParents(RevCommit c,
                             RevFlag queueControl)

Add a commit's parents if one does not have a flag set yet.

This method permits the application to test if the commit has the given flag; if it does not already have the flag than the commit is added to the queue and the flag is set. This later will prevent the commit from being added twice.

Parameters:

c - commit whose parents should be added.

queueControl - flag that controls admission to the queue.

describe

protected static void describe(StringBuilder s,
                               RevCommit c)

Describe this queue

Parameters:

s - a StringBuilder

c - a RevCommit