ijava

Interface Assertions

All Known Implementing Classes:

Program

public interface Assertions

Une assertion est une condition devant être vérifiée. Si elle ne l'est pas une AssertionException est levée et stoppe l'exécution du programme. Lors du premier semestre, les fonctions d'assertions ne doivent être utilisées que dans les méthodes de tests (ie. les méthodes ayant une signature similaire à void testXXX()).

Method Summary

Modifier and Type	Method and Description
void	assertArrayEquals( Object[] expected, Object[] tested) Vérifie que les tableaux passés en paramètre sont égaux, c'est-à-dire qu'ils ont le même contenu (ie. array1[i] == array2[i] pour i compris dans [0..length(array1)]).
void	assertArrayNotEquals( Object[] expected, Object[] tested) Vérifie que les tableaux passés en paramètre ne sont pas égaux, c'est-à-dire qu'ils n'ont le même contenu (ie. il existe au moins un i compris dans [0..length(expected)]) pour lequel expected[i] !
void	assertEquals( Object expected, Object tested) Vérifie que les deux paramètres sont égaux et lève une AssertionException si ce n'est pas le cas.
void	assertFalse( Boolean b) Vérifie que le booléen passé en paramètre est faux (false) et lève une AssertionException si ce n'est pas le cas.
void	assertGreaterThan( Comparable expected, Comparable tested) Vérifie que la valeur testée est strictement supérieure à la valeur attendue.
void	assertGreaterThanOrEqual( Comparable expected, Comparable tested) Vérifie que la valeur testée est strictement supérieure ou égale à la valeur attendue.
void	assertLessThan( Comparable expected, Comparable tested) Vérifie que la valeur testée est strictement inférieure à la valeur attendue.
void	assertLessThanOrEqual( Comparable expected, Comparable tested) Vérifie que la valeur testée est strictement inférieure ou égale à la valeur attendue.
void	assertNotEquals( Object expected, Object tested) Vérifie que les deux paramètres sont différents et lève une AssertionException si ce n'est pas le cas.
void	assertTrue( Boolean b) Vérifie que le booléen passé en paramètre est vrai (true) et lève une AssertionException si ce n'est pas le cas.

Method Detail

assertEquals

void assertEquals( Object expected,
                   Object tested)

Vérifie que les deux paramètres sont égaux et lève une AssertionException si ce n'est pas le cas. Cette fonction un peu 'magique' permet de comparer des informations de même type. Il est ainsi possible d'appeler cette fonction avec les différents types que nous utilisons couramment: int, double, char, boolean, String.

Parameters:

expected - attendu le résultat que l'on souhaiterait avoir.

tested - obtenu la valeur retournée par l'expression testée.

assertNotEquals

void assertNotEquals( Object expected,
                      Object tested)

Vérifie que les deux paramètres sont différents et lève une AssertionException si ce n'est pas le cas. Cette fonction un peu 'magique' permet de comparer des informations de même type. Il est ainsi possible d'appeler cette fonction avec les différents types que nous utilisons couramment: int, double, char, boolean, String.

Parameters:

expected - attendu le résultat que l'on souhaiterait avoir.

tested - obtenu la valeur retournée par l'expression testée.

assertGreaterThan

void assertGreaterThan( Comparable expected,
                        Comparable tested)

Vérifie que la valeur testée est strictement supérieure à la valeur attendue.

Parameters:

expected - la valeur attendue

tested - la valeur testée

assertGreaterThanOrEqual

void assertGreaterThanOrEqual( Comparable expected,
                               Comparable tested)

Vérifie que la valeur testée est strictement supérieure ou égale à la valeur attendue.

Parameters:

expected - la valeur attendue

tested - la valeur testée

assertLessThan

void assertLessThan( Comparable expected,
                     Comparable tested)

Vérifie que la valeur testée est strictement inférieure à la valeur attendue.

Parameters:

expected - la valeur attendue

tested - la valeur testée

assertLessThanOrEqual

void assertLessThanOrEqual( Comparable expected,
                            Comparable tested)

Vérifie que la valeur testée est strictement inférieure ou égale à la valeur attendue.

Parameters:

expected - la valeur attendue

tested - la valeur testée

assertTrue

void assertTrue( Boolean b)

Vérifie que le booléen passé en paramètre est vrai (true) et lève une AssertionException si ce n'est pas le cas.

Parameters:

b - le booléen devant être vrai (true).

assertFalse

void assertFalse( Boolean b)

Vérifie que le booléen passé en paramètre est faux (false) et lève une AssertionException si ce n'est pas le cas.

Parameters:

b - le booléen devant être faux (false).

assertArrayEquals

void assertArrayEquals( Object[] expected,
                        Object[] tested)

Vérifie que les tableaux passés en paramètre sont égaux, c'est-à-dire qu'ils ont le même contenu (ie. array1[i] == array2[i] pour i compris dans [0..length(array1)]).

Parameters:

expected - attendu le résultat que l'on souhaiterait avoir.

tested - obtenu la valeur retournée par l'expression testée.

assertArrayNotEquals

void assertArrayNotEquals( Object[] expected,
                           Object[] tested)

Vérifie que les tableaux passés en paramètre ne sont pas égaux, c'est-à-dire qu'ils n'ont le même contenu (ie. il existe au moins un i compris dans [0..length(expected)]) pour lequel expected[i] != actual[i]).

Parameters:

expected - attendu le résultat que l'on souhaiterait avoir.

actual - obtenu la valeur retournée par l'expression testée.