الفرق بين المراجعتين لصفحة: «Python/urllib/request/URLopener»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 20: | سطر 20: | ||
تطلق كائنات <code>URLopener</code> الاستثناء <code>OSError</code> إن أعاد المخدّم شيفرة خطأ. | تطلق كائنات <code>URLopener</code> الاستثناء <code>OSError</code> إن أعاد المخدّم شيفرة خطأ. | ||
== خصائص الصنف URLopener == | |||
تمتلك كائنات 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 المعطى ويضعها في الملف المعطى. | |||
== مصادر == | == مصادر == | ||
مراجعة 17:46، 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 المعطى ويضعها في الملف المعطى.