public Class AtomicLongAssert

Verifies that the actual atomic has not the given value.

Example:

 // assertion will pass
assertThat(new AtomicLong(42)).doesNotHaveValue(0);

// assertion will fail
assertThat(new AtomicLong(42)).doesNotHaveValue(42);

Parameters

expectedValue:long

the value not expected .

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not non negative.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a negative value.

Example:

 // assertion will pass
assertThat(new AtomicLong(-42)).hasNegativeValue();

// assertions will fail
assertThat(new AtomicLong(0)).hasNegativeValue();
assertThat(new AtomicLong(42)).hasNegativeValue();

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not negative.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a non negative value (positive or equal zero).

Example:

 // assertions will pass
assertThat(new AtomicLong(42)).hasNonNegativeValue();
assertThat(new AtomicLong(0)).hasNonNegativeValue();

// assertion will fail
assertThat(new AtomicLong(-42)).hasNonNegativeValue();

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not non negative.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a non positive value (negative or equal zero).

Example:

 // assertions will pass
assertThat(new AtomicLong(-42)).hasNonPositiveValue();
assertThat(new AtomicLong(0)).hasNonPositiveValue();

// assertion will fail
assertThat(new AtomicLong(42)).hasNonPositiveValue();

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not non positive.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a positive value.

Example:

 // assertion will pass
assertThat(new AtomicLong(42)).hasPositiveValue();

// assertions will fail
assertThat(new AtomicLong(0)).hasPositiveValue();
assertThat(new AtomicLong(-1)).hasPositiveValue();

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not positive.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has the given value.

Example:

 // assertion will pass
assertThat(new AtomicLong(42)).hasValue(42);

// assertion will fail
assertThat(new AtomicLong(42)).hasValue(0);

Parameters

expectedValue:long

the value not expected .

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not non negative.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value in [start, end] range (start included, end included).

Example:

 AtomicLong actual =  new AtomicLong(5);

// assertions succeed
assertThat(actual).hasValueBetween(4, 6)
                  .hasValueBetween(4, 5)
                  .hasValueBetween(5, 6);

// assertions fail
assertThat(actual).hasValueBetween(6, 8)
                  .hasValueBetween(0, 4);

Parameters

startInclusive:long

the start value (inclusive).

endInclusive:long

the end value (inclusive).

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is not in [start, end] range.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value 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(new AtomicLong(11)).hasValueCloseTo(10, withinPercentage(20));

// if difference is exactly equals to the computed offset (1), it's ok
assertThat(new AtomicLong(11)).hasValueCloseTo(10, withinPercentage(10));

// assertion will fail
assertThat(new AtomicLong(11)).hasValueCloseTo(10, withinPercentage(5));

Parameters

expected:long

the given number to compare the actual value to.

percentage:Percentage

the given positive percentage.

Returns:AtomicLongAssert

this assertion object.

Exceptions

NullPointerException:

if the given Percentage is null.

AssertionError:

if the actual atomic value is not close enough to the given one.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value close to the given one within the given offset.

When abs(actual - expected) == offset value, the assertion:

• succeeds when using Assertions#within(Long) or Offset#offset(Number)
• fails when using 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.

Example with Long:

 // assertions will pass:
assertThat(new AtomicLong(5)).hasValueCloseTo(7L, within(3L))
                             .hasValueCloseTo(7L, byLessThan(3L));

// if the difference is exactly equals to the offset, it's ok ...
assertThat(new AtomicLong(5)).hasValueCloseTo(7L, within(2L));
// ... but not with byLessThan which implies a strict comparison
assertThat(new AtomicLong(5)).hasValueCloseTo(7L, byLessThan(2L)); // FAIL

// assertion will fail
assertThat(new AtomicLong(5)).hasValueCloseTo(7L, within(1L));
assertThat(new AtomicLong(5)).hasValueCloseTo(7L, byLessThan(1L));

Parameters

expected:long

the given number to compare the actual value to.

offset:Offset<Long>

