如何使用Gson.fromJson处理泛型T构建通用API调用方法

问题背景 #

需要实现一个通用方法，用于调用任意API端点并返回对应类型的对象，此前两种实现均存在问题：

第一种实现（空指针异常）

private <T> T callApi(String endpoint) {
  T responseSuccessObject = null;
  String responseBody = ...
  responseSuccessObject = (T) gson.fromJson(responseBody, responseSuccessObject.getClass());
}

错误原因：responseSuccessObject初始为null，调用getClass()直接触发空指针异常——null没有关联的类信息。

第二种实现（类加载器错误）

private <T> T callApi(String endpoint) {
  T responseSuccessObject = (T) new Object();
  String responseBody = ...
  responseSuccessObject = (T) gson.fromJson(responseBody, responseSuccessObject.getClass());
}

错误原因：强制将Object实例转为T，实际类型仍是Object，Gson会按Object.class解析响应体；后续强转目标类型（如AuthResponseModel）时，因OSGi环境下类加载器不一致（Felix的BundleClassLoader），导致类型转换失败。

正确实现方案 #

使用带Class<T>参数的方法，直接将目标类型传入Gson，避免类型擦除和类加载问题：

// 无需额外创建dummy对象，直接通过Class<T>指定解析类型
private <T> T callApi(Class<T> type, String endpoint) {
    String responseBody = ...; // 此处替换为实际获取API响应体的逻辑（如HTTP请求）
    // Gson会根据传入的Class<T>直接解析为对应类型的对象
    return gson.fromJson(responseBody, type);
}

调用示例 #

// 调用/auth端点，返回AuthResponseModel类型对象
AuthResponseModel authResponse = callApi(AuthResponseModel.class, "/auth");

关键说明 #

1. 避免类型擦除问题：Java泛型在编译时会被擦除，Class<T>参数为Gson提供了运行时的明确类型信息，确保解析出正确的对象类型。
2. 解决类加载器冲突：直接传入目标类的class对象，确保Gson使用与目标类一致的类加载器进行解析，避免OSGi环境下的类加载上下文不一致问题。
3. 泛型嵌套场景扩展：如果需要解析嵌套泛型类型（如List<AuthResponseModel>），可改用TypeToken：

   private <T> T callApi(TypeToken<T> typeToken, String endpoint) {
       String responseBody = ...;
       return gson.fromJson(responseBody, typeToken.getType());
   }
   // 调用示例
   List<AuthResponseModel> list = callApi(new TypeToken<List<AuthResponseModel>>() {}, "/auth/list");
   

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