SELF
- the "self" type of this assertion class. Please read "Emulating 'self types' using Java Generics to simplify fluent API implementation"
for more details.public abstract class AbstractIntegerAssert<SELF extends AbstractIntegerAssert<SELF>> extends AbstractComparableAssert<SELF,Integer> implements NumberAssert<SELF,Integer>
Integer
s.actual, info, myself, throwUnsupportedExceptionOnEquals
Constructor and Description |
---|
AbstractIntegerAssert(Integer actual,
Class<?> selfType) |
Modifier and Type | Method and Description |
---|---|
SELF |
isBetween(Integer start,
Integer end)
Verifies that the actual value is in [start, end] range (start included, end included).
|
SELF |
isCloseTo(Integer expected,
Offset<Integer> offset)
Verifies that the actual number is close to the given one within the given offset value.
|
SELF |
isCloseTo(Integer expected,
Percentage percentage)
Verifies that the actual number is close to the given one within the given percentage.
If difference is equal to the percentage value, assertion is considered valid. |
SELF |
isCloseTo(int expected,
Offset<Integer> offset)
Verifies that the actual number is close to the given one within the given offset value.
|
SELF |
isCloseTo(int expected,
Percentage percentage)
Verifies that the actual number is close to the given one within the given percentage.
If difference is equal to the percentage value, assertion is considered valid. |
SELF |
isEqualTo(int expected)
Verifies that the actual value is equal to the given one.
|
SELF |
isEqualTo(long expected)
Verifies that the actual value is equal to the given long.
|
SELF |
isGreaterThan(int other)
Verifies that the actual value is greater than the given one.
|
SELF |
isGreaterThanOrEqualTo(int other)
Verifies that the actual value is greater than or equal to the given one.
|
SELF |
isLessThan(int other)
Verifies that the actual value is less than the given one.
|
SELF |
isLessThanOrEqualTo(int other)
Verifies that the actual value is less than or equal to the given one.
|
SELF |
isNegative()
Verifies that the actual value is negative.
|
SELF |
isNotCloseTo(Integer expected,
Offset<Integer> offset)
Verifies that the actual number is not close to the given one by less than the given offset.
|
SELF |
isNotCloseTo(Integer expected,
Percentage percentage)
Verifies that the actual number is not close to the given one by the given percentage.
If difference is equal to the percentage value, the assertion fails. |
SELF |
isNotCloseTo(int expected,
Offset<Integer> offset)
Verifies that the actual number is not close to the given one by less than the given offset.
|
SELF |
isNotCloseTo(int expected,
Percentage percentage)
Verifies that the actual number is not close to the given one by the given percentage.
If difference is equal to the percentage value, the assertion fails. |
SELF |
isNotEqualTo(int other)
Verifies that the actual value is not equal to the given one.
|
SELF |
isNotNegative()
Verifies that the actual value is non negative (positive or equal zero).
|
SELF |
isNotPositive()
Verifies that the actual value is non positive (negative or equal zero).
|
SELF |
isNotZero()
Verifies that the actual value is not equal to zero.
|
SELF |
isOne()
Verifies that the actual value is equal to one.
|
SELF |
isPositive()
Verifies that the actual value is positive.
|
SELF |
isStrictlyBetween(Integer start,
Integer end)
Verifies that the actual value is in ]start, end[ range (start excluded, end excluded).
|
SELF |
isZero()
Verifies that the actual value is equal to zero.
|
SELF |
usingComparator(Comparator<? super Integer> customComparator)
Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
|
SELF |
usingComparator(Comparator<? super Integer> customComparator,
String customComparatorDescription)
Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
|
SELF |
usingDefaultComparator()
Revert to standard comparison for the incoming assertion checks.
|
inBinary, inHexadecimal, isEqualByComparingTo, isGreaterThan, isGreaterThanOrEqualTo, isLessThan, isLessThanOrEqualTo, isNotEqualByComparingTo
as, as, extracting, extracting, extracting, getComparatorsByType, hasAllNullFieldsOrProperties, hasAllNullFieldsOrPropertiesExcept, hasFieldOrProperty, hasFieldOrPropertyWithValue, hasNoNullFieldsOrProperties, hasNoNullFieldsOrPropertiesExcept, isEqualToComparingFieldByField, isEqualToComparingFieldByFieldRecursively, isEqualToComparingOnlyGivenFields, isEqualToIgnoringGivenFields, isEqualToIgnoringNullFields, newObjectAssert, returns, usingComparatorForFields, usingComparatorForType, usingRecursiveComparison, usingRecursiveComparison
asList, asString, describedAs, describedAs, descriptionText, doesNotHave, doesNotHaveSameClassAs, equals, failWithMessage, getWritableAssertionInfo, has, hashCode, hasSameClassAs, hasSameHashCodeAs, hasToString, is, isEqualTo, isExactlyInstanceOf, isIn, isIn, isInstanceOf, isInstanceOfAny, isInstanceOfSatisfying, isNot, isNotEqualTo, isNotExactlyInstanceOf, isNotIn, isNotIn, isNotInstanceOf, isNotInstanceOfAny, isNotNull, isNotOfAnyClassIn, isNotSameAs, isNull, isOfAnyClassIn, isSameAs, matches, matches, newListAssertInstance, overridingErrorMessage, satisfies, satisfies, satisfiesAnyOf, satisfiesAnyOf, setCustomRepresentation, throwAssertionError, withFailMessage, withRepresentation, withThreadDumpOnError
public SELF isEqualTo(int expected)
Example:
// assertions will pass:
assertThat(1).isEqualTo(1);
assertThat(-1).isEqualTo(-1);
// assertions will fail:
assertThat(1).isEqualTo(2);
assertThat(1).isEqualTo(-1);
expected
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not equal to the given one.public SELF isEqualTo(long expected)
Integer.MIN_VALUE
, Integer.MAX_VALUE
], the assertion simply fails.
Example:
// assertions will pass:
assertThat(1).isEqualTo(1L);
assertThat(-1).isEqualTo(-1L);
// assertions will fail:
assertThat(1).isEqualTo(2L);
assertThat(1).isEqualTo(-1L);
expected
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not equal to the given one.public SELF isNotEqualTo(int other)
Example:
// assertions will pass:
assertThat(1).isNotEqualTo(2);
assertThat(1).isNotEqualTo(-1);
// assertion will fail:
assertThat(1).isNotEqualTo(1);
other
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is equal to the given one.public SELF isZero()
Example:
// assertions will pass
assertThat(0).isZero();
assertThat(0.0).isZero();
// assertions will fail
assertThat(42).isZero();
assertThat(3.142).isZero();
isZero
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
public SELF isNotZero()
Example:
// assertions will pass
assertThat(42).isNotZero();
assertThat(3.142).isNotZero();
// assertions will fail
assertThat(0).isNotZero();
assertThat(0.0).isNotZero();
isNotZero
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
public SELF isOne()
Example:
// assertions will pass
assertThat(1).isOne();
assertThat(1.0).isOne();
// assertions will fail
assertThat(42).isOne();
assertThat(3.142).isOne();
isOne
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
public SELF isPositive()
Example:
// assertions will pass
assertThat(42).isPositive();
assertThat(3.142).isPositive();
// assertions will fail
assertThat(0).isPositive();
assertThat(-42).isPositive();
isPositive
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
public SELF isNegative()
Example:
// assertions will pass
assertThat(-42).isNegative();
assertThat(-3.124).isNegative();
// assertions will fail
assertThat(0).isNegative();
assertThat(42).isNegative();
isNegative
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
public SELF isNotNegative()
Example:
// assertions will pass
assertThat(42).isNotNegative();
assertThat(0).isNotNegative();
// assertions will fail
assertThat(-42).isNotNegative();
assertThat(-3.124).isNotNegative();
isNotNegative
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
this
assertion object.public SELF isNotPositive()
Example:
// assertions will pass
assertThat(-42).isNotPositive();
assertThat(0).isNotPositive();
// assertions will fail
assertThat(42).isNotPositive();
assertThat(3.124).isNotPositive();
isNotPositive
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
this
assertion object.public SELF isLessThan(int other)
Example:
// assertions will pass:
assertThat(1).isLessThan(2);
assertThat(-2).isLessThan(-1);
// assertions will fail:
assertThat(1).isLessThan(0);
assertThat(1).isLessThan(1);
other
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is equal to or greater than the given one.public SELF isLessThanOrEqualTo(int other)
Example:
// assertions will pass:
assertThat(1).isLessThanOrEqualTo(2);
assertThat(-1).isLessThanOrEqualTo(-2);
assertThat(1).isLessThanOrEqualTo(1);
// assertions will fail:
assertThat(1).isLessThanOrEqualTo(2);
assertThat(-1).isLessThanOrEqualTo(-2);
other
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is greater than the given one.public SELF isGreaterThan(int other)
Example:
// assertions will pass:
assertThat(1).isGreaterThan(0);
assertThat(-1).isGreaterThan(-2);
// assertions will fail:
assertThat(1).isGreaterThan(2);
assertThat(1).isGreaterThan(1);
other
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is equal to or less than the given one.public SELF isGreaterThanOrEqualTo(int other)
Example:
// assertions will pass:
assertThat(2).isGreaterThanOrEqualTo(1);
assertThat(1).isGreaterThanOrEqualTo(1);
// assertions will fail:
assertThat(1).isGreaterThanOrEqualTo(2);
assertThat(-1).isGreaterThanOrEqualTo(1);
other
- the given value to compare the actual value to.this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is less than the given one.public SELF isBetween(Integer start, Integer end)
Example:
// assertions will pass
assertThat(1).isBetween(-1, 2);
assertThat(1).isBetween(1, 2);
assertThat(1).isBetween(0, 1);
// assertion will fail
assertThat(1).isBetween(2, 3);
isBetween
in interface ComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
isBetween
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
isBetween
in class AbstractComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
start
- the start value (inclusive), expected not to be null.end
- the end value (inclusive), expected not to be null.public SELF isStrictlyBetween(Integer start, Integer end)
Example:
// assertion will pass
assertThat(1).isStrictlyBetween(-1, 2);
// assertions will fail
assertThat(1).isStrictlyBetween(1, 2);
assertThat(1).isStrictlyBetween(0, 1);
assertThat(1).isStrictlyBetween(2, 3);
isStrictlyBetween
in interface ComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
isStrictlyBetween
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
isStrictlyBetween
in class AbstractComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
start
- the start value (exclusive), expected not to be null.end
- the end value (exclusive), expected not to be null.public SELF isCloseTo(int expected, Offset<Integer> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.within(Integer)
Assertions.byLessThan(Integer)
or Offset.strictOffset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Integer)
implies a strict comparison,
use Assertions.within(Integer)
to get the old behavior.
Examples:
// assertions will pass:
assertThat(5).isCloseTo(7, within(3));
assertThat(5).isCloseTo(7, byLessThan(3));
// if difference is exactly equals to the offset, it's ok ...
assertThat(5).isCloseTo(7, within(2));
// ... but not with byLessThan which implies a strict comparison
assertThat(5).isCloseTo(7, byLessThan(2)); // FAIL
// assertions will fail
assertThat(5).isCloseTo(7, within(1));
assertThat(5).isCloseTo(7, byLessThan(1));
assertThat(5).isCloseTo(7, byLessThan(2));
expected
- the given int to compare the actual value to.offset
- the given positive offset.this
assertion object.NullPointerException
- if the given offset is null
.AssertionError
- if the actual value is not close enough to the given one.public SELF isNotCloseTo(int expected, Offset<Integer> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.byLessThan(Integer)
or Offset.strictOffset(Number)
Assertions.within(Integer)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Integer)
implies a strict comparison,
use Assertions.within(Integer)
to get the old behavior.
Examples:
// assertions will pass:
assertThat(5).isNotCloseTo(7, byLessThan(1));
assertThat(5).isNotCloseTo(7, within(1));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5).isNotCloseTo(7, byLessThan(2));
// assertions will fail
assertThat(5).isNotCloseTo(7, within(2));
assertThat(5).isNotCloseTo(7, byLessThan(3));
expected
- the given int to compare the actual value to.offset
- the given positive offset.this
assertion object.NullPointerException
- if the given offset is null
.AssertionError
- if the actual value is close to the given one.Assertions.byLessThan(Integer)
public SELF isCloseTo(Integer expected, Offset<Integer> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.within(Integer)
Assertions.byLessThan(Integer)
or Offset.strictOffset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Integer)
implies a strict comparison,
use Assertions.within(Integer)
to get the old behavior.
Examples:
// assertions succeed:
assertThat(5).isCloseTo(7, within(3));
assertThat(5).isCloseTo(7, byLessThan(3));
// if difference is exactly equals to the offset, it's ok ...
assertThat(5).isCloseTo(7, within(2));
// ... but not with byLessThan which implies a strict comparison
assertThat(5).isCloseTo(7, byLessThan(2)); // FAIL
// assertions fail
assertThat(5).isCloseTo(7, within(1));
assertThat(5).isCloseTo(7, byLessThan(1));
assertThat(5).isCloseTo(7, byLessThan(2));
isCloseTo
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
expected
- the given int to compare the actual value to.offset
- the given positive offset.this
assertion object.NullPointerException
- if the given offset is null
.AssertionError
- if the actual value is not close enough to the given one.public SELF isNotCloseTo(Integer expected, Offset<Integer> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.byLessThan(Integer)
or Offset.strictOffset(Number)
Assertions.within(Integer)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Integer)
implies a strict comparison,
use Assertions.within(Integer)
to get the old behavior.
Examples:
// assertions will pass:
assertThat(5).isNotCloseTo(7, byLessThan(1));
assertThat(5).isNotCloseTo(7, within(1));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5).isNotCloseTo(7, byLessThan(2));
// assertions will fail
assertThat(5).isNotCloseTo(7, within(2));
assertThat(5).isNotCloseTo(7, byLessThan(3));
isNotCloseTo
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
expected
- the given int to compare the actual value to.offset
- the given positive offset.this
assertion object.NullPointerException
- if the given offset is null
.AssertionError
- if the actual value is close to the given one.Assertions.byLessThan(Integer)
public SELF isCloseTo(Integer expected, Percentage percentage)
Example with integer:
// assertions will pass:
assertThat(11).isCloseTo(Integer.valueOf(10), withinPercentage(20));
// if difference is exactly equals to the computed offset (1), it's ok
assertThat(11).isCloseTo(Integer.valueOf(10), withinPercentage(10));
// assertion will fail
assertThat(11).isCloseTo(Integer.valueOf(10), withinPercentage(5));
isCloseTo
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
expected
- the given number to compare the actual value to.percentage
- the given positive percentage.this
assertion object.NullPointerException
- if the given offset is null
.NullPointerException
- if the expected number is null
.AssertionError
- if the actual value is not equal to the given one.public SELF isNotCloseTo(Integer expected, Percentage percentage)
Example with integer:
// assertion will pass:
assertThat(11).isNotCloseTo(Integer.valueOf(10), withinPercentage(5));
// assertions will fail
assertThat(11).isNotCloseTo(Integer.valueOf(10), withinPercentage(10));
assertThat(11).isNotCloseTo(Integer.valueOf(10), withinPercentage(20));
isNotCloseTo
in interface NumberAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
expected
- the given number to compare the actual value to.percentage
- the given positive percentage.this
assertion object.NullPointerException
- if the given offset is null
.NullPointerException
- if the expected number is null
.AssertionError
- if the actual value is close to the given one.public SELF isCloseTo(int expected, Percentage percentage)
Example with integer:
// assertions will pass:
assertThat(11).isCloseTo(10, withinPercentage(20));
// if difference is exactly equals to the computed offset (1), it's ok
assertThat(11).isCloseTo(10, withinPercentage(10));
// assertion will fail
assertThat(11).isCloseTo(10, withinPercentage(5));
expected
- the given number to compare the actual value to.percentage
- the given positive percentage.this
assertion object.NullPointerException
- if the given offset is null
.NullPointerException
- if the expected number is null
.AssertionError
- if the actual value is not close enough to the given one.public SELF isNotCloseTo(int expected, Percentage percentage)
Example with integer:
// assertion will pass:
assertThat(11).isNotCloseTo(10, withinPercentage(5));
// assertions will fail
assertThat(11).isNotCloseTo(10, withinPercentage(10));
assertThat(11).isNotCloseTo(10, withinPercentage(20));
expected
- the given number to compare the actual value to.percentage
- the given positive percentage.this
assertion object.NullPointerException
- if the given Percentage
is null
.NullPointerException
- if the expected number is null
.AssertionError
- if the actual value is close to the given one.public SELF usingComparator(Comparator<? super Integer> customComparator)
AbstractAssert
The custom comparator is bound to assertion instance, meaning that if a new assertion instance is created, the default comparison strategy will be used.
Examples :
// frodo and sam are instances of Character with Hobbit race (obviously :).
// raceComparator implements Comparator<Character>
assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam);
usingComparator
in interface Assert<SELF extends AbstractIntegerAssert<SELF>,Integer>
usingComparator
in class AbstractComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
customComparator
- the comparator to use for the incoming assertion checks.this
assertion object.public SELF usingComparator(Comparator<? super Integer> customComparator, String customComparatorDescription)
AbstractAssert
The custom comparator is bound to assertion instance, meaning that if a new assertion instance is created, the default comparison strategy will be used.
Examples :
// frodo and sam are instances of Character with Hobbit race (obviously :).
// raceComparator implements Comparator<Character>
assertThat(frodo).usingComparator(raceComparator, "Hobbit Race Comparator").isEqualTo(sam);
usingComparator
in interface Assert<SELF extends AbstractIntegerAssert<SELF>,Integer>
usingComparator
in class AbstractComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
customComparator
- the comparator to use for the incoming assertion checks.customComparatorDescription
- comparator description to be used in assertion error messagesthis
assertion object.public SELF usingDefaultComparator()
AbstractAssert
This method should be used to disable a custom comparison strategy set by calling usingComparator
.
usingDefaultComparator
in interface Assert<SELF extends AbstractIntegerAssert<SELF>,Integer>
usingDefaultComparator
in class AbstractComparableAssert<SELF extends AbstractIntegerAssert<SELF>,Integer>
this
assertion object.Copyright © 2014–2019 AssertJ. All rights reserved.