Πώς λειτουργεί η εισχύσιμη εξάρτηση (Depends);

Question

Accepted Answer

Το σύστημα **εισχύσιμης εξάρτησης** του FastAPI σας επιτρέπει να δηλώσετε επανάχρησης εξαρτήσεις (συναρτήσεις/κλάσεις) που καλεί το FastAPI και **εισάγει** στις λειτουργίες διαδρομής σας μέσω `Depends()`. Χρησιμοποιείται για κοινή λογική όπως συνεδρίες βάσης δεδομένων, πιστοποίηση και κοινές παράμετροι — διατηρεί τον κώδικα DRY και δοκιμάσιμο.

## Μια βασική εξάρτηση

```python
from fastapi import Depends

# a dependency is just a callable that returns something
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI calls pagination() and injects the result
    return params
# the skip/limit query params are now handled by the reusable dependency
```

Δηλώνοντας `params = Depends(pagination)` λέει στο FastAPI να καλέσει `pagination` (επίλυση *των* παραμέτρων του από το αίτημα επίσης) και να περάσει το αποτέλεσμα στη συνάρτησή σας. Η εξάρτηση είναι επανάχρησης σε πολλα endpoints.

## Εξαρτήσεις με καθαρισμό (yield) — π.χ. συνεδρίες βάσης δεδομένων

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # provide the session to the endpoint
    finally:
        db.close()                # cleanup runs AFTER the response — guaranteed

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # uses the injected, auto-closed session
```

Μια εξάρτηση `yield` παρέχει έναν πόρο και εκτελεί καθαρισμό μετά το αίτημα — το πρότυπο για συνεδρίες βάσης δεδομένων (ανοίξτε πριν, κλείστε μετά, αυτόματα).

## Οι εξαρτήσεις μπορούν να εξαρτώνται από εξαρτήσεις

```python
def get_current_user(token: str = Depends(get_token)):   # depends on another dependency
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth via injection
    return user
```

Οι εξαρτήσεις σχηματίζουν ένα δέντρο — το FastAPI επιλύει ολόκληρη την αλυσίδα. Έτσι υλοποιείται συνήθως η πιστοποίηση (εξάρτηση `get_current_user`).

## Εξαρτήσεις κλάσης και επανάχρηση

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # run a dependency without using its return
def items(): ...                                              # e.g. enforce auth as a side effect
```

## Γιατί είναι σημαντικό

Η εισχύσιμη εξάρτηση είναι ένα από τα πιο ισχυρά και σημαντικά χαρακτηριστικά του FastAPI — είναι πώς μοιράζεστε και επανατρέχετε τη λογική καθαρά σε όλα τα endpoints (συνεδρίες βάσης δεδομένων, πιστοποίηση, κοινές παράμετροι ερωτήματος, ελέγχους δικαιωμάτων) χωρίς αναπαραγωγή.

Η κατανόησή του είναι ουσιώδης επειδή υποστηρίζει πρότυπα: η **εξάρτηση `yield`** είναι ο πρότυπος τρόπος διαχείρισης συνεδριών βάσης δεδομένων (με εγγυημένο καθαρισμό μετά από κάθε αίτημα), και μια **εξάρτηση `get_current_user`** είναι ο ιδιωματικός τρόπος υλοποίησης της πιστοποίησης.

Το DI κάνει επίσης τον κώδικα ιδιαίτερα **δοκιμάσιμο** — μπορείτε να παρακάμψετε τις εξαρτήσεις με mocks στις δοκιμές.

Η κομψότητα του συστήματος (οι εξαρτήσεις επιλύουν τις δικές τους παραμέτρους από το αίτημα, μπορούν να εξαρτώνται από άλλες εξαρτήσεις που σχηματίζουν ένα δέντρο και ενσωματώνονται στα έγγραφα) το κάνουν ένα ευέλικτο εργαλείο για τη δόμηση πραγματικών εφαρμογών, επomένως η κατακτήση του `Depends` είναι το κλειδί για την κατασκευή καλά οργανωμένων, συντηρήσιμων, δοκιμάσιμων εφαρμογών FastAPI.