FastAPI รองรับรูปแบบ dependency ขั้นสูงอะไรบ้าง?

Question

Accepted Answer

นอกเหนือจาก `Depends` พื้นฐานแล้ว dependency injection ของ FastAPI ยังรองรับรูปแบบขั้นสูง: **sub-dependencies**, **dependency ที่รับพารามิเตอร์** (แบบ class-based หรือผ่าน factory), **scoped resource** (yield), **dependency แบบ global/router** และ **dependency override** สำหรับการทดสอบ — ทำให้มันเป็นเครื่องมือที่ยืดหยุ่นสำหรับการจัดโครงสร้างแอปพลิเคชันจริง

## Sub-dependencies (dependency tree)

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

Dependency สามารถพึ่งพา dependency อื่น ๆ ได้ ก่อตัวเป็น tree ที่ FastAPI resolve ให้โดยอัตโนมัติ (และ **cache** ตัวที่ใช้ร่วมกันต่อ request ดังนั้น `get_token` จะรันเพียงครั้งเดียวแม้จะถูกใช้โดยหลาย dependency)

## Dependency ที่รับพารามิเตอร์ (class-based)

```python
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(): ...
```

Class ที่มี `__call__` เป็น dependency ที่ **ตั้งค่าได้** — คุณกำหนดพารามิเตอร์ของมันได้ตอนใช้งาน (เช่น rate limit ที่ต่างกันในแต่ละ route)

## Dependency แบบ side-effect (ไม่จำเป็นต้อง return)

```python
@app.get("/admin", dependencies=[Depends(verify_admin)])   # run for the effect (auth check)
def admin(): ...                                            # don't need its return value
```

## Dependency ระดับ global และ router

```python
app = FastAPI(dependencies=[Depends(verify_api_key)])      # applies to EVERY route
router = APIRouter(dependencies=[Depends(get_current_user)])  # to all routes in a router
```

นำ dependency มาใช้ทั่วทั้งแอปหรือต่อ router สำหรับความต้องการแบบ cross-cutting (auth, rate limiting)

## Override สำหรับการทดสอบ

```python
app.dependency_overrides[get_db] = get_test_db    # swap any dependency in tests
```

## ทำไมจึงสำคัญ

Dependency injection ของ FastAPI เป็นหนึ่งในฟีเจอร์ที่ทรงพลังที่สุดของมัน และรูปแบบขั้นสูงเหล่านี้คือสิ่งที่ทำให้คุณสามารถจัดโครงสร้างแอปพลิเคชันจริงที่ซับซ้อนได้อย่างสวยงาม

การเข้าใจมันเป็นความรู้ระดับ senior ที่มีค่า: **sub-dependencies** สร้างชั้นที่นำกลับมาใช้ใหม่ได้ (token → user → admin) พร้อมการ resolve อัตโนมัติและการ cache ต่อ request (หลีกเลี่ยงงานซ้ำซ้อน); **dependency แบบ parameterized/class-based** สร้าง component ที่ตั้งค่าได้และนำกลับมาใช้ใหม่ได้ (rate limiter, การตรวจสอบสิทธิ์ที่มีการตั้งค่าต่างกันในแต่ละ route); **dependency แบบ side-effect** บังคับใช้ข้อกำหนด (auth) ได้อย่างสะอาดโดยไม่ทำให้ function signature รก; และ **dependency ระดับ global/router** นำ concern แบบ cross-cutting (authentication, rate limiting) มาใช้กับกลุ่ม route ทั้งหมดในที่เดียว

ที่สำคัญคือ **dependency override** ทำให้แม้แต่ dependency graph ที่ซับซ้อนก็ทดสอบได้อย่างง่ายดาย

การเชี่ยวชาญรูปแบบเหล่านี้ — การ compose dependency, การกำหนดพารามิเตอร์, การ scope แบบ global หรือต่อ router และการ override ในการทดสอบ — คือสิ่งที่ทำให้สถาปัตยกรรมที่สะอาด, DRY และทดสอบได้เป็นไปได้ในแอป FastAPI ที่ไม่ธรรมดา ซึ่งแยกแยะนักพัฒนาที่ใช้ประโยชน์จากระบบ DI ของ framework ได้เต็มที่ออกจากผู้ที่ใช้เพียง `Depends` พื้นฐาน

มันเป็นหัวข้อสำคัญสำหรับการสร้างแอป FastAPI ที่มีโครงสร้างดี ดูแลรักษาง่าย และมีขนาดใหญ่