الفرق بين المراجعتين لصفحة: «Python/WSGIRequestHandler»

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server.WSGIServer‎‎</code> في بايثون}}</noinclude> تُنشئ هذه الدالة البانية H...'
 
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server.WSGIServer‎‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:الصنف <code>wsgiref.simple_server.WSGIRequestHandler</code> في بايثون}}</noinclude>


تُنشئ هذه الدالة البانية HTTP Handler للطلب المعطى.
تُنشئ هذه الدالة البانية معالج 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 Handler له.
الطلب المراد إنشاء معالج 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 الفعلية.

مصادر