یک پاسخ چطور ساخته میشود¶
پاسخ موفق¶
- view جواب میدهد -
Response(serializer.data)، صفحهای از paginator، یاsuccess_response(...). - DRF،
finalize_responseview را صدا میزند، وEnvelopeMixinبه چیزی که برگشته نگاه میکند:- اگر از قبل یک
EnvelopeResponseاست - ازsuccess_responseیا paginator - دوباره در قالب گذاشته نمیشود؛ فقط پیام پیشفرضش با پیام مناسب این درخواست عوض میشود؛ - اگر خطاست، چیزی که JSON نیست، یا viewی که
parcel_wrap = Falseدارد - دست نمیخورد؛ - هر پاسخ موفق دیگری - در قالب گذاشته میشود، با هدرها و کوکیهای view، و 204 به 200 تبدیل میشود.
- اگر از قبل یک
- renderer، JSON را مینویسد.
اینکه پاسخی در قالب است از روی کلاسش گفته میشود، هرگز از روی کلیدهایش حدس
زده نمیشود: دادهی خود viewی که اتفاقاً کلید success دارد همچنان داده است.
خطا¶
view خطا raise میکند. DRF، EXCEPTION_HANDLER را صدا میزند:
Http404،PermissionDeniedوValidationErrorخود Django به معادل DRF تبدیل میشوند.- handler خود DRF اول اجرا میشود، تا هدرهایی که اضافه میکند -
Retry-After،WWW-Authenticate- و rollback آن بمانند. - خطای اعتبارسنجی: هر مشکل به یک مسیر تخت تبدیل میشود، با کدش، و اولی در
messageگفته میشود. - هر
APIExceptionدیگری - مال DRF، کتابخانه یا پروژه: وضعیتش، کدش، جزئیاتش،dataاش. - یک
IntegrityError، وقتی پروژه تور ایمنی را روشن کرده: بر اساس نوعی که درایور گزارش میدهد. - هر چیز دیگری باگ است: در
DEBUGبالا میرود؛ در غیر این صورت لاگ میشود، گزارش میشود، و با جملهای که چیزی نمیگوید جواب داده میشود.
هر خطایی که جواب داده میشود تراکنش درخواست را برای rollback علامت میزند، تا
پروژهای که ATOMIC_REQUESTS دارد هرگز نیمی از یک نوشتن را پشت یک خطا نگه
ندارد.
شکل، در یک جا¶
هر دو مسیر - و paginatorها، و اسکیما - قالب را با یک تابع میسازند،
build_envelope، و با یک تابع توصیف میکنند، envelope_schema. دو جا که آن را
بسازند، دیر یا زود دو شکل میشوند.