java.lang.Object
org.eclipse.jgit.diff.DiffAlgorithm
- Direct Known Subclasses:
LowLevelDiffAlgorithm
Compares two
Sequence
s to create an
EditList
of changes.
An algorithm's diff
method must be callable from concurrent threads
without data collisions. This permits some algorithms to use a singleton
pattern, with concurrent invocations using the same singleton. Other
algorithms may support parameterization, in which case the caller can create
a unique instance per thread.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic enum
Supported diff algorithm -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiondiff
(SequenceComparator<? super S> cmp, S a, S b) Compare two sequences and identify a list of edits between them.diffNonCommon
(SequenceComparator<? super S> cmp, S a, S b) Compare two sequences and identify a list of edits between them.static DiffAlgorithm
Get diff algorithm
-
Constructor Details
-
DiffAlgorithm
public DiffAlgorithm()
-
-
Method Details
-
getAlgorithm
Get diff algorithm- Parameters:
alg
- the diff algorithm for which an implementation should be returned- Returns:
- an implementation of the specified diff algorithm
-
diff
Compare two sequences and identify a list of edits between them.- Type Parameters:
S
- type of sequence being compared.- Parameters:
cmp
- the comparator supplying the element equivalence function.a
- the first (also known as old or pre-image) sequence. Edits returned by this algorithm will reference indexes using the 'A' side:Edit.getBeginA()
,Edit.getEndA()
.b
- the second (also known as new or post-image) sequence. Edits returned by this algorithm will reference indexes using the 'B' side:Edit.getBeginB()
,Edit.getEndB()
.- Returns:
- a modifiable edit list comparing the two sequences. If empty, the
sequences are identical according to
cmp
's rules. The result list is never null.
-
diffNonCommon
public abstract <S extends Sequence> EditList diffNonCommon(SequenceComparator<? super S> cmp, S a, S b) Compare two sequences and identify a list of edits between them. This method should be invoked only after the two sequences have been proven to have no common starting or ending elements. The expected elimination of common starting and ending elements is automatically performed by thediff(SequenceComparator, Sequence, Sequence)
method, which invokes this method usingSubsequence
s.- Type Parameters:
S
- type of sequence being compared.- Parameters:
cmp
- the comparator supplying the element equivalence function.a
- the first (also known as old or pre-image) sequence. Edits returned by this algorithm will reference indexes using the 'A' side:Edit.getBeginA()
,Edit.getEndA()
.b
- the second (also known as new or post-image) sequence. Edits returned by this algorithm will reference indexes using the 'B' side:Edit.getBeginB()
,Edit.getEndB()
.- Returns:
- a modifiable edit list comparing the two sequences.
-