Package org.apache.commons.lang3.builder

Class Diff<T>

java.lang.Object

org.apache.commons.lang3.tuple.Pair<T,T>

org.apache.commons.lang3.builder.Diff<T>

Type Parameters:

T - The type of object contained within this Diff. Differences between primitive objects are stored as their Object wrapper equivalent.

All Implemented Interfaces:

Serializable, Comparable<Pair<T,T>>, Map.Entry<T,T>

public abstract class Diff<T>
extends Pair<T,T>

A Diff contains the differences between two Diffable class fields.

Typically, Diffs are retrieved by using a DiffBuilder to produce a DiffResult, containing the differences between two objects.

Since:

3.3

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private final String	fieldName
private static final long	serialVersionUID
private final Type	type

Fields inherited from class org.apache.commons.lang3.tuple.Pair

EMPTY_ARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Diff(String fieldName)	Constructs a new Diff for the given field name.

Method Summary

Modifier and Type	Method	Description
final String	getFieldName()	Returns the name of the field.
final Type	getType()	Returns the type of the field.
final T	setValue(T value)	Throws UnsupportedOperationException.
final String	toString()	Returns a String representation of the Diff, with the following format:

Methods inherited from class org.apache.commons.lang3.tuple.Pair

compareTo, emptyArray, equals, getKey, getLeft, getRight, getValue, hashCode, of, of, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

type

private final Type type

fieldName

private final String fieldName

Constructor Details

Diff

protected Diff(String fieldName)

Constructs a new Diff for the given field name.

Parameters:

fieldName - the name of the field

Method Details

getType

public final Type getType()

Returns the type of the field.

Returns:

the field type

getFieldName

public final String getFieldName()

Returns the name of the field.

Returns:

the field name

toString

public final String toString()

Returns a String representation of the Diff, with the following format:

 [fieldname: left-value, right-value]
 

Overrides:

toString in class Pair<T,T>

Returns:

the string representation

setValue

public final T setValue(T value)

Throws UnsupportedOperationException.

Parameters:

value - ignored

Returns:

nothing