الفرق بين المراجعتين لصفحة: «Python/urllib/request/URLopener»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>urllib.request.URLopener()</code> في بايثون}}</noinclude> '''ملاحظة:''' هذا الصنف مهمل في ا...' |
طلا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 2: | سطر 2: | ||
'''ملاحظة:''' هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون. | '''ملاحظة:''' هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون. | ||
هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات http: أو ftp: أو | هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات <code>http:</code> أو <code>ftp:</code> أو <code>file</code>، فستحتاج على الأرجح إلى استخدام الصنف <code>[[Python/urllib/request/FancyURLopener|FancyURLopener]]</code>. | ||
يرسل الصنف <code>URLopener</code> افتراضيًا ترويسة <code>User</code>-<code>Agent</code> من نوع <code>urllib/VVV</code> حيث تمثل <code>VVV</code> رقم إصدار <code>urllib</code>. يمكن للتطبيقات أن تعرّف ترويسة <code>User-Agent</code> الخاصّة بها عن طريق إنشاء أصناف فرعية من الصنف <code>URLopener</code> أو <code>[[Python/urllib/request/FancyURLopener|FancyURLopener]]</code> وتعيين قيمة نصية ملائمة للخاصية <code>version</code> في تعريف الصنف المتفرّع. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 17: | سطر 15: | ||
=== <code>proxies</code> === | === <code>proxies</code> === | ||
يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة None كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة urlopen(). | يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة <code>None</code> كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة <code>[[Python/urllib/request/urlopen|urlopen()]]</code>. | ||
يمكن استخدام معاملات مفتاحية إضافية -تُجمع في <code>x509</code>- لإجراء عملية الاستيثاق على العميل عند استخدام المخطط <code>https:</code>. يمكن استخدام الكلمتين المفتاحيتين <code>key_file</code> و <code>cert_file</code> لتزويد الدالة بمفتاح SSL وشهادة واللذان تحتاجهما الدالة لدعم عملية استيثاق العميل. | |||
تطلق كائنات <code>URLopener</code> الاستثناء <code>OSError</code> إن أعاد المخدّم شيفرة خطأ. | |||
== خصائص الصنف <code>URLopener</code> == | |||
تمتلك كائنات URLopener خاصية وحيدة هي: | |||
=== الخاصية <code>version</code> === | |||
متغيّر يحدّد وكيل المستخدم لكائن الفتح. يمكن استخدام هذا المتغيّر في صنف فرعي أو في الدالة البانية قبل استدعاء الدالة البانية الأساسية، لتُخبر وحدة <code>urllib</code> المخدّم بوجود وكيل مستخدم خاص. | |||
== توابع الصنف <code>URLopener</code> == | |||
تقدّم كائنات <code>URLopener</code> التوابع التالية: | |||
=== التابع <code>[[Python/urllib/request/URLopener/open|open()]]</code> === | |||
يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب. | |||
=== التابع <code>[[Python/urllib/request/URLopener/open unknown|open_unknown()]]</code> === | |||
واجهة قابلة للتعديل لفتح عناوين URL مجهولة النوع. | |||
=== التابع <code>[[Python/urllib/request/URLopener/retrieve|retrieve()]]</code> === | |||
يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 19:45، 3 فبراير 2019
ملاحظة: هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون.
هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات http: أو ftp: أو file، فستحتاج على الأرجح إلى استخدام الصنف FancyURLopener.
يرسل الصنف URLopener افتراضيًا ترويسة User-Agent من نوع urllib/VVV حيث تمثل VVV رقم إصدار urllib. يمكن للتطبيقات أن تعرّف ترويسة User-Agent الخاصّة بها عن طريق إنشاء أصناف فرعية من الصنف URLopener أو FancyURLopener وتعيين قيمة نصية ملائمة للخاصية version في تعريف الصنف المتفرّع.
البنية العامة
urllib.request.URLopener(proxies=None, **x509)
المعاملات
proxies
يجب أن يكون هذا المعامل الاختياري قاموسًا يربط أسماء المخطّطات بوسائط URL، وإن كان القاموس فارغًا فلن تستخدم الوسائط على الإطلاق. يأخذ هذا المعامل القيمة None كقيمة افتراضية، وفي هذه الحالة تُستخدم إعدادات الوسيط في البيئة إن كانت موجودة وكما مرّ ذكره في تعريف الدالة urlopen().
يمكن استخدام معاملات مفتاحية إضافية -تُجمع في x509- لإجراء عملية الاستيثاق على العميل عند استخدام المخطط https:. يمكن استخدام الكلمتين المفتاحيتين key_file و cert_file لتزويد الدالة بمفتاح SSL وشهادة واللذان تحتاجهما الدالة لدعم عملية استيثاق العميل.
تطلق كائنات URLopener الاستثناء OSError إن أعاد المخدّم شيفرة خطأ.
خصائص الصنف URLopener
تمتلك كائنات URLopener خاصية وحيدة هي:
الخاصية version
متغيّر يحدّد وكيل المستخدم لكائن الفتح. يمكن استخدام هذا المتغيّر في صنف فرعي أو في الدالة البانية قبل استدعاء الدالة البانية الأساسية، لتُخبر وحدة urllib المخدّم بوجود وكيل مستخدم خاص.
توابع الصنف URLopener
تقدّم كائنات URLopener التوابع التالية:
التابع open()
يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب.
التابع open_unknown()
واجهة قابلة للتعديل لفتح عناوين URL مجهولة النوع.
التابع retrieve()
يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى.