Package org.junit

Class ComparisonFailure

java.lang.Object

java.lang.Throwable

java.lang.Error

java.lang.AssertionError

org.junit.ComparisonFailure

All Implemented Interfaces:

java.io.Serializable

public class ComparisonFailure
extends java.lang.AssertionError

Thrown when an assertEquals(String, String) fails. Create and throw a ComparisonFailure manually if you want to show users the difference between two complex strings.

Inspired by a patch from Alex Chaffee (alex@purpletech.com)

Since:

4.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	ComparisonFailure.ComparisonCompactor

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.String	fActual
private java.lang.String	fExpected
private static int	MAX_CONTEXT_LENGTH	The maximum length for expected and actual strings.
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor	Description
ComparisonFailure(java.lang.String message, java.lang.String expected, java.lang.String actual)	Constructs a comparison failure.

Method Summary

Modifier and Type	Method	Description
java.lang.String	getActual()	Returns the actual string value
java.lang.String	getExpected()	Returns the expected string value
java.lang.String	getMessage()	Returns "..." in place of common prefix and "..." in place of common suffix between expected and actual.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

MAX_CONTEXT_LENGTH

private static final int MAX_CONTEXT_LENGTH

The maximum length for expected and actual strings. If it is exceeded, the strings should be shortened.

See Also:

ComparisonFailure.ComparisonCompactor, Constant Field Values

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

fExpected

private java.lang.String fExpected

fActual

private java.lang.String fActual

Constructor Detail

ComparisonFailure

public ComparisonFailure(java.lang.String message,
                         java.lang.String expected,
                         java.lang.String actual)

Constructs a comparison failure.

Parameters:

message - the identifying message or null

expected - the expected string value

actual - the actual string value

Method Detail

getMessage

public java.lang.String getMessage()

Returns "..." in place of common prefix and "..." in place of common suffix between expected and actual.

Overrides:

getMessage in class java.lang.Throwable

See Also:

Throwable.getMessage()

getActual

public java.lang.String getActual()

Returns the actual string value

Returns:

the actual string value

getExpected

public java.lang.String getExpected()

Returns the expected string value

Returns:

the expected string value