Class DiffResult
- java.lang.Object
-
- org.apache.commons.lang3.builder.DiffResult
-
- All Implemented Interfaces:
java.lang.Iterable<Diff<?>>
public class DiffResult extends java.lang.Object implements java.lang.Iterable<Diff<?>>
A
DiffResult
contains a collection of the differences between twoDiffable
objects. Typically these differences are displayed usingtoString()
method, which returns a string describing the fields that differ between the objects.Use a
DiffBuilder
to build aDiffResult
comparing two objects.- Since:
- 3.3
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
OBJECTS_SAME_STRING
TheString
returned when the objects have no differences: ""
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.List<Diff<?>>
getDiffs()
Returns an unmodifiable list ofDiff
s.int
getNumberOfDiffs()
Returns the number of differences between the two objects.ToStringStyle
getToStringStyle()
Returns the style used by thetoString()
method.java.util.Iterator<Diff<?>>
iterator()
Returns an iterator over theDiff
objects contained in this list.java.lang.String
toString()
Builds aString
description of the differences contained within thisDiffResult
.java.lang.String
toString(ToStringStyle style)
Builds aString
description of the differences contained within thisDiffResult
, using the suppliedToStringStyle
.
-
-
-
Field Detail
-
OBJECTS_SAME_STRING
public static final java.lang.String OBJECTS_SAME_STRING
The
String
returned when the objects have no differences: ""- See Also:
- Constant Field Values
-
-
Method Detail
-
getDiffs
public java.util.List<Diff<?>> getDiffs()
Returns an unmodifiable list of
Diff
s. The list may be empty if there were no differences between the objects.- Returns:
- an unmodifiable list of
Diff
s
-
getNumberOfDiffs
public int getNumberOfDiffs()
Returns the number of differences between the two objects.
- Returns:
- the number of differences
-
getToStringStyle
public ToStringStyle getToStringStyle()
Returns the style used by the
toString()
method.- Returns:
- the style
-
toString
public java.lang.String toString()
Builds a
String
description of the differences contained within thisDiffResult
. AToStringBuilder
is used for each object and the style of the output is governed by theToStringStyle
passed to the constructor.If there are no differences stored in this list, the method will return
OBJECTS_SAME_STRING
. Otherwise, using the example given inDiffable
andToStringStyle.SHORT_PREFIX_STYLE
, an output might be:Person[name=John Doe,age=32] differs from Person[name=Joe Bloggs,age=26]
This indicates that the objects differ in name and age, but not in smoking status.
To use a different
ToStringStyle
for an instance of this class, usetoString(ToStringStyle)
.- Overrides:
toString
in classjava.lang.Object
- Returns:
- a
String
description of the differences.
-
toString
public java.lang.String toString(ToStringStyle style)
Builds a
String
description of the differences contained within thisDiffResult
, using the suppliedToStringStyle
.- Parameters:
style
- theToStringStyle
to use when outputting the objects- Returns:
- a
String
description of the differences.
-
-