validator

type ArrayConstraint ¶

type ArrayConstraint struct {
	Item Validator // 每个元素的验证器
}

ArrayConstraint 数组/切片约束，用于验证集合中每个元素的有效性。

func (v *ArrayConstraint) Validate(value interface{}) error

type CompositeValidator ¶

type CompositeValidator struct {
	// contains filtered or unexported fields
}

CompositeValidator 组合验证器，允许将多个验证器链式应用于同一个值。 如果一个值需要满足多个不同的验证规则（例如，既要满足长度约束，又要满足正则约束）， 可以使用 CompositeValidator 将这些规则组合起来。

func NewCompositeValidator(validators ...Validator) *CompositeValidator

func (cv *CompositeValidator) Add(validators ...Validator)

func (cv *CompositeValidator) Validate(value interface{}) error

type ConditionalValidator ¶

type ConditionalValidator struct {
	// contains filtered or unexported fields
}

ConditionalValidator 根据条件决定是否应用验证。 它允许您定义一个在执行实际验证器之前检查的条件函数。 如果条件为真，则应用内部的 validator；否则，跳过验证。

func NewConditionalValidator(
	condition func(interface{}) bool,
	validator Validator,
	desc string,
) *ConditionalValidator

func (v *ConditionalValidator) Validate(value interface{}) error

type EnumConstraint ¶

type EnumConstraint[T comparable] struct {
	Allowed map[T]struct{} // 允许的值集合，使用 map 实现高效查找
}

EnumConstraint 枚举约束，用于检查值是否在预定义的允许值集合中。

func NewEnumConstraint[T comparable](values ...T) *EnumConstraint[T]

func (c *EnumConstraint[T]) Validate(value interface{}) error

type FieldConstraint ¶ added in v1.1.15

type FieldConstraint struct {
	Required  bool
	Validator Validator
}

type FuncValidator ¶

type FuncValidator struct {
	// contains filtered or unexported fields
}

FuncValidator 允许使用自定义函数进行验证。 这对于需要特殊逻辑的验证场景非常有用，避免为每个自定义验证创建新的结构体。

func NewFuncValidator(fn func(interface{}) error, desc string) *FuncValidator

func (v *FuncValidator) Validate(value interface{}) error

type LengthConstraint ¶

type LengthConstraint struct {
	Min *int // 最小长度指针。如果为 nil，则不检查最小长度。
	Max *int // 最大长度指针。如果为 nil，则不检查最大长度。
}

LengthConstraint 长度约束，支持字符串、字节切片、数组、切片、映射和通道等类型。

func (c *LengthConstraint) Validate(value interface{}) error

type PatternConstraint ¶

type PatternConstraint struct {
	Pattern string
	// contains filtered or unexported fields
}

PatternConstraint 正则表达式约束，用于检查字符串或字节切片是否符合指定的正则表达式。 使用 sync.Once 确保正则表达式只编译一次，且在第一次 Validate 调用时进行惰性编译。

func NewPatternConstraint(pattern string) *PatternConstraint

func (c *PatternConstraint) Validate(value interface{}) error

type RangeConstraint ¶

type RangeConstraint[T constraints.Ordered] struct {
	Min *T // 可选的最小值指针。如果为 nil，则不检查最小值。
	Max *T // 可选的最大值指针。如果为 nil，则不检查最大值。
}

RangeConstraint 数值范围约束，支持所有有序类型（例如：int, float64, string 等）。

func (c *RangeConstraint[T]) Validate(value interface{}) error

type RequiredConstraint ¶

type RequiredConstraint struct{}

RequiredConstraint 必填约束，用于检查值是否为空（nil、空字符串、空切片等）。

func (c *RequiredConstraint) Validate(value interface{}) error

type StructConstraint ¶ added in v1.1.12

type StructConstraint struct {
	Fields map[string]FieldConstraint // 字段路径到验证器的映射
}

StructConstraint 结构体字段验证约束

func NewStructConstraint(fields map[string]FieldConstraint) *StructConstraint

func (c *StructConstraint) Validate(value interface{}) error

type TimeConstraint ¶

type TimeConstraint struct {
	Format *string    // 可选的时间格式字符串（例如 "2006-01-02 15:04:05"）。如果为 nil，则验证时间戳或 time.Time。
	Min    *time.Time // 可选的最小时间点。
	Max    *time.Time // 可选的最大时间点。
}

TimeConstraint 时间约束，用于验证时间戳或时间字符串。

func (v *TimeConstraint) Validate(value interface{}) error

type TypeConstraint ¶

type TypeConstraint struct {
	ExpectedType reflect.Type // 期望的 Go 类型
	StrictMode   bool
}

TypeConstraint 类型约束验证器，用于检查值的实际类型是否符合期望。

func NewTypeConstraint(t reflect.Type) *TypeConstraint

func NewTypeConstraintWithMode(t reflect.Type, strict bool) *TypeConstraint

func (c *TypeConstraint) Validate(value interface{}) error

type Validator ¶

type Validator interface {
	Validate(value interface{}) error
}

Validator 数据验证接口定义了所有验证器必须实现的方法。 所有具体的约束（如 RangeConstraint、LengthConstraint 等）都应实现此接口。