如何创建可正常获取实体的立即完成JAX-RS客户端Response？

这个问题我之前踩过坑！Response.ok().build()创建的是出站响应（OutboundJaxrsResponse），它是服务端用来返回给客户端的「待发送」响应对象，根本不是客户端侧应该接收的「入站响应」——这就是调用getEntity()会抛出IllegalStateException的核心原因：出站响应只负责设置要发送的实体，完全不支持读取实体的操作。

下面给你几个可行的解决方案：

方案1：用Jersey客户端的ClientResponse创建模拟响应 #

如果你的项目已经依赖Jersey客户端，可以直接用它的ClientResponse类（包路径org.glassfish.jersey.client.ClientResponse），这是专门给客户端侧设计的入站响应实现，天然支持getEntity()方法：

import org.glassfish.jersey.client.ClientResponse;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response.Status;

// 模拟一个带字符串实体的200 OK响应
ClientResponse mockClientResponse = new ClientResponse(Status.OK.getStatusCode(), null);
// 设置实体和对应的媒体类型
mockClientResponse.setEntity("Mocked response content", MediaType.TEXT_PLAIN_TYPE);

// 现在调用getEntity()完全没问题
String content = mockClientResponse.getEntity(String.class);

方案2：用Mockito等Mock框架Stub标准Response接口 #

如果不想绑定到Jersey的具体实现，用Mock框架直接mock标准的javax.ws.rs.core.Response接口是最通用的方式：

import javax.ws.rs.core.Response;
import static org.mockito.Mockito.mock;
import static org.mockito.when;

// 创建mock对象
Response mockResponse = mock(Response.class);

// Stub getEntity()方法，返回你需要的实体
when(mockResponse.getEntity()).thenReturn(new YourEntityClass("field1", "field2"));
// 或者针对特定类型的重载方法Stub
when(mockResponse.getEntity(YourEntityClass.class)).thenReturn(new YourEntityClass("field1", "field2"));

// 还可以按需Stub状态码等其他方法
when(mockResponse.getStatus()).thenReturn(200);

方案3：自定义简单的Response实现（不依赖第三方框架） #

如果连Mock框架都不想用，也可以自己写个极简的Response实现类，只实现你需要用到的方法：

import javax.ws.rs.core.Response;
import javax.ws.rs.core.Response.Status;
import java.util.Map;

public class MockClientResponse extends Response {
    private final int status;
    private final Object entity;

    public MockClientResponse(Status status, Object entity) {
        this.status = status.getStatusCode();
        this.entity = entity;
    }

    @Override
    public int getStatus() {
        return status;
    }

    @Override
    public <T> T getEntity(Class<T> type) {
        return type.cast(entity);
    }

    @Override
    public Object getEntity() {
        return entity;
    }

    @Override
    public StatusType getStatusInfo() {
        return Status.fromStatusCode(status);
    }

    @Override
    public MultivaluedMap<String, String> getMetadata() {
        return Map.of();
    }

    // 其他不需要的方法可以直接抛出UnsupportedOperationException或者空实现
}

// 使用示例
Response mockResponse = new MockClientResponse(Status.OK, "Mocked content");
String content = mockResponse.getEntity(String.class);

总结一下核心要点：别混淆服务端的出站响应和客户端的入站响应类型，Stub客户端响应时一定要用客户端侧的响应实现，或者Mock标准的Response接口。

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