Kaip Pydantic-e rašyti pasirinktinę validaciją?

Question

Accepted Answer

Viršijant įtaisytus apribojimus, Pydantic leidžia jums rašyti **pasirinktinę validacijos logiką** su lauko validatoriais (validuoti vieną lauką) ir modelio validatoriais (validuoti kelis laukus) — taisyklėms, kurias paprastas apribojimai negali išreikšti. (Rodyta sintaksė yra Pydantic v2.)

## Lauko validatoriai — validuoti/transformuoti vieną lauką

```python
from pydantic import BaseModel, field_validator

class User(BaseModel):
    username: str
    password: str

@field_validator("username")
    @classmethod
    def username_alphanumeric(cls, v: str) -> str:
        if not v.isalnum():
            raise ValueError("username must be alphanumeric")   # → a 422 error
        return v.lower()                                         # can also TRANSFORM the value
```

`@field_validator` vykdo pasirinktinę logiką lauke: iškelt `ValueError` norėdami atmesti nevalidų įvestį (FastAPI jį paverčia aiškiu 422), arba grąžinti transformuotą reikšmę (pvz. normalizavimas į mažąsias raides).

## Modelio validatoriai — tarp-lauko validacija

```python
from pydantic import model_validator

class SignupForm(BaseModel):
    password: str
    confirm_password: str

@model_validator(mode="after")
    def passwords_match(self):
        if self.password != self.confirm_password:    # compare MULTIPLE fields
            raise ValueError("passwords do not match")
        return self
```

`@model_validator(mode="after")` veikia po to, kai validuoti visi laukai, su prieiga prie viso modelio — naudojama **keletą laukų** susijusioms taisyklėms (pvz. patvirtinti, kad slaptažodžiai sutampa, arba kad pradžios data yra ankščiau nei pabaigos data).

## Įtaisyta validacija dažnai pakanka pradžiai

```python
class Product(BaseModel):
    price: float = Field(gt=0)          # use Field constraints for simple rules
    sku: str = Field(pattern=r"^[A-Z]{3}-\d+$")
    email: EmailStr                      # specialized types for formats
# reach for custom validators only when constraints/types can't express the rule
```

Pagal paprastų taisyklių `Field` apribojimus ir specializuotus tipus; naudokite pasirinktines validatorius tikrai verslo logikai.

## Kodėl tai svarbu

Pydantic pasirinktinė validacija svarbi verslo taisyklėms, einančioms viršijant paprastą tipų tikrinimą ir apribojimus, nustatyti — ir kadangi validacija yra kritinė **saugumui ir duomenų integralumui**, gebėjimas išreikšti bet kokią taisyklę yra vertingas. **Lauko validatoriai** tvarko vieno lauko logiką (pasirinktinis formato tikrinimas, normalizavimas/transformavimas), o **modelio validatoriai** tvarko bendrą poreikį **tarp-lauko validacijai** (slaptažodžiai sutampa, datų intervalai, sąlyginiai reikalavimai), kuriuos lauko lygio taisyklės negali išreikšti.

Validatoriai sklandžiai integruojasi su FastAPI — iškelta `ValueError` automatiškai tampa aiškiu 422 atsakymu.

Supratimas, kada naudoti įtaisytus apribojimus/tipus (paprastoms taisyklėms) prieš pasirinktines validatorius (tikrai verslo logikai), ir kaip skiriasi lauko ir modelio validatoriai, leidžia jums užtikrinti, kad gaunami duomenys visapusiškai atitinktu jūsų programos reikalavimus, todėl tai yra svarbi žinios, skirtos kurti tvirias, teisingas API.