構文:

<path-permission android:path="string"
                 android:pathPrefix="string"
                 android:pathPattern="string"
                 android:permission="string"
                 android:readPermission="string"
                 android:writePermission="string" />

上位の要素:

<provider>

説明:

コンテンツ プロバイダ内のデータの特定のサブセットに対するパスと必須の権限を定義します。この要素を複数回指定することで、複数のパスを指定できます。

属性:

android:path

コンテンツ プロバイダ データのサブセットの完全 URI パス。このパスで識別される特定のデータに対してのみ、権限を付与できます。検索候補コンテンツの提供に使用する場合、/search_suggest_query が追加されます。

android:pathPrefix

コンテンツ プロバイダ データのサブセットの、URI パスの最初の部分。この最初の部分を共有するパスを持つすべてのデータ サブセットに対して権限を付与できます。

android:pathPattern

コンテンツ プロバイダ データのサブセットの完全 URI パスを指定しますが、以下のワイルドカードを使用できます。

• アスタリスク（*）。直前の文字が 0 個以上出現するシーケンスと一致します。
• ピリオドとそれに続くアスタリスク（.*）。0 個以上の文字のシーケンスに一致します。

バックスラッシュ（\）は、文字列を XML から読み取る際にエスケープ文字として使用されるため、パターンとして解析される前にダブル エスケープする必要があります。たとえば、リテラル * は「\\*」と記述し、リテラル \ は「\\\」と記述します。これは、Java プログラミング言語で文字列を作成する際の記述方法と同じです。

これらの各種パターンについて詳しくは、PatternMatcher クラスの PATTERN_LITERAL、PATTERN_PREFIX、PATTERN_SIMPLE_GLOB の説明をご覧ください。

android:permission

コンテンツ プロバイダのデータを読み書きする際にクライアントが必要とする権限の名前。この属性は、1 つの権限で読み取りと書き込みの両方を設定する際に便利です。ただし、readPermission 属性と writePermission 属性の方がこの属性よりも優先されます。

android:readPermission

コンテンツ プロバイダに対してクエリを行う際にクライアントが必要とする権限。

android:writePermission

コンテンツ プロバイダが管理しているデータに変更を加える際にクライアントが必要とする権限。

導入時の API レベル:

API レベル 4

関連項目:

SearchManager

Manifest.permission

セキュリティに関するヒント