org.assertj.core.api

Class AbstractEnumerableAssert<S extends AbstractEnumerableAssert<S,A,E>,A,E>

java.lang.Object

org.assertj.core.api.AbstractAssert<S,A>

org.assertj.core.api.AbstractEnumerableAssert<S,A,E>

Type Parameters:

S - the "self" type of this assertion class.

A - the type of the "actual" value which is an Array of E.

E - the type of the "actual" array element.

All Implemented Interfaces:

Assert<S,A>, Descriptable<S>, EnumerableAssert<AbstractEnumerableAssert<S,A,E>,E>, ExtensionPoints<S,A>

Direct Known Subclasses:

AbstractArrayAssert

public abstract class AbstractEnumerableAssert<S extends AbstractEnumerableAssert<S,A,E>,A,E>
extends AbstractAssert<S,A>
implements EnumerableAssert<AbstractEnumerableAssert<S,A,E>,E>

Base implementation for Enumerable class assertions.

Author:

Joel Costigliola

Field Summary

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

actual, info, myself

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractEnumerableAssert(A actual, Class<?> selfType)

Method Summary

Modifier and Type	Method and Description
S	hasSameSizeAs(Object other) Verifies that the actual group has the same size as given array.
S	inBinary() Use binary object representation instead of standard representation in error messages.
S	inHexadecimal() Enable hexadecimal object representation of Iterable elements instead of standard java representation in error messages.

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.assertj.core.api.EnumerableAssert

hasSameSizeAs, hasSize, isEmpty, isNotEmpty, isNullOrEmpty, usingDefaultElementComparator, usingElementComparator

Constructor Detail

AbstractEnumerableAssert

protected AbstractEnumerableAssert(A actual,
                                   Class<?> selfType)

Method Detail

hasSameSizeAs

public S hasSameSizeAs(Object other)

Verifies that the actual group has the same size as given array.

Parameter is declared as Object to accept both Object[] and primitive arrays (e.g. int[]).

Example:

 int[] oneTwoThree = {1, 2, 3};
 Iterable<Ring> elvesRings = newArrayList(vilya, nenya, narya); 
 
 // assertions will pass
 assertThat(elvesRings).hasSameSizeAs(oneTwoThree);

Example with byte array:

 // assertions will pass
 assertThat(new byte[]{1, 2}).hasSameSizeAs(new byte[]{2, 3});
 assertThat(new byte[]{1, 2}).hasSameSizeAs(new Byte[]{2, 3});
 assertThat(new byte[]{1, 2}).hasSameSizeAs(new int[]{2, 3});
 assertThat(new byte[]{1, 2}).hasSameSizeAs(new String[]{"1", "2"});

 // assertion will fail
 assertThat(new byte[]{ 1, 2 }).hasSameSizeAs(new byte[]{ 1, 2, 3 });

Specified by:

hasSameSizeAs in interface EnumerableAssert<AbstractEnumerableAssert<S extends AbstractEnumerableAssert<S,A,E>,A,E>,E>

Parameters:

other - the array to compare size with actual group.

Returns:

this assertion object.

inHexadecimal

public S inHexadecimal()

Enable hexadecimal object representation of Iterable elements instead of standard java representation in error messages.

It can be useful to better understand what the error was with a more meaningful error message.

Example

 assertThat(new byte[]{0x10,0x20}).inHexadecimal().contains(new byte[]{0x30});

With standard error message:

 Expecting:
  <[16, 32]>
 to contain:
  <[48]>
 but could not find:
  <[48]>

With Hexadecimal error message:

 Expecting:
  <[0x10, 0x20]>
 to contain:
  <[0x30]>
 but could not find:
  <[0x30]>

Overrides:

inHexadecimal in class AbstractAssert<S extends AbstractEnumerableAssert<S,A,E>,A>

Returns:

this assertion object.

inBinary

public S inBinary()

Description copied from class: AbstractAssert

Use binary object representation instead of standard representation in error messages.

Example:

 assertThat(1).inBinary().isEqualTo(2);

 org.junit.ComparisonFailure:
 Expected :0b00000000_00000000_00000000_00000010
 Actual   :0b00000000_00000000_00000000_00000001

Overrides:

inBinary in class AbstractAssert<S extends AbstractEnumerableAssert<S,A,E>,A>

Returns:

this assertion object.