Conas a dhéileálann tú le hearráidí agus eisceachtaí HTTP a thógáil?

Question

Accepted Answer

Déileálann FastAPI le hearráidí trí **eisceachtaí a thógáil** agus iad a thiontú ina fhreagraí HTTP cuí. Clúdaíonn `HTTPException` an chuid is mó de na cásanna; ligeann gnáthobair eisceachta saincheaptha duit formáid na bhearráidí a rialú ar bhonn domhanda.

## HTTPException a thógáil

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

Is é an bealach idiomatic `raise HTTPException(status_code=..., detail=...)` earráid a fhilleadh — táirgeann FastAPI freagra JSON `{"detail": "..."}` leis an stádas tugtha. Is féidir leis an `detail` a bheith ina luach inseachtraithe JSON ar bith (teanga, dict, liosta).

## Earráidí bailíochtaithe atá uathoibríoch (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.
```

## Gnáthobair eisceachta saincheaptha (formáid dhomhanda)

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

Ligeann gnáthobair eisceachta saincheaptha duit do chuid eisceachtaí féin (fearann) a mhapáil ar fhreagraí, ag ionadaíochtú formáid na bhearráidí agus ag coimeád an chóid ghníomhaireachta glan.

## Gnáthobair réamhshocraithe a fhorscríobh

```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()})
```

## Cén fáth atá sé tábhachtach

Is riachtanach a bheith ag déileáil go cuí le hearráidí chun APIanna iontaofa agus gairmiúla a thógáil, agus tá cur chuige FastAPI soiléir agus comhsheasmhach.

Tá an `HTTPException` idiomatic ina dhéanamh furasta freagraí earráide cearta a fhilleadh le cóid stádais agus teachtaireachtaí cuí — bunúsach do aon ionchur a d'fhéadfadh fáil (gan fáil, toirmiscthe, drochstaid).

I ndiaidh a chéile luachmhar atá go **bhfuil earráidí bailíochtaithe á ndéileáil go huathoibríoch** (táirgeann teips Pydantic freagraí struchtúrtha 422 gan cód ó do bharr), agus go **ligeann gnáthobair eisceachta saincheaptha** duit do chuid eisceachtaí fearainn féin a mhapáil ar fhreagraí agus formáid earráide comhsheasmhach a fhorfheidhmiú ar fud an API iomlán — ag feabhrú an dá dhóigh do inbhuanaitheacht (loighic earráide lárnaithe) agus do thaithí an chliaint (cruth earráide inbhuanaithe).

Tuiscint a bheith agat ar `HTTPException`, earráidí bailíochtaithe uathoibríocha, agus gnáthobair shaincheaptha clúdaíonn an speictream praiticiúil de dhéileáil le hearráidí, rud a dhéanann sé tábhachtach do thogra APIanna láidre a thógáil.