如何使用JerseyTest实现真实的集成测试？

你说得太对了——很多JerseyTest教程都走了Mock捷径，本质上还是单元测试，根本没触达真实的服务流程。但JerseyTest完全支持真正的端到端集成测试，也就是你想要的：发送真实JSON请求，触发完整的API逻辑（包括数据库查询），然后验证实际响应。

下面是具体的实现步骤和示例：

1. 配置JerseyTest使用真实嵌入式容器 #

默认情况下有些教程会用Mock容器，但我们要改用Grizzly HTTP容器（Jersey官方推荐的嵌入式容器，能模拟真实的HTTP服务）。只需要继承JerseyTest，并在configure()方法里注册你真实的API资源类、JSON序列化器等组件，而不是Mock类。

2. 配置真实的测试数据库 #

为了不影响生产数据，建议用内存数据库（比如H2）来做测试。你需要在测试环境的配置文件（比如persistence.xml或者Spring配置）中指定测试数据库的连接信息，确保测试时API会连接到这个数据库。

3. 编写真实的集成测试用例 #

用JerseyTest的target()方法构造请求，发送JSON payload，然后获取响应并做断言验证。

完整代码示例 #

import org.glassfish.jersey.server.ResourceConfig;
import org.glassfish.jersey.test.JerseyTest;
import org.junit.Before;
import org.junit.Test;
import javax.ws.rs.client.Entity;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import static org.junit.Assert.*;

public class UserApiIntegrationTest extends JerseyTest {

    // 初始化测试数据（比如在每个测试前插入测试用户）
    @Before
    public void setupTestData() {
        // 这里可以调用你的DAO层方法插入测试数据
        // 比如：userDao.save(new User("testUser", "test@example.com"));
    }

    @Override
    protected ResourceConfig configure() {
        // 注册真实的API资源类和JSON处理组件
        return new ResourceConfig(UserResource.class)
                .register(JacksonFeature.class); // 用Jackson处理JSON序列化/反序列化
    }

    @Test
    public void testCreateUserAndVerifyResponse() {
        // 构造请求JSON
        String createUserJson = "{\"username\": \"newTestUser\", \"email\": \"newtest@example.com\"}";

        // 发送POST请求到API端点
        Response response = target("/api/users")
                .request(MediaType.APPLICATION_JSON)
                .post(Entity.json(createUserJson));

        // 断言响应状态码为201 Created
        assertEquals(Response.Status.CREATED.getStatusCode(), response.getStatus());

        // 读取响应并解析为DTO
        UserResponseDto responseDto = response.readEntity(UserResponseDto.class);

        // 断言响应内容正确
        assertEquals("newTestUser", responseDto.getUsername());
        assertEquals("newtest@example.com", responseDto.getEmail());
        assertNotNull(responseDto.getId()); // 验证生成的用户ID存在
    }

    @Test
    public void testGetUserById() {
        // 假设setupTestData已经插入了ID为1的测试用户
        Response response = target("/api/users/1")
                .request(MediaType.APPLICATION_JSON)
                .get();

        assertEquals(Response.Status.OK.getStatusCode(), response.getStatus());

        UserResponseDto user = response.readEntity(UserResponseDto.class);
        assertEquals("testUser", user.getUsername());
    }
}

4. 必要的依赖配置（Maven为例） #

确保你的pom.xml中包含这些测试依赖：

<dependencies>
    <!-- Jersey Test Framework with Grizzly容器 -->
    <dependency>
        <groupId>org.glassfish.jersey.test-framework.providers</groupId>
        <artifactId>jersey-test-framework-provider-grizzly2</artifactId>
        <version>2.41</version>
        <scope>test</scope>
    </dependency>
    <!-- Jackson JSON处理依赖 -->
    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-json-jackson</artifactId>
        <version>2.41</version>
        <scope>test</scope>
    </dependency>
    <!-- H2内存数据库 -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>2.2.224</version>
        <scope>test</scope>
    </dependency>
    <!-- 你的业务依赖（比如JPA、DAO层等） -->
</dependencies>

关键注意事项 #

• 数据库清理：每个测试结束后记得清理数据，避免测试之间的污染，可以用@After注解或者数据库事务回滚（比如在测试方法上添加@Transactional，如果用Spring的话）。
• Schema初始化：可以用Flyway或Liquibase来自动创建测试数据库的表结构，确保测试环境的Schema和生产一致。
• 避免Mock：不要在测试中Mock你的DAO层或服务层，让请求完整走一遍真实的调用链，这样才是真正的集成测试。

这样实现的测试就是完全符合你需求的集成测试：它启动了真实的嵌入式HTTP服务器，发送真实的JSON请求，你的API会执行完整的业务逻辑（包括数据库读写），最后返回真实的响应，你可以通过断言验证响应的每一部分是否符合预期。

内容的提问来源于stack exchange，提问作者Gangnus