|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.eclipse.compare.structuremergeviewer.Differencer
A generic two-way or three-way differencing engine.
The engine is used by calling one of the findDifferences
methods and passing
in the objects to compare.
The engine calls the following methods on the input objects to perform the compare:
getChildren
: for enumerating the children of an object (if any),
contentsEqual
: for comparing the content of leaf objects, that is, objects without children,
visit
: for every pair of compared object the compare result is passed in.
getChildren
: tries to apply the IStructureComparator
interface to enumerate the children,
contentsEqual
: tries to apply the IStreamContentAccessor
interface
to perform a byte-wise content comparison,
visit
: creates a DiffNode
for any detected difference between the compared objects and
links it under a parent node effectively creating a tree of differences.
Field Summary | |
static int |
ADDITION
Difference constant (value 1) indicating one side was added. |
static int |
CHANGE
Difference constant (value 3) indicating side changed. |
static int |
CHANGE_TYPE_MASK
Bit mask (value 3) for extracting the kind of difference. |
static int |
CONFLICTING
Three-way change constant (value 12) indicating a change on left and right sides. |
static int |
DELETION
Difference constant (value 2) indicating one side was removed. |
static int |
DIRECTION_MASK
Bit mask (value 12) for extracting the direction of a three-way change. |
static int |
LEFT
Three-way change constant (value 4) indicating a change on left side. |
static int |
NO_CHANGE
Difference constant (value 0) indicating no difference. |
static int |
PSEUDO_CONFLICT
Constant (value 16) indicating a change on left and right side (with respect to ancestor) but left and right are identical. |
static int |
RIGHT
Three-way change constant (value 8) indicating a change on right side. |
Constructor Summary | |
Differencer()
Creates a new differencing engine. |
Method Summary | |
protected boolean |
contentsEqual(Object input1,
Object input2)
Performs a content compare on the two given inputs. |
Object |
findDifferences(boolean threeWay,
IProgressMonitor pm,
Object data,
Object ancestor,
Object left,
Object right)
Starts the differencing engine on the three input objects. |
protected Object[] |
getChildren(Object input)
Returns the children of the given input or null if there are no children. |
protected void |
updateProgress(IProgressMonitor progressMonitor,
Object node)
Called for every leaf or node compare to update progress information. |
protected Object |
visit(Object data,
int result,
Object ancestor,
Object left,
Object right)
Called for every node or leaf comparison. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int NO_CHANGE
public static final int ADDITION
public static final int DELETION
public static final int CHANGE
public static final int CHANGE_TYPE_MASK
public static final int LEFT
public static final int RIGHT
public static final int CONFLICTING
public static final int DIRECTION_MASK
public static final int PSEUDO_CONFLICT
Constructor Detail |
public Differencer()
Method Detail |
public Object findDifferences(boolean threeWay, IProgressMonitor pm, Object data, Object ancestor, Object left, Object right)
true
a
three-way comparison is performed, otherwise a two-way compare (in the latter case the ancestor argument is ignored).
The progress monitor is passed to the method updateProgress
which is called for every node or
leaf compare. The method returns the object that was returned from the top-most call to method visit
.
At most two of the ancestor, left, and right parameters are allowed to be null
.
threeWay
- if true
a three-way comparison is performed, otherwise a two-way comparepm
- a progress monitor which is passed to method updateProgress
data
- a client data that is passed to the top-level call to visit
ancestor
- the ancestor object of the compare (may be null
)left
- the left object of the compareright
- the right object of the compare
visit
,
possibly null
protected Object visit(Object data, int result, Object ancestor, Object left, Object right)
visit
method on the parent input.
It can be considered the "parent" reference and is useful when building a tree.
The Differencer
implementation returns a new
DiffNode
which is initialized with the corresponding values.
Subclasses may override.
data
- object returned from parent call to visit
,
possibly null
result
- the result of the compare operation performed on the three inputsancestor
- the compare ancestor of the left and right inputsleft
- the left input to the compareright
- the right input to the compare
null
protected boolean contentsEqual(Object input1, Object input2)
The Differencer
implementation
returns true
if both inputs implement IStreamContentAccessor
and their byte contents is identical. Subclasses may override to implement
a different content compare on the given inputs.
input1
- first input to contents compareinput2
- second input to contents compare
true
if content is equalprotected Object[] getChildren(Object input)
null
if there are no children.
The Differencer
implementation checks whether the input
implements the IStructureComparator
interface. If yes it is used
to return an array containing all children. Otherwise null
is returned.
Subclasses may override to implement a different strategy to enumerate children.
input
- the object for which to return childrenprotected void updateProgress(IProgressMonitor progressMonitor, Object node)
The Differencer
implementation shows the name of the input object
as a subtask. Subclasses may override.
progressMonitor
- the progress monitor for reporting progress
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |