الفرق بين المراجعتين ل"Python/WSGIRequestHandler"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 21: سطر 21:
 
=== <code>server</code> ===
 
=== <code>server</code> ===
 
نسخة من الصنف <code>[[Python/WSGIServer|WSGIServer]]</code>.
 
نسخة من الصنف <code>[[Python/WSGIServer|WSGIServer]]</code>.
 +
 +
== توابع لإعادة تعريف القيم في الأصناف الفرعية ==
 +
 +
=== [[Python/WSGIRequestHandler/get environ|<code>get_environ()</code>‎]] ===
 +
يعيد التابع قاموسًا يحتوي على بيئة WSGI لطلب معين. ينسخ التابع افتراضيًا محتويات خاصية قاموس <code>base_environ</code> في كائن <code>WSGIServer</code> ثم يضيف عددًا من الترويسات المشتقة من طلب HTTP. يجب أن يعيد كلّ استدعاء لهذا التابع قاموسًا جديدًا يتضمّن جميع متغيرات بيئة CGI المرتبطة وكما هو محدّد في [https://www.python.org/dev/peps/pep-3333 PEP 3333].
 +
 +
=== [[Python/WSGIRequestHandler/get stderr|<code>get_stderr()</code>‎]] ===
 +
يعيد التابع الكائن الذي يجب استخدامه كتدفق <code>wsgi.errors</code>. يعيد التابع افتراضيًا <code>sys.stderr</code>.
 +
 +
=== <code>[[Python/WSGIRequestHandler/handle|handle()‎]]</code> ===
 +
يعالج التابع طلب HTTP؛ أما عمل التابع الافتراضي هو إنشاء نسخة معالج باستخدام أحد أصناف الوحدة <code>[[Python/wsgiref/handlers|wsgiref.handlers]]</code> لاستخدام واجهة تطبيق WSGI الفعلية.
  
 
== مصادر ==
 
== مصادر ==

مراجعة 08:47، 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 الفعلية.

مصادر