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 AbstractLongAssert<SELF extends AbstractLongAssert<SELF>> extends AbstractComparableAssert<SELF,Long> implements NumberAssert<SELF,Long>
Long
s.actual, info, myself, throwUnsupportedExceptionOnEquals
Constructor and Description |
---|
AbstractLongAssert(Long actual,
Class<?> selfType) |
Modifier and Type | Method and Description |
---|---|
SELF |
isBetween(Long start,
Long end)
Verifies that the actual value is in [start, end] range (start included, end included).
|
SELF |
isCloseTo(long expected,
Offset<Long> offset)
Verifies that the actual number is close to the given one within the given offset value.
|
SELF |
isCloseTo(Long expected,
Offset<Long> offset)
Verifies that the actual number is close to the given one within the given offset value.
|
SELF |
isCloseTo(long 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(Long 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(long expected)
Verifies that the actual value is equal to the given one.
|
SELF |
isGreaterThan(long other)
Verifies that the actual value is greater than the given one.
|
SELF |
isGreaterThanOrEqualTo(long other)
Verifies that the actual value is greater than or equal to the given one.
|
SELF |
isLessThan(long other)
Verifies that the actual value is less than the given one.
|
SELF |
isLessThanOrEqualTo(long 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(long expected,
Offset<Long> offset)
Verifies that the actual number is not close to the given one by less than the given offset.
|
SELF |
isNotCloseTo(Long expected,
Offset<Long> offset)
Verifies that the actual number is not close to the given one by less than the given offset.
|
SELF |
isNotCloseTo(long expected,
Percentage percentage)
Verifies that the actual number is not close to the given one within the given percentage.
If difference is equal to the percentage value, the assertion fails. |
SELF |
isNotCloseTo(Long expected,
Percentage percentage)
Verifies that the actual number is not close to the given one within the given percentage.
If difference is equal to the percentage value, the assertion fails. |
SELF |
isNotEqualTo(long 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(Long start,
Long 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 Long> customComparator)
Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
|
SELF |
usingComparator(Comparator<? super Long> 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(long expected)
Example:
// assertions will pass:
assertThat(1L).isEqualTo(1L);
assertThat(-1L).isEqualTo(-1L);
// assertions will fail:
assertThat(1L).isEqualTo(2L);
assertThat(1L).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(long other)
Example:
// assertions will pass:
assertThat(1L).isNotEqualTo(2L);
assertThat(1L).isNotEqualTo(-1L);
// assertion will fail:
assertThat(1L).isNotEqualTo(1L);
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
this
assertion object.public SELF isLessThan(long other)
Example:
// assertions will pass:
assertThat(1L).isLessThan(2L);
assertThat(-2L).isLessThan(-1L);
// assertions will fail:
assertThat(1L).isLessThan(0L);
assertThat(1L).isLessThan(1L);
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(long other)
Example:
// assertions will pass:
assertThat(1L).isLessThanOrEqualTo(2L);
assertThat(-1L).isLessThanOrEqualTo(-2L);
assertThat(1L).isLessThanOrEqualTo(1L);
// assertions will fail:
assertThat(1L).isLessThanOrEqualTo(2L);
assertThat(-1L).isLessThanOrEqualTo(-2L);
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(long other)
Example:
// assertions will pass:
assertThat(1L).isGreaterThan(0L);
assertThat(-1L).isGreaterThan(-2L);
// assertions will fail:
assertThat(1L).isGreaterThan(2L);
assertThat(1L).isGreaterThan(1L);
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(long other)
Example:
// assertions will pass:
assertThat(2L).isGreaterThanOrEqualTo(1L);
assertThat(1L).isGreaterThanOrEqualTo(1L);
// assertions will fail:
assertThat(1L).isGreaterThanOrEqualTo(2L);
assertThat(-1L).isGreaterThanOrEqualTo(1L);
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(Long start, Long end)
Example:
// assertions will pass
assertThat(1L).isBetween(-1L, 2L);
assertThat(1L).isBetween(1L, 2L);
assertThat(1L).isBetween(0L, 1L);
// assertion will fail
assertThat(1L).isBetween(2L, 3L);
isBetween
in interface ComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
isBetween
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
isBetween
in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
start
- the start value (inclusive), expected not to be null.end
- the end value (inclusive), expected not to be null.public SELF isStrictlyBetween(Long start, Long end)
Example:
// assertion will pass
assertThat(1L).isStrictlyBetween(-1L, 2L);
// assertions will fail
assertThat(1L).isStrictlyBetween(1L, 2L);
assertThat(1L).isStrictlyBetween(0L, 1L);
assertThat(1L).isStrictlyBetween(2L, 3L);
isStrictlyBetween
in interface ComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
isStrictlyBetween
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
isStrictlyBetween
in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
start
- the start value (exclusive), expected not to be null.end
- the end value (exclusive), expected not to be null.public SELF isCloseTo(long expected, Offset<Long> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.within(Long)
or Offset.offset(Number)
Assertions.byLessThan(Long)
or Offset.strictOffset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Long)
implies a strict comparison,
use Assertions.within(Long)
to get the old behavior.
Examples:
// assertions succeed:
assertThat(5l).isCloseTo(7l, within(3l));
assertThat(5l).isCloseTo(7l, byLessThan(3l));
// if difference is exactly equals to the offset, it's ok ...
assertThat(5l).isCloseTo(7l, within(2l));
// ... but not with byLessThan which implies a strict comparison
assertThat(5l).isCloseTo(7l, byLessThan(2l)); // FAIL
// assertions fail
assertThat(5l).isCloseTo(7l, within(1l));
assertThat(5l).isCloseTo(7l, byLessThan(1l));
assertThat(5l).isCloseTo(7l, byLessThan(2l));
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(long expected, Offset<Long> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.byLessThan(Long)
or Offset.strictOffset(Number)
Assertions.within(Long)
or Offset.offset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Long)
implies a strict comparison,
use Assertions.within(Long)
to get the old behavior.
Examples:
// assertions will pass:
assertThat(5l).isNotCloseTo(7l, byLessThan(1l));
assertThat(5l).isNotCloseTo(7l, within(1l));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5l).isNotCloseTo(7l, byLessThan(2l));
// assertions will fail
assertThat(5l).isNotCloseTo(7l, within(2l));
assertThat(5l).isNotCloseTo(7l, byLessThan(3l));
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(Long)
public SELF isCloseTo(Long expected, Offset<Long> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.within(Long)
or Offset.offset(Number)
Assertions.byLessThan(Long)
or Offset.strictOffset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Long)
implies a strict comparison,
use Assertions.within(Long)
to get the old behavior.
Examples:
// assertions succeed:
assertThat(5L).isCloseTo(7L, within(3L));
assertThat(5L).isCloseTo(7L, byLessThan(3L));
// if difference is exactly equals to the offset, it's ok ...
assertThat(5L).isCloseTo(7L, within(2L));
// ... but not with byLessThan which implies a strict comparison
assertThat(5L).isCloseTo(7L, byLessThan(2L)); // FAIL
// assertions fail
assertThat(5L).isCloseTo(7L, within(1L));
assertThat(5L).isCloseTo(7L, byLessThan(1L));
assertThat(5L).isCloseTo(7L, byLessThan(2L));
isCloseTo
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
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(Long expected, Offset<Long> offset)
When abs(actual - expected) == offset value, the assertion:
Assertions.byLessThan(Long)
or Offset.strictOffset(Number)
Assertions.within(Long)
or Offset.offset(Number)
Breaking change since 2.9.0/3.9.0: using Assertions.byLessThan(Long)
implies a strict comparison,
use Assertions.within(Long)
to get the old behavior.
Examples:
// assertions will pass:
assertThat(5L).isNotCloseTo(7L, byLessThan(1L));
assertThat(5L).isNotCloseTo(7L, within(1L));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5L).isNotCloseTo(7L, byLessThan(2L));
// assertions will fail
assertThat(5L).isNotCloseTo(7L, within(2L));
assertThat(5L).isNotCloseTo(7L, byLessThan(3L));
isNotCloseTo
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
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(Long)
public SELF isCloseTo(Long expected, Percentage percentage)
Example with long:
// assertions will pass:
assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(20L));
// if difference is exactly equals to the computed offset (1L), it's ok
assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(10L));
// assertion will fail
assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(5L));
isCloseTo
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
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 to the given one.public SELF isNotCloseTo(Long expected, Percentage percentage)
Example with long:
// assertion will pass:
assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(5L));
// assertions will fail
assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(10L));
assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(20L));
isNotCloseTo
in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,Long>
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(long expected, Percentage percentage)
Example with long:
// assertions will pass:
assertThat(11L).isCloseTo(10L, withinPercentage(20L));
// if difference is exactly equals to the computed offset (1L), it's ok
assertThat(11L).isCloseTo(10L, withinPercentage(10L));
// assertion will fail
assertThat(11L).isCloseTo(10L, withinPercentage(5L));
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 to the given one.public SELF isNotCloseTo(long expected, Percentage percentage)
Example with long:
// assertion will pass:
assertThat(11L).isNotCloseTo(10L, withinPercentage(5L));
// assertions will fail
assertThat(11L).isNotCloseTo(10L, withinPercentage(10L));
assertThat(11L).isNotCloseTo(10L, withinPercentage(20L));
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 usingComparator(Comparator<? super Long> 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 AbstractLongAssert<SELF>,Long>
usingComparator
in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
customComparator
- the comparator to use for the incoming assertion checks.this
assertion object.public SELF usingComparator(Comparator<? super Long> 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 AbstractLongAssert<SELF>,Long>
usingComparator
in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
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 AbstractLongAssert<SELF>,Long>
usingDefaultComparator
in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,Long>
this
assertion object.Copyright © 2014–2019 AssertJ. All rights reserved.