الفرق بين المراجعتين ل"Python/WSGIRequestHandler"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server.WSGIServer</code> في بايثون}}</noinclude> تُنشئ هذه الدالة البانية H...') |
|||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server. | + | <noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server.WSGIRequestHandler</code> في بايثون}}</noinclude> |
| − | تُنشئ هذه الدالة البانية HTTP | + | تُنشئ هذه الدالة البانية معالج HTTP للطلب المعطى. |
| − | لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات WSGIServer. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة handler_class إلى الدالة make_server(). | + | لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات <code>[[Python/WSGIServer|WSGIServer]]</code>. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة <code>handler_class</code> إلى الدالة <code>[[Python/wsgiref/simple server/make server|make_server()]]</code>. |
== البنية العامة == | == البنية العامة == | ||
| سطر 13: | سطر 13: | ||
== المعاملات == | == المعاملات == | ||
=== <code>request</code> === | === <code>request</code> === | ||
| − | الطلب المراد إنشاء HTTP | + | الطلب المراد إنشاء معالج HTTP له. |
=== <code>client_address</code> === | === <code>client_address</code> === | ||
| − | عنوان العميل، وهو عبارة عن صفّ بالصيغة (host, port). | + | عنوان العميل، وهو عبارة عن [[Python/tuples|صفّ]] بالصيغة <code>(host, port)</code>. |
=== <code>server</code> === | === <code>server</code> === | ||
| − | نسخة من الصنف WSGIServer. | + | نسخة من الصنف <code>[[Python/WSGIServer|WSGIServer]]</code>. |
| + | |||
| + | == توابع لإعادة تعريف القيم في الأصناف الفرعية == | ||
| + | |||
| + | === <code rel="mw:WikiLink" href="./Python/WSGIRequestHandler/get_environ" title="Python/WSGIRequestHandler/get environ">get_environ()</code> === | ||
| + | يعيد التابع قاموسًا يحتوي على بيئة WSGI لطلب معين. ينسخ التابع افتراضيًا محتويات خاصية قاموس <code>base_environ</code> في كائن <code>WSGIServer</code> ثم يضيف عددًا من الترويسات المشتقة من طلب HTTP. يجب أن يعيد كلّ استدعاء لهذا التابع قاموسًا جديدًا يتضمّن جميع متغيرات بيئة CGI المرتبطة وكما هو محدّد في [https://www.python.org/dev/peps/pep-3333 PEP 3333]. | ||
| + | |||
| + | === <code rel="mw:WikiLink" href="./Python/WSGIRequestHandler/get_stderr" title="Python/WSGIRequestHandler/get stderr">get_stderr()</code> === | ||
| + | يعيد التابع الكائن الذي يجب استخدامه كتدفق <code>wsgi.errors</code>. يعيد التابع افتراضيًا <code>sys.stderr</code>. | ||
| + | |||
| + | === <code>handle()</code> === | ||
| + | يعالج التابع طلب HTTP؛ أما عمل التابع الافتراضي هو إنشاء نسخة معالج باستخدام أحد أصناف الوحدة <code>[[Python/wsgiref/handlers|wsgiref.handlers]]</code> لاستخدام واجهة تطبيق WSGI الفعلية. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 08:48، 27 ديسمبر 2018
تُنشئ هذه الدالة البانية معالج HTTP للطلب المعطى.
لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات WSGIServer. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة handler_class إلى الدالة make_server().
البنية العامة
wsgiref.simple_server.WSGIRequestHandler(request, client_address, server)
المعاملات
request
الطلب المراد إنشاء معالج HTTP له.
client_address
عنوان العميل، وهو عبارة عن صفّ بالصيغة (host, port).
server
نسخة من الصنف WSGIServer.
توابع لإعادة تعريف القيم في الأصناف الفرعية
get_environ()
يعيد التابع قاموسًا يحتوي على بيئة WSGI لطلب معين. ينسخ التابع افتراضيًا محتويات خاصية قاموس base_environ في كائن WSGIServer ثم يضيف عددًا من الترويسات المشتقة من طلب HTTP. يجب أن يعيد كلّ استدعاء لهذا التابع قاموسًا جديدًا يتضمّن جميع متغيرات بيئة CGI المرتبطة وكما هو محدّد في PEP 3333.
get_stderr()
يعيد التابع الكائن الذي يجب استخدامه كتدفق wsgi.errors. يعيد التابع افتراضيًا sys.stderr.
handle()
يعالج التابع طلب HTTP؛ أما عمل التابع الافتراضي هو إنشاء نسخة معالج باستخدام أحد أصناف الوحدة wsgiref.handlers لاستخدام واجهة تطبيق WSGI الفعلية.