Az alapvető Depends mellett a FastAPI függőségiinjektálása támogat fejlett mintákat: al-függőségek, paraméterezhető függőségek (osztályalapú vagy gyárakkal), scoped erőforrások (yield), globális/router függőségek és teszteléshez — így egy sokoldalú eszköz a valós alkalmazások strukturálásához.
def get_token(authorization: str = Header()):
return parse(authorization)
def get_current_user(token: str = Depends(get_token)): # depends on another dependency
return decode(token)
def get_admin(user: User = Depends(get_current_user)): # depends on that, in turn
if not user.is_admin: raise HTTPException(403)
return user
# FastAPI resolves the whole chain, caching shared dependencies within a request
A függőségek függhetnek más függőségektől, függőségi fákat képezve, amit a FastAPI automatikusan felold (és cache-el a megosztott függőségeket kérésenkénti alapon, így a get_token egyszer fut le, még akkor is, ha több függőség is használja).
class RateLimiter:
def __init__(self, calls: int): # configure the dependency
self.calls = calls
def __call__(self, request: Request): # callable → acts as a dependency
check_rate_limit(request, self.calls)
@app.get("/items", dependencies=[Depends(RateLimiter(calls=100))]) # configured per route
def items(): ...
Egy __call__ metódusú osztály egy konfigurálható függőség — paraméterezhető használat közben (pl. különböző sebességkorlátozások útvonalankénti alapon).
@app.get("/admin", dependencies=[Depends(verify_admin)]) # run for the effect (auth check)
def admin(): ... # don't need its return value
app = FastAPI(dependencies=[Depends(verify_api_key)]) # applies to EVERY route
router = APIRouter(dependencies=[Depends(get_current_user)]) # to all routes in a router
Alkalmazz függőségeket alkalmazásszerte vagy router-enkénti alapon keresztmetszeti követelményekhez (hitelesítés, sebességkorlátozás).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
A FastAPI függőségiinjektálása az egyik legerősebb funkciója, és ezek a fejlett minták azok, amelyek lehetővé teszik a valós, összetett alkalmazások elegáns strukturálását.
Ezek megértése értékes senior szintű ismeret: az al-függőségek újrafelhasználható rétegeket építenek (token → felhasználó → admin) automatikus feloldással és kérésenkénti cache-eléssel (redundáns munka elkerülésével); a paraméterezhető/osztályalapú függőségek konfigurálható, újrafelhasználható komponenseket hoznak létre (sebességkorlátozók, engedélyezési ellenőrzések különböző beállításokkal útvonalankénti alapon); a mellékhatás függőségek tisztán kényszerítik ki a követelményeket (hitelesítés) anélkül, hogy bezavarnák a függvénysignatúrákat; és a globális/router szintű függőségek keresztmetszeti aggályokat (hitelesítés, sebességkorlátozás) alkalmaznak útvonal-csoportokra egyszerre.
Meghatározó, hogy a függőség felülbírálatok még összetett függőségi gráfokat is triviálisan tesztelhetővé teszik.
E minták mestereléséhez — függőségek összeállítása, paraméterezhető tétele, globális vagy router-szintű beállítása és felülbírálata tesztelésben — az szükséges, amely tiszta, DRY, tesztelhető architektúrát tesz lehetővé nem triviális FastAPI alkalmazásokban, megkülönböztetve azokat a fejlesztőket, akik teljes mértékben kihasználhatják a keretrendszer DI rendszerét, azoktól, akik csak alapvető Depends használnak.
Fontosnak számít jól strukturált, karbantartható, nagyméretű FastAPI alkalmazások építéséhez.