Android开发-API指南-<path-permission>

<path-permission>

英文原文：http://developer.android.com/guide/topics/manifest/path-permission-element.html
采集（更新）日期：2014-7-1
搬迁自原博客：http://blog.sina.com.cn/s/blog_48d491300100zmut.html

语法：

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

包含于：

<provider>

说明：

定义 Content Provider 内某个数据子集的路径和访问权限。 本元素可被多次定义，以便指定多个路径。

属性：

android:path

Content Provider 数据的某个子集的完整 URI 路径。 只会针对本路径标明的这部分数据进行授权。 如果 Content Provider 是用来提供搜索建议项的，则必须后跟“/search_suggest_query”。

android:pathPrefix

Content Provider 数据子集的 URI 路径的开头部分。 可以对所有以此为路径前缀的数据进行授权。

android:pathPattern

Content Provider 数据子集的完整URI路径，只是可使用以下通配符：

• 星号（“*”）。匹配紧随其前字符的0次或多次出现。
• 句点后跟星号（“.*”）。匹配任何字符的0次或多次出现。

从 XML 读取字符串时（在作为表达式被解析以前），''被用作转义字符，因此需要进行二次转义： 比如，'*' 应写成"\*" ， “” 应写成"\\" 。 这基本上和 Java 代码里构造字符串的写法相同。

关于这三种表达式的更多信息，请参阅 PatternMatcher 类中的 PATTERN_LITERAL、 PATTERN_PREFIX 和 PATTERN_SIMPLE_GLOB 的说明。

android:permission

客户端要读写 Content Provider 的数据而必须具有的权限名称。 本属性为同时设置读和写权限提供了一种简便途径。 不过， readPermission 、 writePermission 属性可以覆盖本设置。

android:readPermission

客户端要查询 Content Provider 的数据而必须具有的权限。

android:writePermission

客户端要修改 Content Provider 所控制的数据而必须具有的权限。

引入自：

API 级别 4

参阅：

SearchManager

Manifest.permission

安全和权限