validator 包

validator 包提供了一系列的方法帮助用户快速生成用于校验参数的 Operator：

  1. // OperatorKind means opeartor kind. All operators generated in this package
  2. // are has kind `validator`.
  3. const OperatorKind = "validator"
  5. // Category distinguishs validation type based on different Validator implementation.
  6. type Category string
  8. const (
  9.     // CategoryVar indicates that the validator can validate basic built-in types.
  10.     // Types: string, int*, uint*, bool.
  11.     CategoryVar Category = "Var"
  12.     // CategoryStruct indicates that the validator can validate struct.
  13.     CategoryStruct Category = "Struct"
  14.     // CategoryCustom indicates the validator is a custom validator.
  15.     CategoryCustom Category = "Custom"
  16. )
  18. // Validator describes an interface for all validator.
  19. type Validator interface {
  20.     definition.Operator
  21.     // Category indicates validator type.
  22.     Category() Category
  23.     // Tag returns tag.
  24.     Tag() string
  25.     // Description returns description of current validator.
  26.     Description() string
  27. }
  29. // NewCustom calls f for validation, using description for doc gen.
  30. // User should only do custom validation in f.
  31. // Validations which can be done by other way should be done in another Operator.
  32. // Exp:
  33. // []definition.Operator{NewCustom(f,"custom validation description")}
  34. // f should be func(ctx context.Context, object AnyType) error
  35. func NewCustom(f interface{}, description string) Validator
  37. // Struct returns an operator to validate a structs exposed fields, and automatically validates nested structs, unless otherwise specified
  38. // and also allows passing of context.Context for contextual validation information.
  39. func Struct(instance interface{}) Validator
  41. // String creates validator for string type.
  42. func String(tag string) Validator
  44. // Int creates validator for int type.
  45. func Int(tag string) Validator
  47. // Int64 creates validator for int64 type.
  48. func Int64(tag string) Validator
  50. // Int32 creates validator for int32 type.
  51. func Int32(tag string) Validator
  53. // Int16 creates validator for int16 type.
  54. func Int16(tag string) Validator
  56. // Int8 creates validator for int8 type.
  57. func Int8(tag string) Validator
  59. // Byte creates validator for byte type.
  60. func Byte(tag string) Validator
  62. // Uint creates validator for uint type.
  63. func Uint(tag string) Validator
  65. // Uint64 creates validator for uint64 type.
  66. func Uint64(tag string) Validator
  68. // Uint32 creates validator for uint32 type.
  69. func Uint32(tag string) Validator
  71. // Uint16 creates validator for uint16 type.
  72. func Uint16(tag string) Validator
  74. // Uint8 creates validator for uint8 type.
  75. func Uint8(tag string) Validator
  77. // Bool creates validator for bool type.
  78. func Bool(tag string) Validator

目前支持三种类型的验证，分别对应 golang 基础类型，结构体类型和自定义类型。目前验证方法基于 gopkg.in/go-playground/validator.v9，如果希望使用其他工具，可以自定义一套类似的验证函数。