org.assertj.core.api

Class AbstractCharacterAssert<SELF extends AbstractCharacterAssert<SELF>>

java.lang.Object

org.assertj.core.api.AbstractAssert<SELF,ACTUAL>

org.assertj.core.api.AbstractObjectAssert<SELF,ACTUAL>

org.assertj.core.api.AbstractComparableAssert<SELF,Character>

org.assertj.core.api.AbstractCharacterAssert<SELF>

Type Parameters:

SELF - the "self" type of this assertion class. Please read "Emulating 'self types' using Java Generics to simplify fluent API implementation" for more details.

All Implemented Interfaces:

Assert<SELF,Character>, ComparableAssert<SELF,Character>, Descriptable<SELF>, ExtensionPoints<SELF,Character>

Direct Known Subclasses:

CharacterAssert

public abstract class AbstractCharacterAssert<SELF extends AbstractCharacterAssert<SELF>>
extends AbstractComparableAssert<SELF,Character>

Base class for all implementations of assertions for Characters.

Author:

Yvonne Wang, David DIDIER, Ansgar Konermann, Alex Ruiz, Joel Costigliola, Mikhail Mazursky

Field Summary

Fields inherited from class org.assertj.core.api.AbstractAssert

actual, info, myself

Constructor Summary

Constructors

Constructor and Description
AbstractCharacterAssert(Character actual, Class<?> selfType)

Method Summary

Modifier and Type	Method and Description
SELF	inUnicode() Use unicode character representation instead of standard representation in error messages.
SELF	isEqualTo(char expected) Verifies that the actual value is equal to the given one.
SELF	isGreaterThan(char other) Verifies that the actual value is greater than the given one.
SELF	isGreaterThanOrEqualTo(char other) Verifies that the actual value is greater than or equal to the given one.
SELF	isLessThan(char other) Verifies that the actual value is less than the given one.
SELF	isLessThanOrEqualTo(char other) Verifies that the actual value is less than or equal to the given one.
SELF	isLowerCase() Verifies that the actual value is a lowercase character.
SELF	isNotEqualTo(char other) Verifies that the actual value is not equal to the given one.
SELF	isUpperCase() Verifies that the actual value is a uppercase character.
SELF	usingComparator(Comparator<? super Character> customComparator) Use given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
SELF	usingDefaultComparator() Revert to standard comparison for incoming assertion checks.

Methods inherited from class org.assertj.core.api.AbstractComparableAssert

inBinary, inHexadecimal, isBetween, isEqualByComparingTo, isGreaterThan, isGreaterThanOrEqualTo, isLessThan, isLessThanOrEqualTo, isNotEqualByComparingTo, isStrictlyBetween

Methods inherited from class org.assertj.core.api.AbstractObjectAssert

as, as, defaultTypeComparators, extracting, extracting, hasFieldOrProperty, hasFieldOrPropertyWithValue, hasNoNullFieldsOrProperties, hasNoNullFieldsOrPropertiesExcept, isEqualToComparingFieldByField, isEqualToComparingFieldByFieldRecursively, isEqualToComparingOnlyGivenFields, isEqualToIgnoringGivenFields, isEqualToIgnoringNullFields, returns, usingComparatorForFields, usingComparatorForType

Methods inherited from class org.assertj.core.api.AbstractAssert

asList, asString, describedAs, describedAs, descriptionText, doesNotHave, doesNotHaveSameClassAs, equals, failWithMessage, getWritableAssertionInfo, has, hashCode, hasSameClassAs, hasToString, is, isEqualTo, isExactlyInstanceOf, isIn, isIn, isInstanceOf, isInstanceOfAny, isInstanceOfSatisfying, isNot, isNotEqualTo, isNotExactlyInstanceOf, isNotIn, isNotIn, isNotInstanceOf, isNotInstanceOfAny, isNotNull, isNotOfAnyClassIn, isNotSameAs, isNull, isOfAnyClassIn, isSameAs, matches, matches, overridingErrorMessage, satisfies, setCustomRepresentation, throwAssertionError, withFailMessage, withRepresentation, withThreadDumpOnError

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCharacterAssert

public AbstractCharacterAssert(Character actual,
                               Class<?> selfType)

Method Detail

isEqualTo

public SELF isEqualTo(char expected)

Verifies that the actual value is equal to the given one.

Example:

 // assertion will pass
 assertThat('a').isEqualTo('a');

 // assertions will fail
 assertThat('a').isEqualTo('b');
 assertThat('a').isEqualTo('A');

Parameters:

expected - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is not equal to the given one.

isNotEqualTo

public SELF isNotEqualTo(char other)

Verifies that the actual value is not equal to the given one.

Example:

 // assertions will pass
 assertThat('a').isNotEqualTo('b');
 assertThat('a').isNotEqualTo('A');

 // assertion will fail
 assertThat('a').isNotEqualTo('a');

Parameters:

other - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is equal to the given one.

isLessThan

public SELF isLessThan(char other)

Verifies that the actual value is less than the given one.

Example:

 // assertion will pass
 assertThat('A').isLessThan('a');
 assertThat('a').isLessThan('b');

 // assertion will fail
 assertThat('a').isLessThan('A');
 assertThat('b').isLessThan('a');

Parameters:

other - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is equal to or greater than the given one.

isLessThanOrEqualTo

public SELF isLessThanOrEqualTo(char other)

Verifies that the actual value is less than or equal to the given one.

Example:

 // assertion will pass
 assertThat('A').isLessThanOrEqualTo('a');
 assertThat('A').isLessThanOrEqualTo('A');

 // assertion will fail
 assertThat('b').isLessThanOrEqualTo('a');

Parameters:

other - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is greater than the given one.

isGreaterThan

public SELF isGreaterThan(char other)

Verifies that the actual value is greater than the given one.

Example:

 // assertion will pass
 assertThat('a').isGreaterThan('A');
 assertThat('b').isGreaterThan('a');

 // assertion will fail
 assertThat('A').isGreaterThan('a');
 assertThat('a').isGreaterThan('b');

Parameters:

other - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is equal to or less than the given one.

inUnicode

public SELF inUnicode()

Use unicode character representation instead of standard representation in error messages.

It can be useful when comparing UNICODE characters - many unicode chars have duplicate characters assigned, it is thus impossible to find differences from the standard error message:

With standard error message:

 assertThat('µ').isEqualTo('μ');

 org.junit.ComparisonFailure:
 Expected :'μ'
 Actual   :'µ'

With unicode based error message:

 assertThat('µ').inUnicode().isEqualTo('μ');

 org.junit.ComparisonFailure:
 Expected :μ
 Actual   :µ

Returns:

this assertion object.

isGreaterThanOrEqualTo

public SELF isGreaterThanOrEqualTo(char other)

Verifies that the actual value is greater than or equal to the given one.

Example:

 // assertion will pass
 assertThat('A').isGreaterThanOrEqualTo('A');
 assertThat('b').isGreaterThanOrEqualTo('a');
 
 // assertion will fail
 assertThat('a').isGreaterThanOrEqualTo('b');

Parameters:

other - the given value to compare the actual value to.

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is less than the given one.

isLowerCase

public SELF isLowerCase()

Verifies that the actual value is a lowercase character.

Example:

 // assertion will pass
 assertThat('a').isLowerCase();

 // assertion will fail
 assertThat('A').isLowerCase();

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is not a lowercase character.

isUpperCase

public SELF isUpperCase()

Verifies that the actual value is a uppercase character.

Example:

 // assertion will pass
 assertThat('A').isLowerCase();
 
 // assertion will fail
 assertThat('a').isLowerCase();

Returns:

this assertion object.

Throws:

AssertionError - if the actual value is null.

AssertionError - if the actual value is not a uppercase character.

usingComparator

public SELF usingComparator(Comparator<? super Character> customComparator)

Description copied from class: AbstractAssert

Use given custom comparator instead of relying on actual type A equals method for incoming assertion checks.

Custom comparator is bound to assertion instance, meaning that if a new assertion is created, it will use default comparison strategy. Examples :

 // frodo and sam are instances of Character with Hobbit race (obviously :).
 // raceComparator implements Comparator<Character> 
 assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam);

Specified by:

usingComparator in interface Assert<SELF extends AbstractCharacterAssert<SELF>,Character>

Overrides:

usingComparator in class AbstractComparableAssert<SELF extends AbstractCharacterAssert<SELF>,Character>

Parameters:

customComparator - the comparator to use for incoming assertion checks.

Returns:

this assertion object.

usingDefaultComparator

public SELF usingDefaultComparator()

Description copied from class: AbstractAssert

Revert to standard comparison for incoming assertion checks.

This method should be used to disable a custom comparison strategy set by calling Assert.usingComparator(Comparator).

Specified by:

usingDefaultComparator in interface Assert<SELF extends AbstractCharacterAssert<SELF>,Character>

Overrides:

usingDefaultComparator in class AbstractComparableAssert<SELF extends AbstractCharacterAssert<SELF>,Character>

Returns:

this assertion object.