第 6 章 使用 JUnit 测试 Quarkus 应用程序


编译 Quarkus 入门项目后,请使用 JUnit 5 框架测试您的应用程序,以确保它按预期运行。Quarkus 项目中有两个测试依赖项生成 pom.xml 文件:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-junit5</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.rest-assured</groupId>
    <artifactId>rest-assured</artifactId>
    <scope>test</scope>
</dependency>
Copy to Clipboard Toggle word wrap

测试需要 quarkus-junit5 依赖项,因为它提供了控制 JUnit 5 测试框架的 @QuarkusTest 注解。不需要 其余 依赖项,但它提供了测试 HTTP 端点的便捷方式,它也被集成。它会自动设置正确的 URL,因此不需要配置。

注意

这些测试使用 RESTassured 框架,但如果您喜欢,您可以使用不同的库。

先决条件

  • 您已编译了 Quarkus Getting Started 项目。

流程

  1. 打开生成的 pom.xml 文件并查看内容:

    <plugin>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>${surefire-plugin.version}</version>
        <configuration>
           <systemPropertyVariables>
             <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
             <maven.home>${maven.home}</maven.home>
           </systemPropertyVariable>
        </configuration>
    </plugin>
    Copy to Clipboard Toggle word wrap

    请注意,:

    • 设置了 java.util.logging.manager 系统属性,以确保应用程序使用正确的日志管理器进行测试。
    • maven.home 属性指向 settings.xml 文件的位置,您可以在其中存储您要应用到项目的自定义 Maven 配置。
  2. 编辑 src/test/java/org/acme/quickstart/GreetingResourceTest.java 文件以匹配以下内容:

    package org.acme.quickstart;
    
    import io.quarkus.test.junit.QuarkusTest;
    import org.junit.jupiter.api.Test;
    
    import java.util.UUID;
    
    import static io.restassured.RestAssured.given;
    import static org.hamcrest.CoreMatchers.is;
    
    @QuarkusTest
    public class GreetingResourceTest {
    
        @Test
        public void testHelloEndpoint() {
            given()
              .when().get("/hello")
              .then()
                 .statusCode(200)
                 .body(is("hello"));
        }
    
        @Test
        public void testGreetingEndpoint() {
            String uuid = UUID.randomUUID().toString();
            given()
              .pathParam("name", uuid)
              .when().get("/hello/greeting/{name}")
              .then()
                .statusCode(200)
                .body(is("hello " + uuid));
        }
    
    }
    Copy to Clipboard Toggle word wrap
    注意

    通过使用 QuarkusTest 运行程序,您指示 JUnit 在开始测试前启动应用程序。

  3. 要从 Maven 运行这些测试,请输入以下命令:

    ./mvnw test
    Copy to Clipboard Toggle word wrap
    注意

    您还可以从 IDE 运行测试。如果您这样做,请确保首先停止应用程序。

    默认情况下,测试在端口 8081 上运行,以便它们不会与正在运行的应用程序冲突。在 Quarkus 中,Chtrace Assured 依赖项配置为使用此端口。如果要使用其他客户端,请使用 @TestHTTPResource 注释将经过测试应用的 URL 直接注入到 Test 类的字段中。此字段可以是 字符串URLURI 类型。您还可以在此注解中提供测试路径。例如,要测试映射到 /myservlet 的 servlet,请在测试中添加以下几行:

    @TestHTTPResource("/myservlet")
    URL testUrl;
    Copy to Clipboard Toggle word wrap
  4. 如有必要,在 quarkus.http.test-port 配置属性中指定测试端口。
注意

Quarkus 还创建一个名为 test.url 的系统属性,该属性被设置为基本测试 URL,用于您无法使用注入的情况。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部