Package org.assertj.core.error

Class ShouldBeEqual

java.lang.Object

org.assertj.core.error.ShouldBeEqual

All Implemented Interfaces:

AssertionErrorFactory

public class ShouldBeEqual
extends java.lang.Object
implements AssertionErrorFactory

Creates an AssertionError indicating that an assertion that verifies that two objects are equal failed.

The built AssertionError's message differentiates actual and expected description if their string representation are the same (e.g. 42 float and 42 double). It also mentions the comparator in case of a custom comparator is used (instead of equals method).

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.Object	actual
protected ComparisonStrategy	comparisonStrategy
(package private) ConstructorInvoker	constructorInvoker
(package private) DescriptionFormatter	descriptionFormatter
protected java.lang.Object	expected
private static java.lang.String	EXPECTED_BUT_WAS_MESSAGE
private static java.lang.String	EXPECTED_BUT_WAS_MESSAGE_USING_COMPARATOR
protected MessageFormatter	messageFormatter
private static java.lang.Class<?>[]	MSG_ARG_TYPES
private static java.lang.Class<?>[]	MSG_ARG_TYPES_FOR_ASSERTION_FAILED_ERROR
private Representation	representation

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ShouldBeEqual(java.lang.Object actual, java.lang.Object expected, ComparisonStrategy comparisonStrategy, Representation representation)

Method Summary

Modifier and Type	Method	Description
protected boolean	actualAndExpectedHaveSameStringRepresentation()
private java.lang.AssertionError	assertionFailedError(java.lang.String message, Representation representation)
private java.lang.AssertionError	comparisonFailure(Description description)
protected java.lang.String	defaultDetailedErrorMessage(Description description, Representation representation)	Builds and returns an error message from description using detailedExpected() and detailedActual() detailed representation.
protected java.lang.String	detailedActual()
protected java.lang.String	detailedExpected()
boolean	equals(java.lang.Object o)
private java.lang.String	errorMessageForMultilineValues(Description description, Representation representation, java.lang.String actualRepresentation, java.lang.String expectedRepresentation)
int	hashCode()
private boolean	hasMultilineValue(java.lang.String actualRepresentation, java.lang.String expectedRepresentation)
protected java.lang.String	indent(java.lang.String valueRepresentation)
private java.lang.String	messageForMultilineValues(java.lang.String actualRepresentation, java.lang.String expectedRepresentation, Representation representation)
java.lang.AssertionError	newAssertionError(Description description, Representation representation)	Creates an AssertionError indicating that an assertion that verifies that two objects are equal failed. The AssertionError message is built so that it differentiates actual and expected description in case their string representation are the same (like 42 float and 42 double).
private java.lang.AssertionError	newComparisonFailure(java.lang.String description)
static AssertionErrorFactory	shouldBeEqual(java.lang.Object actual, java.lang.Object expected, ComparisonStrategy comparisonStrategy, Representation representation)	Creates a new ShouldBeEqual.
static AssertionErrorFactory	shouldBeEqual(java.lang.Object actual, java.lang.Object expected, Representation representation)	Creates a new ShouldBeEqual.
protected java.lang.String	smartErrorMessage(Description description, Representation representation)	Builds and returns an error message from the given description using expected and actual basic representation if their description differ otherwise use defaultDetailedErrorMessage(Description, Representation) to represent them differently.

Methods inherited from class java.lang.Object

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

Field Detail

EXPECTED_BUT_WAS_MESSAGE

private static final java.lang.String EXPECTED_BUT_WAS_MESSAGE

See Also:

Constant Field Values

EXPECTED_BUT_WAS_MESSAGE_USING_COMPARATOR

private static final java.lang.String EXPECTED_BUT_WAS_MESSAGE_USING_COMPARATOR

See Also:

Constant Field Values

MSG_ARG_TYPES

private static final java.lang.Class<?>[] MSG_ARG_TYPES

MSG_ARG_TYPES_FOR_ASSERTION_FAILED_ERROR

private static final java.lang.Class<?>[] MSG_ARG_TYPES_FOR_ASSERTION_FAILED_ERROR

actual

protected final java.lang.Object actual

expected

protected final java.lang.Object expected

messageFormatter

protected final MessageFormatter messageFormatter

comparisonStrategy