the given allowed Offset.

Returns:AtomicLongAssert

this assertion object.

Exceptions

NullPointerException:

if the given Offset is null.

AssertionError:

if the actual atomic value is not close enough to the given one.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value strictly greater than the given one.

Example:

 // assertions will pass:
assertThat(new AtomicLong(1)).hasValueGreaterThan(0);
assertThat(new AtomicLong(-1)).hasValueGreaterThan(-2);

// assertions will fail:
assertThat(new AtomicLong(1)).hasValueGreaterThan(2)
                             .hasValueGreaterThan(1);

Parameters

other:long

the given value to compare the actual value to.

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if actual is null.
• if the actual atomic value is equal to or less than the given one.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value strictly greater than the given one.

Example:

 // assertions will pass:
assertThat(new AtomicLong(1)).hasValueGreaterThanOrEqualTo(0)     
                             .hasValueGreaterThanOrEqualTo(1);
assertThat(new AtomicLong(-1)).hasValueGreaterThanOrEqualTo(-2);

// assertion will fail:
assertThat(new AtomicLong(1)).hasValueGreaterThanOrEqualTo(2);

Parameters

other:long

the given value to compare the actual value to.

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is less than the given one.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value strictly less than the given one.

Example:

 // assertions will pass:
assertThat(new AtomicLong(1)).hasValueLessThan(2);
assertThat(new AtomicLong(-2)).hasValueLessThan(-1);

// assertions will fail:
assertThat(new AtomicLong(1)).hasValueLessThan(0)
                             .hasValueLessThan(1);

Parameters

other:long

the given value to compare the actual value to.

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual value is equal to or greater than the given one.

Since

2.7.0 / 3.7.0

Verifies that the actual atomic has a value strictly less than the given one.

Example:

 // assertions will pass:
assertThat(new AtomicLong(1)).hasValueLessThanOrEqualTo(1)
                             .hasValueLessThanOrEqualTo(2);
assertThat(new AtomicLong(-2)).hasValueLessThanOrEqualTo(-1);

// assertion will fail:
assertThat(new AtomicLong(1)).hasValueLessThanOrEqualTo(0);

Parameters

other:long

the given value to compare the actual value to.

Returns:AtomicLongAssert

this assertion object.

Exceptions

AssertionError:

• if the actual atomic is null.
• if the actual atomic value is greater than the given one.

Since

2.7.0 / 3.7.0

Overrides org.assertj.core.api.AbstractAssert.usingComparator.

Implements org.assertj.core.api.Assert.usingComparator.

Doc from org.assertj.core.api.AbstractAssert.usingComparator.

Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.

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

Parameters

customComparator:Comparator<? super AtomicLong>

Doc from org.assertj.core.api.Assert.usingComparator.

the comparator to use for the incoming assertion checks.

Returns:AtomicLongAssert

Doc from org.assertj.core.api.Assert.usingComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue

Overrides org.assertj.core.api.AbstractAssert.usingComparator.

Implements org.assertj.core.api.Assert.usingComparator.

Doc from org.assertj.core.api.AbstractAssert.usingComparator.

Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.

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

Parameters

customComparator:Comparator<? super AtomicLong>

Doc from org.assertj.core.api.Assert.usingComparator.

the comparator to use for the incoming assertion checks.

customComparatorDescription:String

Doc from org.assertj.core.api.Assert.usingComparator.

comparator description to be used in assertion error messages

Returns:AtomicLongAssert

Doc from org.assertj.core.api.Assert.usingComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue

Overrides org.assertj.core.api.AbstractAssert.usingDefaultComparator.

Implements org.assertj.core.api.Assert.usingDefaultComparator.

Doc from org.assertj.core.api.AbstractAssert.usingDefaultComparator.

Revert to standard comparison for the incoming assertion checks.

This method should be used to disable a custom comparison strategy set by calling usingComparator.

Returns:AtomicLongAssert

Doc from org.assertj.core.api.Assert.usingDefaultComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue