org.eclipse.jgit.revwalk

Class DateRevQueue

java.lang.Object

org.eclipse.jgit.revwalk.DateRevQueue

public class DateRevQueue
extends Object

A queue of commits sorted by commit time order.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	firstParent

Constructor Summary

Constructors

Constructor and Description
DateRevQueue() Create an empty date 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.
RevCommit	peek() Peek at the next commit, without removing it.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

firstParent

protected final boolean firstParent

Constructor Detail

DateRevQueue

public DateRevQueue()

Create an empty date 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.

peek

public RevCommit peek()

Peek at the next commit, without removing it.

Returns:

the next available commit; null if there are no commits left.

clear

public void clear()

Remove all entries from this queue.

toString

public String toString()

Overrides:

toString in class Object

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