protected final ComparisonStrategy comparisonStrategy

representation

private Representation representation

constructorInvoker

ConstructorInvoker constructorInvoker

descriptionFormatter

DescriptionFormatter descriptionFormatter

Constructor Detail

ShouldBeEqual

protected ShouldBeEqual(java.lang.Object actual,
                        java.lang.Object expected,
                        ComparisonStrategy comparisonStrategy,
                        Representation representation)

Method Detail

shouldBeEqual

public static AssertionErrorFactory shouldBeEqual(java.lang.Object actual,
                                                  java.lang.Object expected,
                                                  Representation representation)

Creates a new ShouldBeEqual.

Parameters:

actual - the actual value in the failed assertion.

expected - the expected value in the failed assertion.

representation - the Representation used to format values.

Returns:

the created AssertionErrorFactory.

shouldBeEqual

public static AssertionErrorFactory shouldBeEqual(java.lang.Object actual,
                                                  java.lang.Object expected,
                                                  ComparisonStrategy comparisonStrategy,
                                                  Representation representation)

Creates a new ShouldBeEqual.

Parameters:

actual - the actual value in the failed assertion.

expected - the expected value in the failed assertion.

comparisonStrategy - the ComparisonStrategy used to compare actual with expected.

representation - the Representation used to format values.

Returns:

the created AssertionErrorFactory.

newAssertionError

public java.lang.AssertionError newAssertionError(Description description,
                                                  Representation representation)

Creates an AssertionError indicating that an assertion that verifies that two objects are equal failed.
The AssertionError message is built so that it differentiates actual and expected description in case their string representation are the same (like 42 float and 42 double).

If JUnit 4 is in the classpath and the description is standard (no comparator was used and actual and expected string representation were different), this method will instead create a org.junit.ComparisonFailure that highlights the difference(s) between the expected and actual objects.

If opentest4j is on the classpath then org.opentest4j.AssertionFailedError would be used.

AssertionError stack trace won't show AssertJ related elements if Failures is configured to filter them (see Failures.setRemoveAssertJRelatedElementsFromStackTrace(boolean)).

Specified by:

newAssertionError in interface AssertionErrorFactory

Parameters:

description - the description of the failed assertion.

representation - the Representation used to format values.

Returns:

the created AssertionError.

actualAndExpectedHaveSameStringRepresentation

protected boolean actualAndExpectedHaveSameStringRepresentation()

smartErrorMessage

protected java.lang.String smartErrorMessage(Description description,
                                             Representation representation)

Builds and returns an error message from the given description using expected and actual basic representation if their description differ otherwise use defaultDetailedErrorMessage(Description, Representation) to represent them differently.

Parameters:

description - the Description used to build the returned error message

representation - the Representation used to build String representation of object

Returns:

the error message from description using expected and actual "smart" representation.

errorMessageForMultilineValues

private java.lang.String errorMessageForMultilineValues(Description description,
                                                        Representation representation,
                                                        java.lang.String actualRepresentation,
                                                        java.lang.String expectedRepresentation)

hasMultilineValue

private boolean hasMultilineValue(java.lang.String actualRepresentation,
                                  java.lang.String expectedRepresentation)

messageForMultilineValues

private java.lang.String messageForMultilineValues(java.lang.String actualRepresentation,
                                                   java.lang.String expectedRepresentation,
                                                   Representation representation)

indent

protected java.lang.String indent(java.lang.String valueRepresentation)

defaultDetailedErrorMessage

protected java.lang.String defaultDetailedErrorMessage(Description description,
                                                       Representation representation)

Builds and returns an error message from description using detailedExpected() and detailedActual() detailed representation.

Parameters:

description - the Description used to build the returned error message

representation - the Representation used to build String representation of object

Returns:

the error message from description using detailedExpected() and detailedActual() detailed representation.

assertionFailedError

private java.lang.AssertionError assertionFailedError(java.lang.String message,
                                                      Representation representation)

comparisonFailure

private java.lang.AssertionError comparisonFailure(Description description)

newComparisonFailure

private java.lang.AssertionError newComparisonFailure(java.lang.String description)
                                               throws java.lang.Exception

Throws:

java.lang.Exception

detailedActual

protected java.lang.String detailedActual()

detailedExpected

protected java.lang.String detailedExpected()

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object