[JAVA] Utiliser DBUnit pour le test Spring Boot

Abstrait

Utilisez dbunit pour tester votre projet Spring Boot.

environnement

• Java SE 8 (jdk-8u181)
• Spring Boot 2.1.1
• Spring-test-batch 1.3.0
• dbunit 2.6.0

supposition

Cible de test

• person

J'ai créé le mappeur suivant avec MyBatis pour la table.

@Mapper
public interface PersonMapper {

	@Select("SELECT * FROM person WHERE person_id = #{personId}")
	public Person selectById(int personId);

	@Insert("INSERT INTO person(person_id, person_name, birth_date, birth_place) VALUES (#{person_id}, #{person_name}, #{birth_date}, #{birth_place})")
	public void insert(Person person);
}

Procédure détaillée

Ajouter une dépendance

Ajoutez spring-test-dbunit et dbunit aux dépendances.

• On suppose que le code principal et la bibliothèque pour que JUnit fonctionne sont également inclus dans la dépendance.

pom.xml

<dependency>
  <groupId>com.github.springtestdbunit</groupId>
  <artifactId>spring-test-dbunit</artifactId>
  <version>1.3.0</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.dbunit</groupId>
  <artifactId>dbunit</artifactId>
  <version>2.6.0</version>
  <scope>test</scope>
</dependency>

Saisie des données préalables

Écrivez les données dans le DB avant d'exécuter le test (avant d'exécuter la méthode de test).

Modèle de base

__ * Dans les cas suivants, les données utilisées pour le test seront validées __ (Le cas de rollback sera décrit plus loin)

Description des données d'entrée

• Créez une balise de nom de table dans la balise dataset et décrivez la valeur de données pour saisir le nom de colonne dans la valeur d'attribut dans le nom d'attribut.
• Lors de la saisie de plusieurs lignes de données, créez des balises pour le nombre de lignes.
• Ne décrivez pas les colonnes nulles comme attributs. * Il n'est pas nécessaire d'écrire toutes les colonnes au début.
• __ Les caractères vides ne peuvent pas être saisis par défaut. __ (Le cas de la saisie de caractères vides sera décrit plus loin)
• Par défaut, toutes les lignes des tables qui apparaissent en xml sont DELETEd et INSERT est ensuite exécuté pour saisir les données.
• __ Aucune opération n'est effectuée sur les tables qui ne sont pas décrites __

Motif A.xml

<?xml version="1.0" encoding="UTF-8"?>
<dataset>
	<person person_id="1" person_name="Suzaki" birth_date="1986-12-25" />
	<person person_id="2" person_name="Nishi"                          birth_place="Préfecture de Hyogo" />
	<person person_id="3"                      birth_date="1994-02-22" birth_place="Tokyo" />
</dataset>

• Cette fois, créez un répertoire dbunit sous src / test / resources et créez-le en tant que pattern A.xml en dessous.

Création de classe de test

// (1)
@RunWith(SpringRunner.class)
@SpringBootTest
@TestExecutionListeners({
	DependencyInjectionTestExecutionListener.class,
	DbUnitTestExecutionListener.class
})
public class PersonMapperTest {

	@Autowired // (2)
	PersonMapper mapper;

	@Test
	@DatabaseSetup("/dbunit/Motif A.xml") // (3)
	public void test() {
		//Écrire le code de test
	}
}

Résultat d'exécution

# SELECT * FROM person;
person_id | person_name | birth_date | birth_place
-----------+-------------+------------+-------------
        1 | Suzaki      | 1986-12-25 |
        2 | Nishi       |            |Préfecture de Hyogo
        3 |             | 1994-02-22 |Tokyo
(3 lignes)

Modèle d'entrée vide

Description des données d'entrée

Si vous écrivez une balise sans attributs comme indiqué ci-dessous, seul DELETE sera exécuté et la table sera vide.

Motif B.xml

<?xml version="1.0" encoding="UTF-8"?>
<dataset>
	<person />
</dataset>

Résultat d'exécution

# SELECT * FROM person;
 person_id | person_name | birth_date | birth_place
-----------+-------------+------------+-------------
(0 ligne)

Modèle d'entrée de caractère vide

Description des données d'entrée

• Vider la valeur d'attribut avec la colonne pour saisir des caractères vides comme nom d'attribut

Modèle C.xml

<?xml version="1.0" encoding="UTF-8"?>
<dataset>
	<person person_id="4" person_name="" birth_date="1991-12-25" birth_place="Préfecture de Hyogo" />
</dataset>

Si le xml ci-dessus est en lecture seule avec le code de test de modèle de base, l'exception suivante se produit. java.lang.IllegalArgumentException: table.column=person.person_name value is empty but must contain a value (to disable this feature check, set DatabaseConfig.FEATURE_ALLOW_EMPTY_FIELDS to true)

Code supplémentaire

