Retrofit2中优化POST/PUT请求：避免双类封装的更佳方案

嘿，作为Retrofit新手碰到这种为单个请求写两个模型类的麻烦太正常了！我刚上手的时候也觉得这事儿特别冗余，其实有几个更优雅的方案能解决这个问题，咱们挨个捋：

1. 直接用Map作为请求体 #

如果你的请求只是把单个对象包裹在一个外层键里（比如{"user": {...}}这种结构），完全可以用Map来替代封装类。Retrofit会自动把Map序列化成符合要求的JSON，效果和自定义封装类一模一样：

// Retrofit接口定义
@PUT("/api/users/{id}")
Call<ApiResponse> updateUser(@Path("id") int userId, @Body Map<String, User> requestBody);

// 使用示例
User updatedUser = new User("Alice", "alice@example.com");
Map<String, User> requestMap = new HashMap<>();
requestMap.put("user", updatedUser); // 这里的键名对应后端要求的外层字段

Call<ApiResponse> call = apiService.updateUser(123, requestMap);

这种方式不用额外创建任何类，临时构建Map就能满足需求，适合偶尔出现的这类请求。

2. 写一个通用泛型封装类（复用所有场景） #

如果你的项目里很多接口都需要这种“单个对象+外层包装”的结构，那写一个泛型封装类就一劳永逸了，不用每个接口都单独写一个封装模型：

// 通用泛型封装类（可以用Lombok的@Data简化getter/setter）
public class RequestWrapper<T> {
    private T data; // 字段名根据后端要求调整，比如"user"、"item"

    public RequestWrapper(T data) {
        this.data = data;
    }

    // 手动写getter和setter，或者用Lombok注解省略
    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

之后不管是User、Product还是其他模型，都可以用这个泛型类包装：

// 接口定义
@POST("/api/products")
Call<ApiResponse> createProduct(@Body RequestWrapper<Product> requestBody);

// 使用示例
Product newProduct = new Product("Laptop", 999.99);
RequestWrapper<Product> wrapper = new RequestWrapper<>(newProduct);
Call<ApiResponse> call = apiService.createProduct(wrapper);

这个方案只需要写一次封装类，所有单个对象的请求都能复用，非常适合有统一接口格式的项目。

3. 直接传递单个对象（如果后端允许） #

如果你的后端接口设计允许直接接收单个对象的JSON（不需要外层包装），那这就是最简洁的方案——直接把单个模型类作为@Body参数：

// 接口定义
@PUT("/api/users/{id}")
Call<ApiResponse> updateUser(@Path("id") int userId, @Body User updatedUser);

// 使用示例
User updatedUser = new User("Bob", "bob@example.com");
Call<ApiResponse> call = apiService.updateUser(456, updatedUser);

不过这个方案得先和后端开发确认接口是否支持这种请求格式，要是后端必须要外层包装，那这个方法就用不了啦。

额外：Kotlin用户的小福利 #

如果用Kotlin开发，data class写起来更简洁，泛型封装类一行就能搞定：

data class RequestWrapper<T>(val data: T) // 字段名按需修改

使用的时候直接RequestWrapper(updatedUser)就行，连构造器都不用手动写，非常省心。

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