Perustason Depends-mekanismin lisäksi FastAPI:n riippuvuuksien injektio tukee edistyneitä kuvioita: alidependenssejä, parametroituja riippuvuuksia (luokkaperustaisia tai tehtaiden kautta), (yield), sekä testausta varten — mikä tekee siitä monipuolisen työkalun todellisten sovellusten rakenteille.
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
Riippuvuudet voivat riippua muista riippuvuuksista, muodostaen puun jonka FastAPI ratkaisee automaattisesti (ja välimuistoi jaetut riippuvuudet pyyntöä kohden, joten get_token ajetaan vain kerran vaikka sitä käyttäisivät useat riippuvuudet).
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(): ...
Luokka __call__-metodilla on määritettävä riippuvuus — voit parametroida sitä käyttöhetkellä (esim. erilaiset nopeus rajat eri reiteille).
@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
Ota käyttöön riippuvuudet koko sovelluksessa tai reittitason mukaan poikittaisille vaatimuksille (auth, nopeus rajat).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
FastAPI:n riippuvuuksien injektio on yksi sen voimakkaimmista ominaisuuksista, ja nämä edistyneet kuviot ovat se, mikä mahdollistaa todellisten, monimutkaisten sovellusten elegantin rakenteen. Niiden ymmärtäminen on arvokasta senioritason tietoa: alidependenssit rakentavat uudelleenkäytettäviä kerroksia (token → käyttäjä → ylläpitäjä) automaattisella ratkaisulla ja pyynnökohtaisella välimuistilla (redundantin työn välttämiseksi); parametroidut/luokkaperustaised riippuvuudet luovat määritettäviä, uudelleenkäytettäviä komponentteja (nopeusrajoittimet, oikeuksien tarkistukset erilaisilla asetuksilla per reitti); riippuvuudet sivuvaikutuksina toteuttavat vaatimukset siististi (auth) ilman funktioiden allekirjoitusten sotkemista; ja globaalit/reititin-tasolla olevat riippuvuudet soveltavat poikittaisia huolia (autentikointia, nopeus rajoja) koko reittien ryhmiin yhdessä paikassa.
Ratkaisevasti, riippuvuuksien korvaukset tekevät jopa monimutkaisista riippuvuuskaavioista triviaalisti testattavia.
Näiden kuvioiden hallinta — riippuvuuksien koostaminen, niiden parametrointi, niiden rajaaminen globaalisti tai reititin-tasolla ja niiden korvaaminen testeissä — on se, mikä mahdollistaa siistin, DRY:n, testattavan arkkitehtuurin ei-triviaaleissa FastAPI-sovelluksissa, erottaen kehittäjät jotka voivat hyödyntää kehyksen DI-järjestelmää täysimääräisesti niistä jotka käyttävät vain perus-Depends-toimintoa.
Se on tärkeä aihe hyvin jäsennettyjen, ylläpidettävien, suurimittakaavaisten FastAPI-sovellusten rakentamista varten.