validation-errors

command
v14.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 12, 2026 License: BSD-3-Clause Imports: 3 Imported by: 0

Documentation

Overview

Field validation, end to end: Validate + validation.Join -> wire format.

A request type validates itself in a Validate method. ctx.BindJSON[T] calls it after decoding and, on a non-nil result, answers 400 INVALID_ARGUMENT with one entry per failing field. The builders accumulate every broken rule of a field into a single reason and validation.Join drops the fields that passed, returning nil when everything is valid.

The first request under Try answers 400 with exactly this body (the id is a per-occurrence UUID):

{
  "id": "…",
  "http_error_code": {"canonical_name": "INVALID_ARGUMENT", "status": 400},
  "message": "validation failure",
  "detail": "fields were invalid",
  "validation": [
    {"field": "name", "value": "", "reason": "must not be empty, must be between 3 and 50 characters"},
    {"field": "email", "value": "bad", "reason": "must be a valid email address"},
    {"field": "age", "value": 9, "reason": "must be between 18 and 130"},
    {"field": "roles", "value": [], "reason": "must not be empty"}
  ]
}

"name" shows the accumulation: both of its rules failed and their messages were joined into one reason.

Learn: report every invalid field of a request in one 400 response, from a Validate method or by hand with validation.Join and errors.InvalidArgument.Err. Before: ../handle-errorf

Run:

go run main.go

Try:

curl -i -X POST http://localhost:8080/users \
  -d '{"name":"","email":"bad","age":9,"roles":[]}'                                  # 400 INVALID_ARGUMENT, the body above
curl -i -X POST http://localhost:8080/users \
  -d '{"name":"Jane Doe","email":"jane@example.com","age":32,"roles":["editor"]}'   # 201
curl -i "http://localhost:8080/users?page=0"                                        # 400, validation outside a Validate method

Next: ../error-router

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL