改善此页面

运行测试

介绍

JHipster附带了一组全面的测试，并且每个生成的应用程序都具有：

  • 使用JUnit 5进行单元测试。
  • 使用Spring Test Context框架进行集成测试。
  • 用Jest进行UI测试。
  • 使用ArchUnit进行架构测试。

可选地，JHipster还可以生成：

生成这些测试有两个目标：

  • 帮助每个JHipster用户遵循最佳实践，因为我们认为测试是每个应用程序中非常有用的一部分
  • 验证所生成的内容正确无误。因此，即使您根本不打算使用这些测试，在生成应用程序后进行./mvnw clean verify和npm test也是了解一切正常的一种好方法。如果您认为测试浪费时间，那么您可以自由地忽略那些测试！

所有这些测试都将在标准src/test文件夹中生成。

集成测试

集成测试是通过Spring Test Context框架完成的，位于src/test/java文件夹中。JHipster将启动特定的Spring测试上下文，该上下文将在所有测试中重复使用，如下所示：

  • 您的Spring bean应该是无状态的并且是线程安全的，因此可以在不同的测试套件中重复使用。
  • 与为每个测试启动一个新的Spring上下文相比，为所有测试仅启动一个Spring上下文快得多。

这个Spring测试上下文将使用特定的测试数据库来运行其测试：

  • 如果使用SQL数据库，则JHipster将启动内存中的H2实例，以便将临时数据库用于其集成测试。另外，通过使用testcontainers配置文件，JHipster将使用Testcontainers，无论哪种方式，Liquibase将自动运行，并将生成数据库模式。
  • 如果使用Cassandra，JHipster将使用 Testcontainers与Docker一起启动Cassandra的容器化版本。
  • 如果使用MongoDB，JHipster将使用 de.flapdoodle.embed.mongo启动内存中的MongoDB实例。
  • 如果使用Elasticsearch，则JHipster将使用Spring Data Elasticsearch启动内存中的Elasticsearch实例。
  • 如果您使用Couchbase，则JHipster将使用 Couchbase TestContainers与Docker启动Couchbase的容器化版本。
  • 如果您使用Neo4j，JHipster将使用Neo4j Testcontainers。

这些测试可以直接在您的IDE中运行，方法是右键单击每个测试类，或者通过运行./mvnw clean verify（如果使用Gradle，则可以运行./gradlew test integrationTest）。

限制: 如果生成的实体启用了校验，则JHipster可能不能根据校验规则生成正确的值。这些规则可能非常复杂，例如，如果使用了Regex模式，就不可能实现。在这种情况下，测试将无法通过校验，并且测试中使用的默认值将需要手动更改，以便它们可以通过校验规则。

UI测试

JHipster的UI测试有两种形式：Jest的单元测试和Protractor的集成测试。默认情况下仅提供Jest，但是如果您希望对应用程序进行良好的测试，我们建议您同时使用这两种工具。

Jest

UI单元测试位于src/test/javascript/spec文件夹中。他们使用Jest。

这些测试将模拟对应用程序REST端点的访问，因此您可以测试UI层而不必启动Java后端。

  • 可以使用npm test运行这些测试。
  • 提示: 如果您只关注单个测试，请将模块描述从describe('...', function() {更改为fdescribe('...', function() {，Jest将仅运行此测试。

Cypress/Protractor

UI集成测试是使用Cypress或Protractor完成的，位于src/test/javascript/e2e文件夹中。

这些测试将启动Web浏览器并像真实用户一样使用该应用程序，因此您需要运行一个具有数据库设置的真实应用程序。

可以使用npm run e2e运行这些测试。

Architecture tests

使用ArchUnit可以进行强制某些约束和最佳实践的架构测试。 您可以按照官方文档在构建时轻松编写自己的规则来检查架构的自定义约束。

性能测试

性能测试是使用Gatling完成的，位于src/test/gatling文件夹中。它们是为每个实体生成的，并允许使用大量并发的用户请求对其进行测试。

要运行Gatling测试，您必须

  1. 请转到Gatling下载页面
  2. 解压缩并将该位置添加到您的PATH中
  3. cd进入src/test/gatling并根据您的操作系统运行gatling.sh或gatling.bat

警告! 目前，这些测试未考虑您可能对实体执行的校验规则。同样，创建与其他实体具有必需关系的实体的测试开箱即用也会失败。无论如何，您都需要根据您的业务规则更改那些测试，因此这里有一些改善测试的技巧：

  • 在正在运行的应用程序上，转到Administration > Logs屏幕，然后将org.springframework置于debug模式。例如，您将看到验证错误。
  • 正常使用该应用程序，然后打开Chrome console log：您将能够看到REST请求及其所有参数，包括HTTP标头。

为了在微服务应用程序上运行Gatling测试，您必须：

  • 运行registry
  • 运行网关
  • 运行微服务应用
  • 然后，您可以运行Gatling测试

使用Maven / Gradle运行Gatling

我们不会生成Maven或Gradle配置来运行Gatling测试，因为这可能会导致其他插件出现类路径问题（主要是由于使用Scala）。 不过，您可以使用正式的Maven插件或Gradle插件执行Gatling测试。

使用 Maven

您需要更改pom.xml：

1.添加带有test作用域的Gatling依赖项 2.添加Gatling插件 3.使插件配置适应JHipster布局和命名约定

...
<dependency>
  <groupId>io.gatling.highcharts</groupId>
  <artifactId>gatling-charts-highcharts</artifactId>
  <version>3.5.0</version>
  <scope>test</scope>
</dependency>
<!-- jhipster-needle-maven-add-dependency -->
...
<plugin>
  <groupId>io.gatling</groupId>
  <artifactId>gatling-maven-plugin</artifactId>
  <version>3.1.1</version>
  <configuration>
    <runMultipleSimulations>true</runMultipleSimulations>
    <resourcesFolder>${project.basedir}/src/test/gatling/conf</resourcesFolder>
    <simulationsFolder>${project.basedir}/src/test/gatling/user-files/simulations</simulationsFolder>
  </configuration>
</plugin>
<!-- jhipster-needle-maven-add-plugin -->
...

您可以使用./mvnw gatling:test执行所有的gatling测试。

使用Gradle

您需要更改build.gradle：

1.将Gatling插件添加到插件部分 2.使源集适应JHipster布局 3.使包含的模拟适应JHipster命名约定

如果使用的是反应式选项，则可能需要确保Spring Boot管理的Netty版本不会干扰Gatling所需的版本 。

plugins {
    ...
    id "io.spring.nohttp"
    // Add the Gatling plugin, please check for the latest version here https://plugins.gradle.org/plugin/io.gatling.gradle 
    id 'io.gatling.gradle' version "3.5.0" 
    //jhipster-needle-gradle-plugins - JHipster will add additional gradle plugins here
}

...
// adapt the source sets to the JHipster specific layout
sourceSets {
   gatling {
    scala.srcDirs = ["src/test/gatling/user-files/simulations"]
    resources.srcDirs = ["src/test/gatling/conf"]
  }
} 

gatling {
    simulations = { include "**/*Test*.scala" }
}
...

行为驱动开发（BDD）

使用Cucumber及其JVM实现，可以进行行为驱动开发（BDD）。

Gherkin功能必须写在src/test/features目录中。