Hoe schrijf je aangepaste validatie in Pydantic?

Question

Accepted Answer

Naast ingebouwde beperkingen stelt Pydantic je in staat om **aangepaste validatielogica** te schrijven met field validators (valideer één veld) en model validators (valideer meerdere velden) — voor regels die eenvoudige beperkingen niet kunnen uitdrukken. (De weergegeven syntaxis is voor Pydantic v2.)

## Field validators — valideer/transformeer een enkel veld

```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
```

Een `@field_validator` voert aangepaste logica uit op een veld: verhoog `ValueError` om ongeldige invoer af te wijzen (FastAPI zet dit om in een duidelijke 422), of geef een getransformeerde waarde terug (bijv. normalisatie naar kleine letters).

## Model validators — validatie over meerdere velden

```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
```

Een `@model_validator(mode="after")` wordt uitgevoerd nadat alle velden zijn gevalideerd, met toegang tot het hele model — gebruikt voor regels met **meerdere velden** (bijv. bevestiging dat wachtwoorden overeenkomen, of dat een startdatum voor een einddatum ligt).

## Ingebouwde validatie is vaak eerst voldoende

```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
```

Voorkeur voor `Field`-beperkingen en gespecialiseerde typen voor eenvoudige regels; gebruik aangepaste validators voor echte bedrijfslogica.

## Waarom het belangrijk is

Angepaste Pydantic-validatie is belangrijk voor het afdwingen van bedrijfsregels die verder gaan dan eenvoudige typecontroles en beperkingen — en omdat validatie cruciaal is voor **veiligheid en gegevensintegriteit**, is het waardevol om elke regel te kunnen uitdrukken. **Field validators** behandelen logica op één veld (aangepaste formaatcontroles, normalisatie/transformatie), terwijl **model validators** de veelvoorkomende behoefte aan **validatie over meerdere velden** behandelen (wachtwoorden die overeenkomen, datumbereiken, voorwaardelijke vereisten) die regels op veldniveau niet kunnen uitdrukken.

De validators integreren naadloos met FastAPI — een verheven `ValueError` wordt automatisch een duidelijke 422-respons.

Begrepen wanneer ingebouwde beperkingen/typen (voor eenvoudige regels) worden gebruikt versus aangepaste validators (voor echte bedrijfslogica), en hoe field- versus model-validators verschillen, stelt je in staat om ervoor te zorgen dat binnenkomende gegevens volledig aan de vereisten van je toepassing voldoen, wat deze kennis belangrijk maakt voor het bouwen van robuuste, correcte API's.