Kif taħdem il-ġbalil u tressaq isceċċjonijiet HTTP?

Question

Accepted Answer

FastAPI taħdem il-ġbalil billi **tressaq isceċċjonijiet** li tinvertihom f'risposti HTTP xierqa. `HTTPException` tkopri ħafna każi; handlers ta' isceċċjonijiet personalizzati jħalluk tikontolla l-formato tal-ġbalil globalment.

## Tressaq HTTPException

```python
from fastapi import HTTPException

@app.get("/items/{id}")
def get_item(id: int):
    item = db.get(id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")   # → 404 JSON response
    if not item.is_public:
        raise HTTPException(status_code=403, detail="Forbidden")
    return item
```

`raise HTTPException(status_code=..., detail=...)` hija l-mod idiomatiku biex tirritorna żball — FastAPI tipproduċi risposta JSON `{"detail": "..."}` mal-istatus mogħti. `detail` jista' ikun kwalsiasi valur JSON-serializable (string, dict, list).

## Ġbalil ta' validazzjoni huma awtomatiku (422)

```text
When request data fails Pydantic validation, FastAPI AUTOMATICALLY returns a 422
with a structured list of exactly which fields are wrong — you write nothing.
```

## Handlers ta' isceċċjonijiet personalizzati (formato globali)

```python
from fastapi import Request
from fastapi.responses import JSONResponse

class ItemNotFound(Exception):
    def __init__(self, item_id: int): self.item_id = item_id

@app.exception_handler(ItemNotFound)         # handle a custom exception type globally
def handle_not_found(request: Request, exc: ItemNotFound):
    return JSONResponse(status_code=404, content={"error": f"Item {exc.item_id} not found"})

@app.get("/items/{id}")
def get(id: int):
    raise ItemNotFound(id)        # raise your domain exception; the handler formats it
```

Handlers ta' isceċċjonijiet personalizzati jħalluk imappja l-isceċċjonijiet (ta' dominju) tiegħek stess għas-risposti, tentralizza l-formato tal-ġbalil u żomm il-kodiċi tal-handler nadif.

## Sorpassa handlers default

```python
from fastapi.exceptions import RequestValidationError

@app.exception_handler(RequestValidationError)   # customize the 422 validation-error format
def validation_handler(request, exc):
    return JSONResponse(status_code=422, content={"errors": exc.errors()})
```

## Għaliex Dan Importanti

Ta' gwid ta' ġbalil xieraq huwa essenzjali għall-bina ta' APIs affidabbli u professjonali, u l-approċċ ta' FastAPI huwa nadif u konsistent.

L-`HTTPException` idiomatiku jagħmilha faċli biex torjotta risposti ta' ġbalil xierqa b'kodijiet ta' status u messaggi xierqa — fundamentali għal kwalsiasi endpoint li jista' jfalli (mhux misjuB, ipprojbixxa, stat ħażin).

Iqali valur huwa li **ġbalil ta' validazzjoni jitħaddmu awtomatikament** (fallimenti Pydantic jipproduċu risposti strutturati 422 mingħajr kodiċi minnok), u li **handlers ta' isceċċjonijiet personalizzati** jħalluk imappja l-isceċċjonijiet ta' dominju tiegħek stess għas-risposti u timponi formato ta' ġbalil konsistent fuq il-qosor ta' l-API — ittejbu kemm il-manutenzjoni (loġika ta' ġbalil tentralizzata) kif ukoll il-karatteristika tal-klijent (forom ta' ġbalil prevedibbli).

L-għarfien ta' `HTTPException`, ġbalil ta' validazzjoni awtomatiku, u handlers personalizzati ikkopri l-spettru pratiku ta' gwid ta' ġbalil, jagħmiluha għarfien importanti għall-bina ta' APIs robust.