ما هي أنماط الاعتماديات المتقدمة التي يدعمها FastAPI؟

Question

IT Interview Practice · Accepted Answer

بما يتجاوز `Depends` الأساسي، يدعم حقن الاعتماديات في FastAPI أنماطاً متقدمة: **الاعتماديات الفرعية**، **الاعتماديات ذات المعاملات** (قائمة على الفئات أو عبر المصانع)، **الموارد ذات النطاق المحدد** (yield)، **الاعتماديات العامة/على مستوى الموجه**، و**تجاوز الاعتماديات** للاختبار — مما يجعلها أداة متعددة الاستخدامات لهيكلة التطبيقات الحقيقية.

## الاعتماديات الفرعية (أشجار الاعتماديات)

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

يمكن للاعتماديات أن تعتمد على اعتماديات أخرى، مما يشكل شجرة يحلها FastAPI تلقائياً (و**يخزن مؤقتاً** الاعتماديات المشتركة لكل طلب، لذلك يعمل `get_token` مرة واحدة حتى لو تم استخدامه من قبل عدة اعتماديات).

## الاعتماديات ذات المعاملات (قائمة على الفئات)

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

الفئة التي تحتوي على `__call__` هي اعتماد **قابل للتكوين** — تقوم بتمريرة المعاملات في وقت الاستخدام (مثل حدود معدلات مختلفة لكل مسار).

## الاعتماديات كتأثيرات جانبية (لا حاجة للإرجاع)

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

## الاعتماديات العامة وعلى مستوى الموجه

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

طبّق الاعتماديات على مستوى التطبيق بالكامل أو لكل موجه للمتطلبات الشاملة (المصادقة، تحديد المعدل).

## التجاوزات للاختبار

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

## لماذا يهمك

حقن الاعتماديات في FastAPI هو أحد أقوى ميزاته، وهذه الأنماط المتقدمة هي ما يتيح لك هيكلة التطبيقات الحقيقية والمعقدة بأناقة.

فهمها معرفة قيمة على مستوى أعلى: **الاعتماديات الفرعية** تبني طبقات قابلة لإعادة الاستخدام (token → user → admin) مع الحل التلقائي والتخزين المؤقت لكل طلب (تجنب العمل الزائد)؛ **الاعتماديات ذات المعاملات/القائمة على الفئات** تنشئ مكونات قابلة للتكوين وقابلة لإعادة الاستخدام (مقيدات المعدل، فحوصات الأذونات بإعدادات مختلفة لكل مسار)؛ **الاعتماديات كتأثيرات جانبية** تفرض المتطلبات بشكل نظيف (المصادقة) دون تعقيد التوقيعات؛ و**الاعتماديات العامة/على مستوى الموجه** تطبق الاهتمامات الشاملة (المصادقة، تحديد المعدل) على مجموعات كاملة من المسارات في مكان واحد.

بشكل حاسم، **تجاوز الاعتماديات** يجعل حتى أشجار الاعتماديات المعقدة قابلة للاختبار بسهولة.

إتقان هذه الأنماط — تكوين الاعتماديات، تمريرة معاملاتها، تحديد نطاقها عالمياً أو لكل موجه، وتجاوزها في الاختبارات — هو ما يتيح العمارة النظيفة والخالية من التكرار والقابلة للاختبار في تطبيقات FastAPI غير الضيقة، مما يميز المطورين الذين يمكنهم الاستفادة الكاملة من نظام DI في الإطار عن أولئك الذين يستخدمون فقط `Depends` الأساسي.

إنه موضوع مهم لبناء تطبيقات FastAPI منظمة وقابلة للصيانة وكبيرة الحجم.

الاعتماديات الفرعية (أشجار الاعتماديات)

الاعتماديات ذات المعاملات (قائمة على الفئات)

الاعتماديات كتأثيرات جانبية (لا حاجة للإرجاع)

الاعتماديات العامة وعلى مستوى الموجه

التجاوزات للاختبار

لماذا يهمك

أسئلة ذات صلة