Class AbstractLongAssert<SELF extends AbstractLongAssert<SELF>>

    • Constructor Detail

      • AbstractLongAssert

        public AbstractLongAssert​(Long actual,
                                  Class<?> selfType)
    • Method Detail

      • isEqualTo

        public SELF isEqualTo​(long expected)
        Verifies that the actual value is equal to the given one.

        Example:

         // assertions will pass:
         assertThat(1L).isEqualTo(1L);
         assertThat(-1L).isEqualTo(-1L);
         
         // assertions will fail:
         assertThat(1L).isEqualTo(2L);
         assertThat(1L).isEqualTo(-1L);

        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​(long other)
        Verifies that the actual value is not equal to the given one.

        Example:

         // assertions will pass:
         assertThat(1L).isNotEqualTo(2L);
         assertThat(1L).isNotEqualTo(-1L);
         
         // assertion will fail:
         assertThat(1L).isNotEqualTo(1L);

        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.
      • isZero

        public SELF isZero()
        Verifies that the actual value is equal to zero.

        Example:

         // assertions will pass
         assertThat(0).isZero();
         assertThat(0.0).isZero();
        
         // assertions will fail
         assertThat(42).isZero();
         assertThat(3.142).isZero();
        Specified by:
        isZero in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isNotZero

        public SELF isNotZero()
        Verifies that the actual value is not equal to zero.

        Example:

         // assertions will pass
         assertThat(42).isNotZero();
         assertThat(3.142).isNotZero();
        
         // assertions will fail
         assertThat(0).isNotZero();
         assertThat(0.0).isNotZero();
        Specified by:
        isNotZero in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isOne

        public SELF isOne()
        Verifies that the actual value is equal to one.

        Example:

         // assertions will pass
         assertThat(1).isOne();
         assertThat(1.0).isOne();
        
         // assertions will fail
         assertThat(42).isOne();
         assertThat(3.142).isOne();
        Specified by:
        isOne in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isPositive

        public SELF isPositive()
        Verifies that the actual value is positive.

        Example:

         // assertions will pass
         assertThat(42).isPositive();
         assertThat(3.142).isPositive();
        
         // assertions will fail
         assertThat(0).isPositive();
         assertThat(-42).isPositive();
        Specified by:
        isPositive in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isNegative

        public SELF isNegative()
        Verifies that the actual value is negative.

        Example:

         // assertions will pass
         assertThat(-42).isNegative();
         assertThat(-3.124).isNegative();
        
         // assertions will fail
         assertThat(0).isNegative();
         assertThat(42).isNegative();
        Specified by:
        isNegative in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isNotNegative

        public SELF isNotNegative()
        Verifies that the actual value is non negative (positive or equal zero).

        Example:

         // assertions will pass
         assertThat(42).isNotNegative();
         assertThat(0).isNotNegative();
        
         // assertions will fail
         assertThat(-42).isNotNegative();
         assertThat(-3.124).isNotNegative();
        Specified by:
        isNotNegative in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isNotPositive

        public SELF isNotPositive()
        Verifies that the actual value is non positive (negative or equal zero).

        Example:

         // assertions will pass
         assertThat(-42).isNotPositive();
         assertThat(0).isNotPositive();
        
         // assertions will fail
         assertThat(42).isNotPositive();
         assertThat(3.124).isNotPositive();
        Specified by:
        isNotPositive in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Returns:
        this assertion object.
      • isLessThan

        public SELF isLessThan​(long other)
        Verifies that the actual value is less than the given one.

        Example:

         // assertions will pass:
         assertThat(1L).isLessThan(2L);
         assertThat(-2L).isLessThan(-1L);
         
         // assertions will fail:
         assertThat(1L).isLessThan(0L);
         assertThat(1L).isLessThan(1L);

        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​(long other)
        Verifies that the actual value is less than or equal to the given one.

        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);

        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​(long other)
        Verifies that the actual value is greater than the given one.

        Example:

         // assertions will pass:
         assertThat(1L).isGreaterThan(0L);
         assertThat(-1L).isGreaterThan(-2L);
         
         // assertions will fail:
         assertThat(1L).isGreaterThan(2L);
         assertThat(1L).isGreaterThan(1L);

        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.
      • isGreaterThanOrEqualTo

        public SELF isGreaterThanOrEqualTo​(long other)
        Verifies that the actual value is greater than or equal to the given one.

        Example:

         // assertions will pass:
         assertThat(2L).isGreaterThanOrEqualTo(1L);
         assertThat(1L).isGreaterThanOrEqualTo(1L);
         
         // assertions will fail:
         assertThat(1L).isGreaterThanOrEqualTo(2L);
         assertThat(-1L).isGreaterThanOrEqualTo(1L);

        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.
      • isCloseTo

        public SELF isCloseTo​(long expected,
                              Offset<Long> offset)
        Verifies that the actual long is close to the given one within the given offset.
        If difference is equal to offset value, assertion is considered valid.

        Example:

         // assertions will pass:
         assertThat(5L).isCloseTo(7L, within(3L));
        
         // if difference is exactly equals to the offset, it's ok
         assertThat(5L).isCloseTo(7L, within(2L));
        
         // assertion will fail
         assertThat(5L).isCloseTo(7L, within(1L));
        Parameters:
        expected - the given long to compare the actual value to.
        offset - the given positive offset.
        Returns:
        this assertion object.
        Throws:
        NullPointerException - if the given offset is null.
        AssertionError - if the actual value is not close to the given one.
      • isNotCloseTo

        public SELF isNotCloseTo​(long expected,
                                 Offset<Long> offset)
        Verifies that the actual long is not close to the given one by less than the given offset.
        If the difference is equal to the offset value, the assertion fails.

        Example:

         // assertion will pass:
         assertThat(5L).isNotCloseTo(7L, byLessThan(1L));
        
         // assertions will fail
         assertThat(5L).isNotCloseTo(7L, byLessThan(2L));
         assertThat(5L).isNotCloseTo(7L, byLessThan(3L));
        Parameters:
        expected - the given long to compare the actual value to.
        offset - the given positive offset.
        Returns:
        this assertion object.
        Throws:
        NullPointerException - if the given offset is null.
        AssertionError - if the actual value is close to the given one.
        Since:
        2.6.0 / 3.6.0
        See Also:
        Assertions.byLessThan(Long)
      • isCloseTo

        public SELF isCloseTo​(Long expected,
                              Offset<Long> offset)
        Verifies that the actual long is close to the given one within the given offset.
        If difference is equal to offset value, assertion is considered valid.

        Example:

         // assertions will pass:
         assertThat(5L).isCloseTo(Long.valueOf(7L), within(3L));
        
         // if difference is exactly equals to the offset, it's ok
         assertThat(5L).isCloseTo(Long.valueOf(7L), within(2L));
        
         // assertion will fail
         assertThat(5L).isCloseTo(Long.valueOf(7L), within(1L));
        Specified by:
        isCloseTo in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Parameters:
        expected - the given long to compare the actual value to.
        offset - the given positive offset.
        Returns:
        this assertion object.
        Throws:
        NullPointerException - if the given offset is null.
        AssertionError - if the actual value is not close to the given one.
      • isNotCloseTo

        public SELF isNotCloseTo​(Long expected,
                                 Offset<Long> offset)
        Verifies that the actual long is not close to the given one by less than the given offset.
        If the difference is equal to the offset value, the assertion fails.

        Example:

         // assertion will pass:
         assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(1L));
        
         // assertions will fail
         assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(2L));
         assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(3L));
        Specified by:
        isNotCloseTo in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Parameters:
        expected - the given long to compare the actual value to.
        offset - the given positive offset.
        Returns:
        this assertion object.
        Throws:
        NullPointerException - if the given offset is null.
        AssertionError - if the actual value is close to the given one.
        Since:
        2.6.0 / 3.6.0
        See Also:
        Assertions.byLessThan(Long)
      • isCloseTo

        public 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.

        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));
        Specified by:
        isCloseTo in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Parameters:
        expected - the given number to compare the actual value to.
        percentage - the given positive percentage.
        Returns:
        this assertion object.
        Throws:
        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.
      • isNotCloseTo

        public 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.

        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));
        Specified by:
        isNotCloseTo in interface NumberAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Parameters:
        expected - the given number to compare the actual value to.
        percentage - the given positive percentage.
        Returns:
        this assertion object.
        Throws:
        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.
        Since:
        2.6.0 / 3.6.0
      • isCloseTo

        public 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.

        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));
        Parameters:
        expected - the given number to compare the actual value to.
        percentage - the given positive percentage.
        Returns:
        this assertion object.
        Throws:
        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.
      • isNotCloseTo

        public 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.

        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));
        Parameters:
        expected - the given number to compare the actual value to.
        percentage - the given positive percentage.
        Returns:
        this assertion object.
        Throws:
        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.
        Since:
        2.6.0 / 3.6.0
      • usingComparator

        public SELF usingComparator​(Comparator<? super Long> 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 AbstractLongAssert<SELF>,​Long>
        Overrides:
        usingComparator in class AbstractComparableAssert<SELF extends AbstractLongAssert<SELF>,​Long>
        Parameters:
        customComparator - the comparator to use for incoming assertion checks.
        Returns:
        this assertion object.