[JAVA] Verwenden Sie DBUnit für den Spring Boot-Test

Abstrakt

Verwenden Sie dbunit, um Ihr Spring Boot-Projekt zu testen.

Umgebung

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

Annahme

Testziel

• person

Ich habe den folgenden Mapper mit MyBatis für die Tabelle erstellt.

@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);
}

Detaillierte Vorgehensweise

Abhängigkeit hinzufügen

Fügen Sie den Abhängigkeiten spring-test-dbunit und dbunit hinzu.

• Es wird davon ausgegangen, dass der Hauptcode und die Bibliothek für JUnit ebenfalls in der Abhängigkeit enthalten sind.

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>

Voraussetzung Dateneingabe

Schreiben Sie Daten in die Datenbank, bevor Sie den Test ausführen (bevor Sie die Testmethode ausführen).

Grundverhalten

__ * In den folgenden Fällen werden die für den Test verwendeten Daten festgeschrieben. __ (Der Rollback-Fall wird später beschrieben.)

Beschreibung der Eingabedaten

• Erstellen Sie ein Tabellennamen-Tag im Dataset-Tag und beschreiben Sie den Datenwert, um den Spaltennamen in den Attributwert im Attributnamen einzufügen.
• Wenn Sie mehrere Datenzeilen eingeben, erstellen Sie Tags für die Anzahl der Zeilen.
• Beschreiben Sie keine Spalten, die null sind, als Attribute. * Es ist nicht erforderlich, alle Spalten am Anfang zu schreiben.
• __ Leerzeichen können standardmäßig nicht eingegeben werden. __ (Der Fall der Eingabe von Leerzeichen wird später beschrieben.)
• Standardmäßig sind alle Zeilen für die in XML angezeigte Tabelle DELETEd, und dann wird INSERT ausgeführt, um Daten einzugeben.
• __ Für nicht beschriebene Tabellen wird keine Operation ausgeführt. __

Muster 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äfektur Hyogo" />
	<person person_id="3"                      birth_date="1994-02-22" birth_place="Tokio" />
</dataset>

• Erstellen Sie dieses Mal ein Verzeichnis dbunit unter src / test / resources und erstellen Sie es als Muster A.xml darunter.

Testklassenerstellung

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

	@Autowired // (2)
	PersonMapper mapper;

	@Test
	@DatabaseSetup("/dbunit/Muster A..xml") // (3)
	public void test() {
		//Testcode schreiben
	}
}

Ausführungsergebnis

# SELECT * FROM person;
person_id | person_name | birth_date | birth_place
-----------+-------------+------------+-------------
        1 | Suzaki      | 1986-12-25 |
        2 | Nishi       |            |Präfektur Hyogo
        3 |             | 1994-02-22 |Tokio
(3 Zeilen)

Leeres Eingabemuster

Beschreibung der Eingabedaten

Wenn Sie eine Zeile mit Tags ohne Attribute wie unten gezeigt schreiben, wird nur DELETE ausgeführt und die Tabelle ist leer.

Muster B..xml

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

Ausführungsergebnis

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

Leeres Zeicheneingabemuster

Beschreibung der Eingabedaten

• Leeren Sie den Attributwert mit der Spalte zur Eingabe leerer Zeichen als Attributnamen

Muster C..xml

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

Wenn die obige XML-Datei mit dem grundlegenden Mustertestcode schreibgeschützt ist, tritt die folgende Ausnahme auf. 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)

Zusätzlicher Code

Fügen Sie dem gelesenen Pfad die folgende Konfiguration hinzu, wenn der Test ausgeführt wird.

@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;
	}
}

Ausführungsergebnis

# SELECT * FROM person;
person_id | person_name | birth_date | birth_place
-----------+-------------+------------+-------------
        4 |             | 1991-12-25 |Präfektur Hyogo
(1 Zeile)

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

Muster zur Rückgabe von Daten nach dem Testen

Testklassenerstellung

Fügen Sie dem Basismuster Listener und Anmerkungen hinzu.

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

Sie können der Methode auch "@ Transactional" hinzufügen.

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

Vermeiden Sie Warnungstext

Bei Ausführung mit dem obigen Muster wird das folgende Protokoll auf der WARN-Ebene ausgegeben. 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.

Da im Protokoll angegeben ist, dass DataTypeFactory nicht angegeben ist, fügen Sie der Konfigurationsklasse, die im Eingabemuster für leere Zeichen verwendet wird, die folgende Beschreibung hinzu.

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

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

  return bean;
}

Angenommene Datendefinition

Grundverhalten

Angenommene Datenbeschreibung

Beschreiben Sie im gleichen Format wie die erforderlichen Daten. Wenn Null- oder Leerzeichen angenommen werden, entspricht dies der erforderlichen Dateneingabe.

Muster 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äfektur Hyogo" />
	<person person_id="3"                      birth_date="1994-02-22" birth_place="" />
</dataset>

Angenommenes Ergebnis 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äfektur 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äfektur Kanagawa" />
</dataset>

Testmethodenerstellung

@Test
@DatabaseSetup("/dbunit/Muster D..xml")
@ExpectedDatabase(
	value="/dbunit/Angenommenes Ergebnis 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äfektur Kanagawa");

	mapper.insert(param);
}

Referenzseite

SpringBoot 45.Testing Implementierungsmethode für Spring Framework Unit-Tests 1-3. Repository-Test (Junit4, Spring-Test, DBUnit) │ ヰ Schwert-Spielzeugkiste How to set default properties in spring dataset DatabaseConfig - Stack Overflow