<grant-uri-permission>

Syntax:
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
enthalten in:
<provider>
description:
Gibt die Teilmengen von App-Daten an, für die der übergeordnete Contentanbieter eine Zugriffsberechtigung hat. Datenteilmengen sind am Pfadteil eines content:-URI angegeben. Der „Authority“-Teil des URI identifiziert den Contentanbieter. Durch das Gewähren der Berechtigung können Clients des Anbieters, die normalerweise keine Berechtigung für den Zugriff auf seine Daten haben, diese Einschränkung einmalig umgehen.

Wenn das Attribut grantUriPermissions eines Contentanbieters true ist, kann die Berechtigung für alle Daten im Zuständigkeitsbereich des Anbieters gewährt werden. Lautet dieses Attribut jedoch false, wird die Berechtigung nur für Datenteilmengen gewährt, die durch dieses Element angegeben werden. Ein Anbieter kann eine beliebige Anzahl von <grant-uri-permission>-Elementen enthalten. Mit jedem Attribut kann nur ein Pfad angegeben werden, wobei eines der drei möglichen Attribute verwendet wird.

Informationen dazu, wie Berechtigungen gewährt werden, finden Sie im Attribut grantUriPermissions des Elements <intent-filter>.

Attribute:
android:path
android:pathPrefix
android:pathPattern
Ein Pfad zur Identifizierung der Datenteilmengen, für die Berechtigungen gewährt werden können. Das Attribut path gibt einen vollständigen Pfad an. Eine Berechtigung kann nur der bestimmten Datenteilmenge gewährt werden, die durch diesen Pfad identifiziert wird.

Das Attribut pathPrefix gibt den ersten Teil eines Pfads an. Die Berechtigung kann allen Datenteilmengen mit Pfaden, die diesen ersten Teil verwenden, gewährt werden. Das Attribut pathPattern gibt einen vollständigen Pfad an, der jedoch die folgenden Platzhalter enthalten kann:

  • Ein Sternchen (*) entspricht einer Abfolge von null bis vielen Vorkommen des unmittelbar vorangehenden Zeichens.
  • Ein Punkt gefolgt von einem Sternchen (.*) entspricht einer beliebigen Folge von null bis vielen Zeichen.

Da \ beim Lesen des Strings aus XML als Escape-Zeichen verwendet wird, muss vor dem Parsen als Muster eine doppelte Maskierung erfolgen. Ein Literal * wird beispielsweise als \\* und ein Literal \ als \\\ geschrieben.

Weitere Informationen zu diesen Mustertypen finden Sie in den Beschreibungen von PATTERN_LITERAL, PATTERN_PREFIX und PATTERN_SIMPLE_GLOB in der Klasse PatternMatcher.

eingeführt in:
API-Level 1
Siehe auch:
grantUriPermissions Attribut des <provider>-Elements