Go语言Web API响应结构体设计：巧用嵌套结构体
构建Web API时，统一的响应结构体至关重要。然而，不同API的返回数据结构往往差异巨大。如何设计一个灵活的结构体来适应各种数据类型呢？本文将介绍一种优雅的方案：嵌套结构体结合interface{}。
我们先定义一个基础结构体Base：
<code class="go">type Base struct {
Status int64 `json:"status"`
Data interface{} `json:"data"`
Message string `json:"message"`
}</code>
Data字段声明为interface{}类型，使其能够容纳任何类型的数据，例如struct、map、slice等。
立即学习“go语言免费学习笔记（深入）”；
接下来，针对不同的API，定义相应的子结构体。例如，一个返回用户信息的API：
<code class="go">type UserDetails struct {
ID int64 `json:"id"`
Name string `json:"name"`
Age int `json:"age"`
IsDeleted bool `json:"is_deleted"`
}
func GetUserDetailHandler() (*Base, error) {
// ... 获取用户信息 ...
data := UserDetails{
ID: 100,
Name: "John Doe",
Age: 32,
IsDeleted: true,
}
return &Base{
Status: 200,
Data: data,
Message: "OK",
}, nil
}</code>
另一个返回班级信息的API：
<code class="go">type ClassInfo struct {
ClassName string `json:"class_name"`
TeacherName string `json:"teacher_name"`
}
func GetClassInfoHandler() (*Base, error) {
// ... 获取班级信息 ...
data := ClassInfo{
ClassName: "1班",
TeacherName: "李明",
}
return &Base{
Status: 200,
Data: data,
Message: "OK",
}, nil
}</code>
通过这种嵌套结构体的方式，我们可以轻松地处理各种API响应数据，而interface{}保证了类型的灵活性。 这种方法简洁高效，避免了冗余代码，提高了代码的可维护性。
