Go泛型出现前，如何定义通用HTTP响应JSON类型避免字段重复？

在Go泛型出现之前，要避免重复定义公共字段（如Size及其他更多公共字段），同时支持不同类型的Values数组，主要有以下几种实用方案：

1. 结构体嵌入（推荐，类型安全） #

定义一个包含所有公共字段的基础结构体，然后让每个具体的响应结构体嵌入这个基础结构体，仅需新增对应类型的Values字段即可。这种方式完全保留类型安全，且JSON序列化/反序列化能正常工作。

示例代码：

// 定义公共基础响应结构体，包含所有重复字段
type BaseResponse struct {
    Size   int `json:"size"`
    Total  int `json:"total"` // 示例其他公共字段
    Page   int `json:"page"`  // 示例其他公共字段
}

// 具体数据类型定义
type Car struct {
    Make string `json:"make"`
    Year int    `json:"year"`
}

type Course struct {
    Name      string `json:"name"`
    StartDate string `json:"startDate"`
}

// 嵌入BaseResponse实现具体响应类型
type CarResponse struct {
    BaseResponse
    Values []Car `json:"values"`
}

type CourseResponse struct {
    BaseResponse
    Values []Course `json:"values"`
}

使用时直接反序列化到对应响应结构体即可：

// 处理/api/v1/cars响应
var carResp CarResponse
err := json.Unmarshal(carData, &carResp)
// 处理/api/v1/courses响应
var courseResp CourseResponse
err := json.Unmarshal(courseData, &courseResp)

2. 自定义UnmarshalJSON（灵活但类型不安全） #

如果不想为每个响应单独定义结构体，可以使用包含[]interface{}的通用结构体，然后在反序列化后手动将Values转换为目标类型。这种方式灵活性高，但类型不安全，需要手动处理类型断言和转换，适合简单场景。

示例代码：

type GenericResponse struct {
    Size   int           `json:"size"`
    Values []interface{} `json:"values"`
}

// 反序列化后转换为Car类型
var resp GenericResponse
err := json.Unmarshal(carData, &resp)
if err != nil {
    // 错误处理
}

var cars []Car
for _, item := range resp.Values {
    itemMap, ok := item.(map[string]interface{})
    if !ok {
        // 类型错误处理
        continue
    }
    car := Car{
        Make: itemMap["make"].(string),
        Year: int(itemMap["year"].(float64)), // JSON数字默认解析为float64
    }
    cars = append(cars, car)
}

3. 代码生成（适合大量响应类型场景） #

如果需要定义的响应类型非常多，可以通过go generate结合模板自动生成代码，避免手动重复编写嵌入结构体的代码。

示例步骤：

1. 编写代码生成工具（如gen_response.go），读取目标实体类型名，生成对应的响应结构体代码。
2. 在项目中添加//go:generate指令触发代码生成。

示例generate.go：

//go:generate go run gen_response.go Car
//go:generate go run gen_response.go Course

生成工具会自动生成类似CarResponse、CourseResponse这样的结构体，自动嵌入BaseResponse并添加对应类型的Values字段。

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