GolangAPI分页与筛选实战教程

func main() {
    r := mux.NewRouter()
    r.HandleFunc("/api/users", getUsers).Methods("GET")
    log.Fatal(http.ListenAndServe(":8080", r))
}

type UserFilter struct {
    Page     int
    PageSize int
    Name     string
    Age      int
    City     string
}

func parseUserFilter(r *http.Request) UserFilter {
    page := getIntQuery(r, "page", 1)
    pageSize := getIntQuery(r, "pageSize", 10)
    if pageSize > 100 {
        pageSize = 100 // 限制最大每页数量
    }
    return UserFilter{
        Page:     page,
        PageSize: pageSize,
        Name:     r.URL.Query().Get("name"),
        City:     r.URL.Query().Get("city"),
        Age:      getIntQuery(r, "age", 0),
    }
}
func getIntQuery(r *http.Request, key string, defaultValue int) int {
if val := r.URL.Query().Get(key); val != "" {
if i, err := strconv.Atoi(val); err == nil && i > 0 {
return i
}
}
return defaultValue
}

var users = []map[string]interface{}{
    {"id": 1, "name": "Alice", "age": 25, "city": "Beijing"},
    {"id": 2, "name": "Bob", "age": 30, "city": "Shanghai"},
    {"id": 3, "name": "Charlie", "age": 25, "city": "Beijing"},
    {"id": 4, "name": "David", "age": 35, "city": "Guangzhou"},
}
func getUsers(w http.ResponseWriter, r *http.Request) {
filter := parseUserFilter(r)
var filtered []map[string]interface{}
for _, u := range users {
    match := true
    if filter.Name != "" && !strings.Contains(u["name"].(string), filter.Name) {
        match = false
    }
    if filter.City != "" && u["city"] != filter.City {
        match = false
    }
    if filter.Age > 0 && u["age"] != filter.Age {
        match = false
    }
    if match {
        filtered = append(filtered, u)
    }
}

// 分页计算
start := (filter.Page - 1) * filter.PageSize
end := start + filter.PageSize
if start > len(filtered) {
    start = len(filtered)
}
if end > len(filtered) {
    end = len(filtered)
}

paginated := filtered[start:end]

response := map[string]interface{}{
    "data": filtered[start:end],
    "pagination": map[string]int{
        "page":       filter.Page,
        "page_size":  filter.PageSize,
        "total":      len(filtered),
        "total_page": (len(filtered) + filter.PageSize - 1) / filter.PageSize,
    },
}

w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(response)
}

{
  "data": [
    {"id": 1, "name": "Alice", "age": 25, "city": "Beijing"},
    {"id": 3, "name": "Charlie", "age": 25, "city": "Beijing"}
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total": 2,
    "total_page": 1
  }
}