public static final class Uri.Builder
extends Object
| java.lang.Object | |
| android.net.Uri.Builder | |
帮助程序类用于构建或操作URI引用。 并行使用不安全。
绝对层次URI引用遵循以下模式: <scheme>://<authority><absolute path>?<query>#<fragment>
相对URI引用(始终是分层结构)遵循以下两种模式之一: <relative or absolute path>?<query>#<fragment>或 //<authority><absolute path>?<query>#<fragment>
一个不透明的URI遵循这种模式: <scheme>:<opaque part>#<fragment>
使用 buildUpon()获取表示现有URI的构建器。
Public constructors |
|
|---|---|
Uri.Builder() 构建一个新的Builder。 |
|
公共方法(Public methods) |
|
|---|---|
Uri.Builder |
appendEncodedPath(String newSegment) 将给定的段添加到路径中。 |
Uri.Builder |
appendPath(String newSegment) 对给定的段进行编码并将其附加到路径中。 |
Uri.Builder |
appendQueryParameter(String key, String value) 对键和值进行编码,然后将该参数附加到查询字符串。 |
Uri.Builder |
authority(String authority) 编码并设置权限。 |
Uri |
build() 用当前属性构造一个Uri。 |
Uri.Builder |
clearQuery() 清除先前设置的查询。 |
Uri.Builder |
encodedAuthority(String authority) 设置先前编码的权限。 |
Uri.Builder |
encodedFragment(String fragment) 设置先前编码的片段。 |
Uri.Builder |
encodedOpaquePart(String opaquePart) 设置先前编码的不透明方案特定部分。 |
Uri.Builder |
encodedPath(String path) 设置以前编码的路径。 |
Uri.Builder |
encodedQuery(String query) 设置先前编码的查询。 |
Uri.Builder |
fragment(String fragment) 编码并设置片段。 |
Uri.Builder |
opaquePart(String opaquePart) 编码并设置给定的不透明方案特定部分。 |
Uri.Builder |
path(String path) 设置路径。 |
Uri.Builder |
query(String query) 编码并设置查询。 |
Uri.Builder |
scheme(String scheme) 设置方案。 |
String |
toString() 返回对象的字符串表示形式。 |
继承方法(Inherited methods) |
|
|---|---|
java.lang.Object
|
|
Uri.Builder appendEncodedPath (String newSegment)
将给定的段添加到路径中。
| 参数(Parameters) | |
|---|---|
newSegment |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder appendPath (String newSegment)
对给定的段进行编码并将其附加到路径中。
| 参数(Parameters) | |
|---|---|
newSegment |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder appendQueryParameter (String key, String value)
对键和值进行编码,然后将该参数附加到查询字符串。
| 参数(Parameters) | |
|---|---|
key |
String: which will be encoded |
value |
String: which will be encoded |
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder authority (String authority)
编码并设置权限。
| 参数(Parameters) | |
|---|---|
authority |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri build ()
用当前属性构造一个Uri。
| 返回(Returns) | |
|---|---|
Uri |
|
| 抛出异常(Throws) | |
|---|---|
UnsupportedOperationException |
if the URI is opaque and the scheme is null |
Uri.Builder encodedAuthority (String authority)
设置先前编码的权限。
| 参数(Parameters) | |
|---|---|
authority |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder encodedFragment (String fragment)
设置先前编码的片段。
| 参数(Parameters) | |
|---|---|
fragment |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder encodedOpaquePart (String opaquePart)
设置先前编码的不透明方案特定部分。
| 参数(Parameters) | |
|---|---|
opaquePart |
String: encoded opaque part |
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder encodedPath (String path)
设置以前编码的路径。
如果路径不为空并且不以'/'开始,并且您指定了方案和/或权限,那么构建器将用'/'预先给定路径。
| 参数(Parameters) | |
|---|---|
path |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder encodedQuery (String query)
设置先前编码的查询。
| 参数(Parameters) | |
|---|---|
query |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder fragment (String fragment)
编码并设置片段。
| 参数(Parameters) | |
|---|---|
fragment |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder opaquePart (String opaquePart)
编码并设置给定的不透明方案特定部分。
| 参数(Parameters) | |
|---|---|
opaquePart |
String: decoded opaque part |
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder path (String path)
设置路径。 留下'/'字符完整,但必要时编码其他字符。
如果路径不为空并且不以'/'开始,并且您指定了方案和/或权限,那么构建器将用'/'预先给定路径。
| 参数(Parameters) | |
|---|---|
path |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder query (String query)
编码并设置查询。
| 参数(Parameters) | |
|---|---|
query |
String
|
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
Uri.Builder scheme (String scheme)
设置方案。
| 参数(Parameters) | |
|---|---|
scheme |
String: name or null if this is a relative Uri |
| 返回(Returns) | |
|---|---|
Uri.Builder |
|
String toString ()
返回对象的字符串表示形式。 一般而言, toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object的toString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
| 返回(Returns) | |
|---|---|
String |
a string representation of the object. |