org.fest.assertions.api
Class IntegerAssert

java.lang.Object
  extended by org.fest.assertions.api.AbstractAssert<S,A>
      extended by org.fest.assertions.api.AbstractComparableAssert<IntegerAssert,Integer>
          extended by org.fest.assertions.api.IntegerAssert
All Implemented Interfaces:
Assert<IntegerAssert,Integer>, ComparableAssert<IntegerAssert,Integer>, Descriptable<IntegerAssert>, ExtensionPoints<IntegerAssert,Integer>, NumberAssert<Integer>

public class IntegerAssert
extends AbstractComparableAssert<IntegerAssert,Integer>
implements NumberAssert<Integer>

Assertion methods for integers.

To create an instance of this class, invoke Assertions.assertThat(Integer) or Assertions.assertThat(int).

Author:
Yvonne Wang, David DIDIER, Ansgar Konermann, Alex Ruiz, Joel Costigliola

Field Summary
 
Fields inherited from class org.fest.assertions.api.AbstractAssert
actual, myself
 
Constructor Summary
protected IntegerAssert(Integer actual)
           
 
Method Summary
 IntegerAssert isEqualTo(int expected)
          Verifies that the actual value is equal to the given one.
 IntegerAssert isGreaterThan(int other)
          Verifies that the actual value is greater than the given one.
 IntegerAssert isGreaterThanOrEqualTo(int other)
          Verifies that the actual value is greater than or equal to the given one.
 IntegerAssert isLessThan(int other)
          Verifies that the actual value is less than the given one.
 IntegerAssert isLessThanOrEqualTo(int other)
          Verifies that the actual value is less than or equal to the given one.
 IntegerAssert isNegative()
          Verifies that the actual value is negative.
 IntegerAssert isNotEqualTo(int other)
          Verifies that the actual value is not equal to the given one.
 IntegerAssert isNotZero()
          Verifies that the actual value is not equal to zero.
 IntegerAssert isPositive()
          Verifies that the actual value is positive.
 IntegerAssert isZero()
          Verifies that the actual value is equal to zero.
 IntegerAssert usingComparator(Comparator<?> customComparator)
          Use given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
 IntegerAssert usingDefaultComparator()
          Revert to standard comparison for incoming assertion checks.
 
Methods inherited from class org.fest.assertions.api.AbstractComparableAssert
isGreaterThan, isGreaterThanOrEqualTo, isLessThan, isLessThanOrEqualTo
 
Methods inherited from class org.fest.assertions.api.AbstractAssert
as, as, describedAs, describedAs, descriptionText, doesNotHave, equals, has, hashCode, is, isEqualTo, isIn, isIn, isNot, isNotEqualTo, isNotIn, isNotIn, isNotNull, isNotSameAs, isNull, isSameAs
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IntegerAssert

protected IntegerAssert(Integer actual)
Method Detail

isEqualTo

public IntegerAssert isEqualTo(int expected)
Verifies that the actual value is equal to the given one.

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

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 IntegerAssert isZero()
Verifies that the actual value is equal to zero.

Specified by:
isZero in interface NumberAssert<Integer>
Returns:
this assertion object.

isNotZero

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

Specified by:
isNotZero in interface NumberAssert<Integer>
Returns:
this assertion object.

isPositive

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

Specified by:
isPositive in interface NumberAssert<Integer>
Returns:
this assertion object.

isNegative

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

Specified by:
isNegative in interface NumberAssert<Integer>
Returns:
this assertion object.

isLessThan

public IntegerAssert isLessThan(int other)
Verifies that the actual value is less than the given one.

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

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

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 IntegerAssert isGreaterThanOrEqualTo(int other)
Verifies that the actual value is greater than or equal to the given one.

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.

usingComparator

public IntegerAssert usingComparator(Comparator<?> 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.

Example :
 // compares invoices by payee 
 assertThat(invoiceList).usingComparator(invoicePayeeComparator).isEqualTo(expectedInvoiceList).
 
 // compares invoices by date, doesNotHaveDuplicates and contains both use the given invoice date comparator
 assertThat(invoiceList).usingComparator(invoiceDateComparator).doesNotHaveDuplicates().contains(may2010Invoice)
 
 // as assertThat(invoiceList) creates a new assertion, it uses standard comparison strategy (Invoice's equal method) to compare invoiceList elements to lowestInvoice.                                                      
 assertThat(invoiceList).contains(lowestInvoice).
 
Custom comparator is not parameterized with actual type A (ie. Comparator<A>) because if it was, we could not write the following code :
 // frodo and sam are instances of Character (a Character having a Race)
 // raceComparator implements Comparator<Character> 
 // assertThat(frodo) returns an ObjectAssert and not a custom CharacterAssert implementing Assert<CharacterAssert, Character>  
 assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam); // won't compile !
 
 The code does not compile because assertThat(frodo) returns an ObjectAssert, thus usingComparator expects a Comparator<Object> 
 and Comparator<Character> is not a Comparator<Object> as generics are not reified.
 
 Note that, it would have worked if assertThat(frodo) returned a CharacterAssert implementing Assert<CharacterAssert, Character>. 
 

Specified by:
usingComparator in interface Assert<IntegerAssert,Integer>
Overrides:
usingComparator in class AbstractComparableAssert<IntegerAssert,Integer>
Parameters:
customComparator - the comparator to use for incoming assertion checks.
Returns:
this assertion object.

usingDefaultComparator

public IntegerAssert usingDefaultComparator()
Description copied from class: AbstractAssert
Revert to standard comparison for incoming assertion checks.
This method should be used to disable a custom comparison strategy set by calling Assert.usingComparator(Comparator).

Specified by:
usingDefaultComparator in interface Assert<IntegerAssert,Integer>
Overrides:
usingDefaultComparator in class AbstractComparableAssert<IntegerAssert,Integer>
Returns:
this assertion object.


Copyright © 2007-2012 FEST (Fixtures for Easy Software Testing). All Rights Reserved.