include
public boolean include(RevWalk walker,
RevCommit cmit)
throws StopWalkException,
MissingObjectException,
IncorrectObjectTypeException,
java.io.IOException
Determine if the supplied commit should be included in results.
- Specified by:
include
in class RevFilter
- Parameters:
walker
- the active walker this filter is being invoked from within.
cmit
- the commit currently being tested. The commit has been parsed
and its body is available for inspection only if the filter
returns true from RevFilter.requiresCommitBody()
.
- Returns:
- true to include this commit in the results; false to have this
commit be omitted entirely from the results.
- Throws:
StopWalkException
- the filter knows for certain that no additional commits can
ever match, and the current commit doesn't match either. The
walk is halted and no more results are provided.
MissingObjectException
- an object the filter needs to consult to determine its answer
does not exist in the Git repository the walker is operating
on. Filtering this commit is impossible without the object.
IncorrectObjectTypeException
- an object the filter needed to consult was not of the
expected object type. This usually indicates a corrupt
repository, as an object link is referencing the wrong type.
java.io.IOException
- a loose object or pack file could not be read to obtain data
necessary for the filter to make its decision.