DbUnitTest

Par Primaël BRUANT.

Version au 07/09/2014.

Ce document présente la façon d'utiliser DbUnitTest pour gérer et créer des tests.

Installation avec maven

###Pré-requis### Avoir installer DbUnitTest dans son répository local. ###Installation dans un projet###

<dependency>
	<groupId>fr.nimrod.info</groupId>
   <artifactId>dbUnitTest</artifactId>
   <version>1.0</version>
   <scope>test</scope>
</dependency>

###Utilisation dans un test### Vous devez dans un premier temps déclarer dans votre test le @Rule Junit4:

	@Rule
	public NimrodDbRule dbUnitRule = new NimrodDbRule(__Class d'appel__, __Driver de la bdd___,
			__URL de connexion__, __utilisateur__, __password__);

Ensuite sur vos méthode de test, ajouter les annotations :

• @Schema => Pour l'éxecution d'un script
• @Data => Pour l'insertion d'un jeu de données (supporte actuellement le format JSON et XML)
• @DataExpected => Pour la vérification entre les données obtenues et les données attendues.

@Schema

Annotation permettant l'import d'un script sql (ie. la création d'une table)

 	@Schema({"utilisateur.sql", "role.sql"})

@Schema prend pour valeur le ou les fichiers sql a chargés.

@Data

Annotation permettant l'ajout de données.

 	@Data(value={"utilisateur.xml", "role.json"}, phase=Phase.BEFORE)

@Data prend pour valeur le ou les fichiers de données a chargés. Actuellement seul les formats json et xml sont supportés.

@DataExpected

Annotation permettant de valider la bonne modification des données.

	@DataExpected(file="/user-expected.json", tableName="utilisateur", ignoredColumn={"hash","salt"} )

@DataExpected:

attributs obligatoires:

• file : prend pour valeur le de données a validés (données attendues).
• tableName : la table concernées par le test.

attribut optionnel:

• ignoredColumn : les colonnes ignorés lors de la comparaison.

Lancer votre test, that's it!