调整项目结构,factory只负责暴露方法，不实现业务细节

http/request.go

@@ -1,8 +1,12 @@
 package http
 
 import (
+	"encoding/json"
+	"io"
 	"net/http"
 	"strconv"
+
+	"git.toowon.com/jimmy/go-common/middleware"
 )
 
 // getQueryInt 获取整数查询参数（内部方法，供ParsePaginationRequest使用）
@@ -114,3 +118,192 @@ func ParsePaginationRequest(r *http.Request) *PaginationRequest {
 
 	return req
 }
+
+// ========== 请求解析公共方法 ==========
+
+// ParseJSON 解析JSON请求体（公共方法）
+// r: HTTP请求
+// v: 目标结构体指针
+func ParseJSON(r *http.Request, v interface{}) error {
+	body, err := io.ReadAll(r.Body)
+	if err != nil {
+		return err
+	}
+	defer r.Body.Close()
+
+	if len(body) == 0 {
+		return nil
+	}
+
+	return json.Unmarshal(body, v)
+}
+
+// GetQuery 获取查询参数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetQuery(r *http.Request, key, defaultValue string) string {
+	value := r.URL.Query().Get(key)
+	if value == "" {
+		return defaultValue
+	}
+	return value
+}
+
+// GetQueryInt 获取整数查询参数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetQueryInt(r *http.Request, key string, defaultValue int) int {
+	value := r.URL.Query().Get(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	intValue, err := strconv.Atoi(value)
+	if err != nil {
+		return defaultValue
+	}
+
+	return intValue
+}
+
+// GetQueryInt64 获取int64查询参数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetQueryInt64(r *http.Request, key string, defaultValue int64) int64 {
+	value := r.URL.Query().Get(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	intValue, err := strconv.ParseInt(value, 10, 64)
+	if err != nil {
+		return defaultValue
+	}
+
+	return intValue
+}
+
+// GetQueryBool 获取布尔查询参数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetQueryBool(r *http.Request, key string, defaultValue bool) bool {
+	value := r.URL.Query().Get(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	boolValue, err := strconv.ParseBool(value)
+	if err != nil {
+		return defaultValue
+	}
+
+	return boolValue
+}
+
+// GetQueryFloat64 获取float64查询参数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetQueryFloat64(r *http.Request, key string, defaultValue float64) float64 {
+	value := r.URL.Query().Get(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	floatValue, err := strconv.ParseFloat(value, 64)
+	if err != nil {
+		return defaultValue
+	}
+
+	return floatValue
+}
+
+// GetFormValue 获取表单值（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetFormValue(r *http.Request, key, defaultValue string) string {
+	value := r.FormValue(key)
+	if value == "" {
+		return defaultValue
+	}
+	return value
+}
+
+// GetFormInt 获取表单整数（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetFormInt(r *http.Request, key string, defaultValue int) int {
+	value := r.FormValue(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	intValue, err := strconv.Atoi(value)
+	if err != nil {
+		return defaultValue
+	}
+
+	return intValue
+}
+
+// GetFormInt64 获取表单int64（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetFormInt64(r *http.Request, key string, defaultValue int64) int64 {
+	value := r.FormValue(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	intValue, err := strconv.ParseInt(value, 10, 64)
+	if err != nil {
+		return defaultValue
+	}
+
+	return intValue
+}
+
+// GetFormBool 获取表单布尔值（公共方法）
+// r: HTTP请求
+// key: 参数名
+// defaultValue: 默认值
+func GetFormBool(r *http.Request, key string, defaultValue bool) bool {
+	value := r.FormValue(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	boolValue, err := strconv.ParseBool(value)
+	if err != nil {
+		return defaultValue
+	}
+
+	return boolValue
+}
+
+// GetHeader 获取请求头（公共方法）
+// r: HTTP请求
+// key: 请求头名称
+// defaultValue: 默认值
+func GetHeader(r *http.Request, key, defaultValue string) string {
+	value := r.Header.Get(key)
+	if value == "" {
+		return defaultValue
+	}
+	return value
+}
+
+// GetTimezone 从请求的context中获取时区（公共方法）
+// r: HTTP请求
+// 如果使用了middleware.Timezone中间件，可以从context中获取时区信息
+// 如果未设置，返回默认时区 AsiaShanghai
+func GetTimezone(r *http.Request) string {
+	return middleware.GetTimezoneFromContext(r.Context())
+}