3x-ui-agent/internal/web/middleware/validate.go

package middleware

import (
	"errors"
	"net/http"
	"reflect"
	"strings"

	"github.com/gin-gonic/gin"
	"github.com/gin-gonic/gin/binding"
	"github.com/go-playground/validator/v10"

	"github.com/mhsanaei/3x-ui/v3/internal/web/entity"
)

var validate = validator.New(validator.WithRequiredStructEnabled())

func BindAndValidate[T any](c *gin.Context) (*T, bool) {
	var dst T
	if err := c.ShouldBind(&dst); err != nil {
		writeBindFailure(c, err)
		return nil, false
	}
	if err := validate.Struct(&dst); err != nil {
		writeBindFailure(c, err)
		return nil, false
	}
	return &dst, true
}

func BindAndValidateInto(c *gin.Context, dst any) bool {
	if err := c.ShouldBind(dst); err != nil {
		writeBindFailure(c, err)
		return false
	}
	if err := validate.Struct(dst); err != nil {
		writeBindFailure(c, err)
		return false
	}
	return true
}

func BindJSONAndValidate[T any](c *gin.Context) (*T, bool) {
	var dst T
	if err := c.ShouldBindWith(&dst, binding.JSON); err != nil {
		writeBindFailure(c, err)
		return nil, false
	}
	if err := validate.Struct(&dst); err != nil {
		writeBindFailure(c, err)
		return nil, false
	}
	return &dst, true
}

func BindJSONAndValidateInto(c *gin.Context, dst any) bool {
	if err := c.ShouldBindWith(dst, binding.JSON); err != nil {
		writeBindFailure(c, err)
		return false
	}
	if err := validate.Struct(dst); err != nil {
		writeBindFailure(c, err)
		return false
	}
	return true
}

type FieldIssue struct {
	Field   string `json:"field"`
	Rule    string `json:"rule"`
	Param   string `json:"param,omitempty"`
	Message string `json:"message"`
}

type ValidationPayload struct {
	Issues  []FieldIssue `json:"issues"`
	Message string       `json:"message"`
}

func writeBindFailure(c *gin.Context, err error) {
	payload := ValidationPayload{Issues: []FieldIssue{}, Message: err.Error()}

	if ve, ok := errors.AsType[validator.ValidationErrors](err); ok {
		payload.Issues = make([]FieldIssue, 0, len(ve))
		for _, fe := range ve {
			payload.Issues = append(payload.Issues, FieldIssue{
				Field:   fe.Field(),
				Rule:    fe.Tag(),
				Param:   fe.Param(),
				Message: fe.Error(),
			})
		}
	}

	c.AbortWithStatusJSON(http.StatusOK, entity.Msg{
		Success: false,
		Msg:     "request body failed validation",
		Obj:     payload,
	})
}

func init() {
	validate.RegisterTagNameFunc(func(fld reflect.StructField) string {
		name, _, _ := strings.Cut(fld.Tag.Get("json"), ",")
		if name == "-" || name == "" {
			return fld.Name
		}
		return name
	})
}