grant-uri-permission

SYNTAX:

<grant-uri-permission android:path="string"                      android:pathPattern="string"                      android:pathPrefix="string" />

CONTAINED IN:

<provider>

DESCRIPTION:

Specifies which data subsets of the parent content provider permission can be granted for. Data subsets are indicated by the path part of a content: URI. (The authority part of the URI identifies the content provider.) Granting permission is a way of enabling clients of the provider that don't normally have permission to access its data to overcome that restriction on a one-time basis.

If a content provider's grantUriPermissions attribute is "true", permission can be granted for any the data under the provider's purview. However, if that attribute is "false", permission can be granted only to data subsets that are specified by this element. A provider can contain any number of <grant-uri-permission> elements. Each one can specify only one path (only one of the three possible attributes).

For information on how permission is granted, see the <intent-filter> element'sgrantUriPermissions attribute.

ATTRIBUTES:

android:path 
android:pathPrefix 
android:pathPattern

A path identifying the data subset or subsets that permission can be granted for. The pathattribute specifies a complete path; permission can be granted only to the particular data subset identified by that path. The pathPrefix attribute specifies the initial part of a path; permission can be granted to all data subsets with paths that share that initial part. The pathPattern attribute specifies a complete path, but one that can contain the following wildcards:

• An asterisk ('*') matches a sequence of 0 to many occurrences of the immediately preceding character.

• A period followed by an asterisk (".*") matches any sequence of 0 to many characters.

Because '\' is used as an escape character when the string is read from XML (before it is parsed as a pattern), you will need to double-escape: For example, a literal '*' would be written as "\\*" and a literal '\' would be written as "\\\\". This is basically the same as what you would need to write if constructing the string in Java code.

For more information on these types of patterns, see the descriptions of PATTERN_LITERAL,PATTERN_PREFIX, and PATTERN_SIMPLE_GLOB in the PatternMatcher class.

INTRODUCED IN:

API Level 1

SEE ALSO:

the grantUriPermissions attribute of the <provider> element

句法：

<赠款URI的权限 机器人：路径 = “ 字符串 ”                       机器人：pathPattern = “ 串 ”                       的android：pathPrefix = “ 字符串 ”  />

包含在：

<提供商>

描述：

指定哪个父内容提供商许可的数据子集可以被授予。数据子集是由的路径部分指示 内容： URI。（URI的授权部分标识内容提供商。）授予的权限是使那些通常没有权限访问其数据，克服一次性基础上，该限制供应商的客户的一种方式。

如果内容提供者的grantUriPermissions 属性为“ 真 ”，权限可以授予任何提供者的权限下的数据。但是，如果该属性是“ 假 ”，许可可以仅由该元素指定的数据的子集授权。提供者可以包含任意数量的<赠款URI的权限>元素。每一个可以指定只有一条路径（只有三种可能的属性之一）。

有关权限如何授予信息，请参阅 <意图过滤器>元素的 grantUriPermissions属性。

属性：

机器人：路径 
的android：pathPrefix 
机器人：pathPattern

路径识别数据集或子集的权限可授予。该路径属性指定一个完整的路径; 许可只能由该路径标识的特定数据集授予。所述pathPrefix属性指定的路径的初始部分; 权限可授予与共享，最初的部分路径的所有数据子集。该pathPattern属性指定一个完整的路径，而是一个可以包含以下通配符：

• 星号（“ * ”）匹配的0到紧接在前面的字符的许多事件的序列。

• 一个时期后跟一个星号（“ * ”）匹配的0至多个字符的任意序列。

因为' \ '作为当字符串从XML读取（之前被解析为一个模式）转义字符，则需要仔细逃生：例如，一个字面' * '会被写成“ \\ * “与字面' \ '会被写成” \\\\ “。这基本上是一样的，你需要建造，如果在Java代码中的字符串写什么。

有关这些类型的模式的更多信息，请参阅的说明 PATTERN_LITERAL， PATTERN_PREFIX和PATTERN_SIMPLE_GLOB在 PatternMatcher类。

介绍了：

API级别1

也可以看看：

该 grantUriPermissions 的属性 <提供商> 元素