SELF
- the "self" type of this assertion class. Please read "Emulating
'self types' using Java Generics to simplify fluent API implementation" for more details.ACTUAL
- the type of the "actual" value.FloatingPointNumberAssert<SELF,ACTUAL>
AbstractBigDecimalAssert
, AbstractBigIntegerAssert
, AbstractByteAssert
, AbstractDoubleAssert
, AbstractFloatAssert
, AbstractIntegerAssert
, AbstractIterableSizeAssert
, AbstractLongAssert
, AbstractMapSizeAssert
, AbstractShortAssert
, BigDecimalAssert
, BigIntegerAssert
, ByteAssert
, DoubleAssert
, FloatAssert
, IntegerAssert
, IterableSizeAssert
, LongAssert
, MapSizeAssert
, ShortAssert
public interface NumberAssert<SELF extends NumberAssert<SELF,ACTUAL>,ACTUAL extends Number>
Number
s.Modifier and Type | Method | Description |
---|---|---|
SELF |
isBetween(ACTUAL start,
ACTUAL end) |
Verifies that the actual value is in [start, end] range (start included, end included).
|
SELF |
isCloseTo(ACTUAL expected,
Offset<ACTUAL> offset) |
Verifies that the actual number is close to the given one within the given offset.
If difference is equal to offset value, assertion is considered valid. |
SELF |
isCloseTo(ACTUAL 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 |
isNegative() |
Verifies that the actual value is negative.
|
SELF |
isNotCloseTo(ACTUAL expected,
Offset<ACTUAL> offset) |
Verifies that the actual number is not close to the given one within the given offset.
If the difference is equal to the offset value, the assertion fails. |
SELF |
isNotCloseTo(ACTUAL 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 |
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(ACTUAL start,
ACTUAL 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 isZero()
Example:
// assertions will pass
assertThat(0).isZero();
assertThat(0.0).isZero();
// assertions will fail
assertThat(42).isZero();
assertThat(3.142).isZero();
AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not equal to zero.SELF isNotZero()
Example:
// assertions will pass
assertThat(42).isNotZero();
assertThat(3.142).isNotZero();
// assertions will fail
assertThat(0).isNotZero();
assertThat(0.0).isNotZero();
AssertionError
- if the actual value is null
.AssertionError
- if the actual value is equal to zero.SELF isOne()
Example:
// assertions will pass
assertThat(1).isOne();
assertThat(1.0).isOne();
// assertions will fail
assertThat(42).isOne();
assertThat(3.142).isOne();
AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not equal to one.SELF isPositive()
Example:
// assertions will pass
assertThat(42).isPositive();
assertThat(3.142).isPositive();
// assertions will fail
assertThat(0).isPositive();
assertThat(-42).isPositive();
AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not positive.SELF isNegative()
Example:
// assertions will pass
assertThat(-42).isNegative();
assertThat(-3.124).isNegative();
// assertions will fail
assertThat(0).isNegative();
assertThat(42).isNegative();
AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not negative.SELF isNotNegative()
Example:
// assertions will pass
assertThat(42).isNotNegative();
assertThat(0).isNotNegative();
// assertions will fail
assertThat(-42).isNotNegative();
assertThat(-3.124).isNotNegative();
this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not non negative.SELF isNotPositive()
Example:
// assertions will pass
assertThat(-42).isNotPositive();
assertThat(0).isNotPositive();
// assertions will fail
assertThat(42).isNotPositive();
assertThat(3.124).isNotPositive();
this
assertion object.AssertionError
- if the actual value is null
.AssertionError
- if the actual value is not non positive.SELF isBetween(ACTUAL start, ACTUAL end)
Example:
// these assertions succeed ...
assertThat(12).isBetween(10, 14);
assertThat(12).isBetween(12, 14);
assertThat(12).isBetween(10, 12);
// ... but this one fails
assertThat(12).isBetween(14, 16);
start
- the start value (inclusive), expected not to be null.end
- the end value (inclusive), expected not to be null.AssertionError
- if the actual value is null
.NullPointerException
- if start value is null
.NullPointerException
- if end value is null
.AssertionError
- if the actual value is not in [start, end] range.SELF isStrictlyBetween(ACTUAL start, ACTUAL end)
Example:
// this assertion succeeds ...
assertThat(12).isStrictlyBetween(10, 14);
// ... but these ones fail
assertThat(12).isStrictlyBetween(12, 14);
assertThat(12).isStrictlyBetween(10, 12);
assertThat(12).isStrictlyBetween(16, 18);
start
- the start value (exclusive), expected not to be null.end
- the end value (exclusive), expected not to be null.AssertionError
- if the actual value is null
.NullPointerException
- if start value is null
.NullPointerException
- if end value is null
.AssertionError
- if the actual value is not in ]start, end[ range.SELF isCloseTo(ACTUAL expected, Offset<ACTUAL> offset)
Example with double:
// assertions will pass:
assertThat(8.1).isCloseTo(8.0, within(0.2));
// you can use offset if you prefer
assertThat(8.1).isCloseTo(8.0, offset(0.2));
// if difference is exactly equals to the offset (0.1), it's ok
assertThat(8.1).isCloseTo(8.0, within(0.1));
// assertion will fail
assertThat(8.1).isCloseTo(8.0, within(0.01));
expected
- the given number to compare the actual value to.offset
- the given positive offset.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.SELF isNotCloseTo(ACTUAL expected, Offset<ACTUAL> offset)
Example with double:
// assertions will pass:
assertThat(8.1).isNotCloseTo(8.0, byLessThan(0.01));
// you can use offset if you prefer
assertThat(8.1).isNotCloseTo(8.0, offset(0.01));
// assertions will fail
assertThat(8.1).isNotCloseTo(8.0, byLessThan(0.1));
assertThat(8.1).isNotCloseTo(8.0, byLessThan(0.2));
expected
- the given number to compare the actual value to.offset
- the given positive offset.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.SELF isCloseTo(ACTUAL expected, Percentage percentage)
Example with double:
// assertions will pass:
assertThat(11.0).isCloseTo(10.0, withinPercentage(20));
// if difference is exactly equals to the computed offset (1.0), it's ok
assertThat(11.0).isCloseTo(10.0, withinPercentage(10));
// assertion will fail
assertThat(11.0).isCloseTo(10.0, 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 close to the given one.SELF isNotCloseTo(ACTUAL expected, Percentage percentage)
Example with double:
// assertions will pass:
assertThat(11.0).isNotCloseTo(10.0, withinPercentage(5));
// assertions will fail
assertThat(11.0).isNotCloseTo(10.0, withinPercentage(10));
assertThat(11.0).isNotCloseTo(10.0, withinPercentage(20));
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.Copyright © 2014–2019. All rights reserved.