منح الأذن

الإعلانات

منح الأذن

منح الأذن <grant-uri-permission>

بناء الجملة:

وارد في:
<provider>

 

الوصف: 

يحدد مجموعات فرعية من بيانات التطبيق، التي يملك موفر المحتوى الرئيسي إذناً للوصول إليها.

يتم الإشارة إلى المجموعة الفرعية للبيانات بواسطة جزء المسار الخاص بالمحتوى: URI.

(جزء التفويض من URI يحدد موفر المحتوى). منح الاذن، يعتبر طريقة لتمكين عملاء المحتوى الذين لا يملكون أذن بالوصول عادة، إلى بياناته، للتغلب على هذا التقييد على أساس، مرة واحدة.

إذا كانت سمة grantUriPermissions لموفر المحتوى معينة على القيمة “صحيح”، فيمكن منح الأذن لأي بيانات موجودة ضمن إختصاص الموفر.

مع ذلك، إذا كانت قيمة هذه السمة “خطأ”، فيمكن منح الاذن فقط إلى المجموعات الفرعية للبيانات المحددة بواسطة هذا العنصر.

يمكن أن يحتوي الموفر على أي عدد من عناصر <grant-uri-permission>. كلٍ منها يمكنه تحديد مسار واحد فقط (سمة واحدة فقط من الثلاث سمات المحتمله).

للحصول على معلومات حول كيفية منح الأذن، راجع عنصر مرشح الغرض و سمة grantUriPermissions.

 

السمات:

android:path
android:pathPrefix
android:pathPattern

مسار يحدد المجموعة الفرعية للبيانات أو مجموعة فرعية يمكن منَح الاذن لها.

سمة المسار تحدد مسار كامل؛ يمكن منح الأذن فقط لمجموعة فرعية معينة للبيانات، محددة بواسطة هذا المسار.

سمة بادئة المسار تحدد الجزء الأولي من المسار؛ يمكن منح الأذن لجميع المجموعات الفرعية للبيانات مع المسارات التي تتشارك ذلك الجزء الأولي.

سمة نمط المسار تحدد مساراً كاملاً، ولكن مساراً يمكن أن يحتوي على الأحرف التاليه:

  • علامة النجمة (‘*‘) تطابق تسلسل من الصفر إلى عدة مرات من الحرف السابق مباشرة.
  • علامة النقطة متبوعة بنجمة (“*.“) تطابق أي تتابع من الصفر إلى العديد من الأحرف.

لأن الرمز ‘\‘ يستخدم كحرف تخطي عند قراءة السلسلة من ملف XML (قبل تحليلها كنمط)، ستحتاج إلى تخطي مزدوج: مثال، الحرف ‘*‘ سيكتب كـ “*\\” والحرف ‘\‘ سيكتب كـ”\\\\“. هذا في الأساس نفس ما تحتاج إلى كتابته في حالة بناء السلسلة في كود الجافا.

لمزيد من المعلومات عن هذه الأنواع من الأنماط، راجع وصف كلٍ من PATTERN_LITERAL, PATTERN_PREFIX, و PATTERN_SIMPLE_GLOB في فئة مطابقة النمط.

 

مقدم في:
API 1

راجع أيضاً:

السمة grantUriPermissions للعنصر <provider>.

 


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات