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 |
|
---|---|
From class 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. |