java.lang.Object
|---ohos.utils.net.Uri.Builder
& public static final class Uri.Builder
& extends Object
快速构造统一资源标识符 (URI) 对象。
标准 URI 格式如下:
[scheme:]scheme-specific-part[#fragment]
不需要解析不透明的 URI。它也可以是相对 URI。 分层 URI 的标准格式如下:
<div >[scheme:][//authority][path][?query][#fragment]</div>
如果 URI 是服务器类型,则其权限字段可以按以下格式解析:
[user-info@]host[:port]
构造函数 | 描述 |
---|---|
Builder() |
修饰符和类型 | 方法 | 描述 |
---|---|---|
Uri.Builder | appendDecodedPath(Stringpath) | 将解码后的路径附加到当前分层 URI 中的现有路径。 |
Uri.Builder | appendDecodedQueryParam(Stringkey, Stringvalue) | 将解码后的查询附加到当前分层 URI。 |
Uri.Builder | appendEncodedPath(Stringpath) | 将编码路径附加到当前分层 URI 中的现有路径。 |
Uri | build() | 基于当前的 Builder 对象创建一个 Uri 实例。 |
Uri.Builder | clearQuery() | 清除当前分层 URI 的查询字段。 |
Uri.Builder | decodedAuthority(Stringauthority) | 设置当前分层 URI 中权限字段的所有字符进行编码,包括 at 符号 (@) 和冒号 (:)。 |
Uri.Builder | decodedFragment(Stringfragment) | 设置要编码的当前 URI 中的片段字段的所有字符。 |
Uri.Builder | decodedOpaqueSsp(StringopaqueSsp) | 将当前不透明 URI 中的方案特定部分字段设置为被编码但不被解析。 |
Uri.Builder | decodedPath(Stringpath) | 设置要编码的当前分层 URI 中路径字段的斜线 (/) 以外的字符。 |
Uri.Builder | decodedQuery(Stringquery) | 设置当前分层 URI 中查询字段的所有字符进行编码,包括问号 (?) 和等号 (=)。 |
Uri.Builder | encodedAuthority(Stringauthority) | 设置当前分层 URI 的权限字段。 |
Uri.Builder | encodedFragment(Stringfragment) | 设置当前 URI 的片段字段。 |
Uri.Builder | encodedOpaqueSsp(StringopaqueSsp) | 将当前不透明 URI 中的方案特定部分字段设置为不被解析。 |
Uri.Builder | encodedPath(Stringpath) | 设置当前分层 URI 的路径字段。 |
Uri.Builder | encodedQuery(Stringquery) | 设置当前分层 URI 的查询字段。 |
Uri.Builder | scheme(Stringscheme) | 设置当前 URI 的方案字段。 |
String | toString() | 获取通过 Builder 创建的 Uri 的字符串表示形式。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
public Builder()
public Uri.Builder scheme(String scheme)
设置当前 URI 的方案字段。
参数:
参数名称 | 参数描述 |
---|---|
scheme | 指示要设置的方案字段。 |
返回:
返回 Builder 对象。
public Uri.Builder decodedOpaqueSsp(String opaqueSsp)
将当前不透明 URI 中的方案特定部分字段设置为被编码但不被解析。
参数:
参数名称 | 参数描述 |
---|---|
opaqueSsp | 指示要为不透明 URI 设置的解码方案特定部分字段。 |
返回:
返回 Builder 对象。
public Uri.Builder encodedOpaqueSsp(String opaqueSsp)
将当前不透明 URI 中的方案特定部分字段设置为不被解析。
参数:
参数名称 | 参数描述 |
---|---|
opaqueSsp | 指示要为不透明 URI 设置的编码方案特定部分字段。 |
返回:
返回 Builder 对象。
public Uri.Builder decodedAuthority(String authority)
设置当前分层 URI 中权限字段的所有字符进行编码,包括 at 符号 (@) 和冒号 (:)。
参数:
参数名称 | 参数描述 |
---|---|
authority | 指示要为分层 URI 设置的解码权限字段。 |
返回:
返回 Builder 对象。
public Uri.Builder encodedAuthority(String authority)
设置当前分层 URI 的权限字段。
参数:
参数名称 | 参数描述 |
---|---|
authority | 指示要为分层 URI 设置的编码权限字段。 |
返回:
返回 Builder 对象。
public Uri.Builder decodedPath(String path)
设置要编码的当前分层 URI 中路径字段的斜线 (/) 以外的字符。
参数:
参数名称 | 参数描述 |
---|---|
path | 指示要为分层 URI 设置的解码路径字段。 |
返回:
返回 Builder 对象。
public Uri.Builder encodedPath(String path)
设置当前分层 URI 的路径字段。
参数:
参数名称 | 参数描述 |
---|---|
path | 指示要为分层 URI 设置的编码路径字段。 |
返回:
返回 Builder 对象。
public Uri.Builder appendDecodedPath(String path)
将解码后的路径附加到当前分层 URI 中的现有路径。
如果 URI 中的 path 字段没有设置,这个添加的路径将被作为绝对路径处理。
参数:
参数名称 | 参数描述 |
---|---|
path | 指示要附加到分层 URI 的解码路径。 路径不得以斜杠 (/) 开头。 |
返回:
返回 Builder 对象。
public Uri.Builder appendEncodedPath(String path)
将编码路径附加到当前分层 URI 中的现有路径。
如果 URI 中的 path 字段没有设置,这个添加的路径将被作为绝对路径处理。
参数:
参数名称 | 参数描述 |
---|---|
path | 指示要附加到分层 URI 的编码路径。 路径不得以斜杠 (/) 开头。 |
返回:
返回 Builder 对象。
public Uri.Builder decodedQuery(String query)
设置当前分层 URI 中查询字段的所有字符进行编码,包括问号 (?) 和等号 (=)。
参数:
参数名称 | 参数描述 |
---|---|
query | 指示要为分层 URI 设置的解码查询字段。 |
返回:
返回 Builder 对象。
public Uri.Builder encodedQuery(String query)
设置当前分层 URI 的查询字段。
参数:
参数名称 | 参数描述 |
---|---|
query | 指示要为分层 URI 设置的编码查询字段。 |
返回:
返回 Builder 对象。
public Uri.Builder appendDecodedQueryParam(String key, String value)
将解码后的查询附加到当前分层 URI。
参数:
参数名称 | 参数描述 |
---|---|
key | 指示解码查询的键。 |
value | 指示解码查询的值。 |
返回:
返回 Builder 对象。
public Uri.Builder clearQuery()
清除当前分层 URI 的查询字段。
返回:
返回 Builder 对象。
public Uri.Builder decodedFragment(String fragment)
设置要编码的当前 URI 中的片段字段的所有字符。
参数:
参数名称 | 参数描述 |
---|---|
fragment | 指示要为 URI 设置的解码片段字段。 |
返回:
返回 Builder 对象。
public Uri.Builder encodedFragment(String fragment)
设置当前 URI 的片段字段。
参数:
参数名称 | 参数描述 |
---|---|
fragment | 指示要为 URI 设置的编码片段字段。 |
返回:
返回 Builder 对象。
public Uri build()
基于当前的 Builder 对象创建一个 Uri 实例。
返回:
如果设置了 opaqueSsp 参数,则返回一个不透明的 URI; 否则返回分层 URI。
Throws:
Throw名称 | Throw描述 |
---|---|
UnsupportedOperationException | 如果 opaqueSsp 不为 null 但 scheme 为 null,则引发此异常。 |
public String toString()
获取通过 Builder 创建的 Uri 的字符串表示形式。
重写:
Object 类中的 toString
返回:
返回通过 Builder 创建的 Uri 的字符串表示形式。
备案信息: 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络,版权归原作者所有,仅作学习交流使用,如不慎侵犯了您的权利,请联系我们。