org.fest.assertions.internal
Class Comparables

java.lang.Object
  extended by org.fest.assertions.internal.Comparables
Direct Known Subclasses:
Characters, Numbers

public class Comparables
extends Object

Reusable assertions for Comparables.

Author:
Alex Ruiz, Joel Costigliola

Constructor Summary
Comparables(org.fest.util.ComparisonStrategy comparisonStrategy)
           
 
Method Summary
protected
<T> boolean
areEqual(T actual, T expected)
           
<T> void
assertEqual(AssertionInfo info, T actual, T expected)
          Asserts that two T instances are equal.
<T extends Comparable<T>>
void
assertEqualByComparison(AssertionInfo info, T actual, T expected)
          Asserts that two Comparables are equal by invoking Comparable.compareTo(Object).
<T extends Comparable<T>>
void
assertGreaterThan(AssertionInfo info, T actual, T other)
          Asserts that the actual value is greater than the other one.
<T extends Comparable<T>>
void
assertGreaterThanOrEqualTo(AssertionInfo info, T actual, T other)
          Asserts that the actual value is greater than or equal to the other one.
<T extends Comparable<T>>
void
assertLessThan(AssertionInfo info, T actual, T other)
          Asserts that the actual value is less than the other one.
<T extends Comparable<T>>
void
assertLessThanOrEqualTo(AssertionInfo info, T actual, T other)
          Asserts that the actual value is less than or equal to the other one.
<T> void
assertNotEqual(AssertionInfo info, T actual, T other)
          Asserts that two T instances are not equal.
<T extends Comparable<T>>
void
assertNotEqualByComparison(AssertionInfo info, T actual, T other)
          Asserts that two Comparables are not equal by invoking Comparable.compareTo(Object).
protected static
<T> void
assertNotNull(AssertionInfo info, T actual)
           
 Comparator<?> getComparator()
           
static Comparables instance()
          Returns the singleton instance of this class based on StandardComparisonStrategy.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Comparables

public Comparables(org.fest.util.ComparisonStrategy comparisonStrategy)
Method Detail

instance

public static Comparables instance()
Returns the singleton instance of this class based on StandardComparisonStrategy.

Returns:
the singleton instance of this class based on StandardComparisonStrategy.

getComparator

public Comparator<?> getComparator()

assertEqual

public <T> void assertEqual(AssertionInfo info,
                            T actual,
                            T expected)
Asserts that two T instances are equal.

Parameters:
info - contains information about the assertion.
actual - the actual value.
expected - the expected value.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is not equal to the expected one. This method will throw a org.junit.ComparisonFailure instead if JUnit is in the classpath and the expected and actual values are not equal.

areEqual

protected <T> boolean areEqual(T actual,
                               T expected)

assertNotEqual

public <T> void assertNotEqual(AssertionInfo info,
                               T actual,
                               T other)
Asserts that two T instances are not equal.

Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is equal to the other one.

assertEqualByComparison

public <T extends Comparable<T>> void assertEqualByComparison(AssertionInfo info,
                                                              T actual,
                                                              T expected)
Asserts that two Comparables are equal by invoking Comparable.compareTo(Object).
Note that it does not rely on the custom comparisonStrategy if one has been set.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
expected - the expected value.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is not equal to the expected one. This method will throw a org.junit.ComparisonFailure instead if JUnit is in the classpath and the expected and actual values are not equal.

assertNotEqualByComparison

public <T extends Comparable<T>> void assertNotEqualByComparison(AssertionInfo info,
                                                                 T actual,
                                                                 T other)
Asserts that two Comparables are not equal by invoking Comparable.compareTo(Object).
Note that it does not rely on the custom comparisonStrategy if one has been set.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is equal to the other one.

assertLessThan

public <T extends Comparable<T>> void assertLessThan(AssertionInfo info,
                                                     T actual,
                                                     T other)
Asserts that the actual value is less than the other one.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is not less than the other one: this assertion will fail if the actual value is equal to or greater than the other value.

assertLessThanOrEqualTo

public <T extends Comparable<T>> void assertLessThanOrEqualTo(AssertionInfo info,
                                                              T actual,
                                                              T other)
Asserts that the actual value is less than or equal to the other one.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is greater than the other one.

assertGreaterThan

public <T extends Comparable<T>> void assertGreaterThan(AssertionInfo info,
                                                        T actual,
                                                        T other)
Asserts that the actual value is greater than the other one.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is not greater than the other one: this assertion will fail if the actual value is equal to or less than the other value.

assertGreaterThanOrEqualTo

public <T extends Comparable<T>> void assertGreaterThanOrEqualTo(AssertionInfo info,
                                                                 T actual,
                                                                 T other)
Asserts that the actual value is greater than or equal to the other one.

Type Parameters:
T - used to guarantee that two objects of the same type are being compared against each other.
Parameters:
info - contains information about the assertion.
actual - the actual value.
other - the value to compare the actual value to.
Throws:
AssertionError - if the actual value is null.
AssertionError - if the actual value is less than the other one.

assertNotNull

protected static <T> void assertNotNull(AssertionInfo info,
                                        T actual)


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