構文:
<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_LITERALPATTERN_PREFIXPATTERN_SIMPLE_GLOB の説明をご覧ください。

android:permission
コンテンツ プロバイダのデータを読み書きする際にクライアントが必要とする権限の名前。この属性は、1 つの権限で読み取りと書き込みの両方を設定する際に便利です。ただし、readPermission 属性と writePermission 属性の方がこの属性よりも優先されます。
android:readPermission
コンテンツ プロバイダに対してクエリを行う際にクライアントが必要とする権限。
android:writePermission
コンテンツ プロバイダが管理しているデータに変更を加える際にクライアントが必要とする権限。
導入時の API レベル:
API レベル 4
関連項目:
SearchManager
Manifest.permission
セキュリティに関するヒント