Ajoutez la configuration suivante au chemin lu lors de l'exécution du test.

@Configuration
public class DatasourceConfig {

	// (1)
	@Bean
	public DatabaseConfigBean dbUnitDatabaseConfig() {
		DatabaseConfigBean bean = new DatabaseConfigBean();

		bean.setAllowEmptyFields(true); // (2)

		return bean;
	}

	// (3)
	@Bean
	public DatabaseDataSourceConnectionFactoryBean dbUnitDatabaseConnection(
			DatabaseConfigBean dbUnitDatabaseConfig,
			DataSource dataSource
	) {
		DatabaseDataSourceConnectionFactoryBean bean = new DatabaseDataSourceConnectionFactoryBean(dataSource);
		bean.setDatabaseConfig(dbUnitDatabaseConfig);
		return bean;
	}
}

Résultat d'exécution

# SELECT * FROM person;
person_id | person_name | birth_date | birth_place
-----------+-------------+------------+-------------
        4 |             | 1991-12-25 |Préfecture de Hyogo
(1 ligne)

@Test
@DatabaseSetup("/dbunit/Modèle C.xml")
public void test() {
  Person actual = mapper.selectById(4);
  assertThat(actual.getPerson_name()).isEqualTo(""); // ->Succès
}

Modèle pour renvoyer les données après le test

Création de classe de test

Ajoutez des écouteurs et des annotations au modèle de base.

@RunWith(SpringRunner.class)
@SpringBootTest
@TestExecutionListeners({
	DependencyInjectionTestExecutionListener.class,
	TransactionalTestExecutionListener.class, // (1)
	DbUnitTestExecutionListener.class
})
@Transactional //(2)
public class PersonMapperTest3 {
  ...
}

Vous pouvez également ajouter «@ Transactional» à la méthode.

@Test
@Transactional
@DatabaseSetup("/dbunit/Motif A.xml")
public void test() {
  ...
}

Évitez le texte d'avertissement

Lorsqu'il est exécuté avec le modèle ci-dessus, le journal suivant est généré au niveau WARN. Potential problem found: The configured data type factory 'class org.dbunit.dataset.datatype.DefaultDataTypeFactory' might cause problems with the current database 'PostgreSQL' (e.g. some datatypes may not be supported properly). In rare cases you might see this message because the list of supported database products is incomplete (list=[derby]). If so please request a java-class update via the forums.If you are using your own IDataTypeFactory extending DefaultDataTypeFactory, ensure that you override getValidDbProducts() to specify the supported database products.

Étant donné que le journal indique que DataTypeFactory n'est pas spécifié, ajoutez la description suivante à la classe de configuration utilisée dans le modèle d'entrée de caractère vide.

@Bean
public DatabaseConfigBean dbUnitDatabaseConfig() {
  DatabaseConfigBean bean = new DatabaseConfigBean();

  bean.setAllowEmptyFields(true);
  bean.setDatatypeFactory(new PostgresqlDataTypeFactory()); // (1)

  return bean;
}

Définition des données supposées

Modèle de base

Description des données supposées

Décrivez dans le même format que les données préalables. Lorsque des caractères nuls ou vides sont supposés, c'est le même que l'entrée de données prérequises.

Modèle D.xml

<?xml version="1.0" encoding="UTF-8"?>
<dataset>
	<person person_id="1" person_name="Suzaki" birth_date="1986-12-25" />
	<person person_id="2" person_name="Nishi"                          birth_place="Préfecture de Hyogo" />
	<person person_id="3"                      birth_date="1994-02-22" birth_place="" />
</dataset>

Résultat présumé 1.xml

<?xml version="1.0" encoding="UTF-8"?>
<dataset>
	<person person_id="1" person_name="Suzaki" birth_date="1986-12-25" />
	<person person_id="2" person_name="Nishi"                          birth_place="Préfecture de Hyogo" />
	<person person_id="3"                      birth_date="1994-02-22" birth_place="" />
	<person person_id="11" person_name="Uesaka" birth_date="1991-12-19" birth_place="Préfecture de Kanagawa" />
</dataset>

Création de méthode de test

@Test
@DatabaseSetup("/dbunit/Modèle D.xml")
@ExpectedDatabase(
	value="/dbunit/Résultat présumé 1.xml",
	assertionMode=DatabaseAssertionMode.NON_STRICT
) // (1)
public void test() {
	Person param = new Person();
	param.setPerson_id(11);
	param.setPerson_name("Uesaka");
	param.setBirth_date(new Date(91, 11, 19));
	param.setBirth_place("Préfecture de Kanagawa");

	mapper.insert(param);
}

Site de référence

SpringBoot 45.Testing Méthode d'implémentation du test de Spring Framework Unit 1-3. Test du référentiel (Junit4, spring-test, DBUnit) │ ヰ Boîte à jouets Sword How to set default properties in spring dataset DatabaseConfig - Stack Overflow