鴻蒙OS Uri.Builder

2022-04-12 17:11 更新

Uri.Builder

java.lang.Object

|---ohos.utils.net.Uri.Builder

& public static final class Uri.Builder
& extends Object

快速構(gòu)造統(tǒng)一資源標識符 (URI) 對象。

標準 URI 格式如下:

[scheme:]scheme-specific-part[#fragment]

不需要解析不透明的 URI。它也可以是相對 URI。 分層 URI 的標準格式如下:

<div style='display: none'>[scheme:][//authority][path][?query][#fragment]</div>

如果 URI 是服務器類型,則其權(quán)限字段可以按以下格式解析:

[user-info@]host[:port]

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù) 描述
Builder()

方法總結(jié)

修飾符和類型 方法 描述
Uri.Builder appendDecodedPath(String path) 將解碼后的路徑附加到當前分層 URI 中的現(xiàn)有路徑。
Uri.Builder appendDecodedQueryParam(String key, String value) 將解碼后的查詢附加到當前分層 URI。
Uri.Builder appendEncodedPath(String path) 將編碼路徑附加到當前分層 URI 中的現(xiàn)有路徑。
Uri build() 基于當前的 Builder 對象創(chuàng)建一個 Uri 實例。
Uri.Builder clearQuery() 清除當前分層 URI 的查詢字段。
Uri.Builder decodedAuthority(String authority) 設置當前分層 URI 中權(quán)限字段的所有字符進行編碼,包括 at 符號 (@) 和冒號 (:)。
Uri.Builder decodedFragment(String fragment) 設置要編碼的當前 URI 中的片段字段的所有字符。
Uri.Builder decodedOpaqueSsp(String opaqueSsp) 將當前不透明 URI 中的方案特定部分字段設置為被編碼但不被解析。
Uri.Builder decodedPath(String path) 設置要編碼的當前分層 URI 中路徑字段的斜線 (/) 以外的字符。
Uri.Builder decodedQuery(String query) 設置當前分層 URI 中查詢字段的所有字符進行編碼,包括問號 (?) 和等號 (=)。
Uri.Builder encodedAuthority(String authority) 設置當前分層 URI 的權(quán)限字段。
Uri.Builder encodedFragment(String fragment) 設置當前 URI 的片段字段。
Uri.Builder encodedOpaqueSsp(String opaqueSsp) 將當前不透明 URI 中的方案特定部分字段設置為不被解析。
Uri.Builder encodedPath(String path) 設置當前分層 URI 的路徑字段。
Uri.Builder encodedQuery(String query) 設置當前分層 URI 的查詢字段。
Uri.Builder scheme(String scheme) 設置當前 URI 的方案字段。
String toString() 獲取通過 Builder 創(chuàng)建的 Uri 的字符串表示形式。
從類 java.lang.Object 繼承的方法
cloneequalsfinalizegetClasshashCodenotifynotifyAllwaitwaitwait

構(gòu)造函數(shù)詳細信息

Builder

public Builder()

Method Detail

scheme

public Uri.Builder scheme(String scheme)

設置當前 URI 的方案字段。

參數(shù):

參數(shù)名稱 參數(shù)描述
scheme 指示要設置的方案字段。

返回:

返回 Builder 對象。

decodedOpaqueSsp

public Uri.Builder decodedOpaqueSsp(String opaqueSsp)

將當前不透明 URI 中的方案特定部分字段設置為被編碼但不被解析。

參數(shù):

參數(shù)名稱 參數(shù)描述
opaqueSsp 指示要為不透明 URI 設置的解碼方案特定部分字段。

返回:

返回 Builder 對象。

encodedOpaqueSsp

public Uri.Builder encodedOpaqueSsp(String opaqueSsp)

將當前不透明 URI 中的方案特定部分字段設置為不被解析。

參數(shù):

參數(shù)名稱 參數(shù)描述
opaqueSsp 指示要為不透明 URI 設置的編碼方案特定部分字段。

返回:

返回 Builder 對象。

decodedAuthority

public Uri.Builder decodedAuthority(String authority)

設置當前分層 URI 中權(quán)限字段的所有字符進行編碼,包括 at 符號 (@) 和冒號 (:)。

參數(shù):

參數(shù)名稱 參數(shù)描述
authority 指示要為分層 URI 設置的解碼權(quán)限字段。

返回:

返回 Builder 對象。

encodedAuthority

public Uri.Builder encodedAuthority(String authority)

設置當前分層 URI 的權(quán)限字段。

參數(shù):

參數(shù)名稱 參數(shù)描述
authority 指示要為分層 URI 設置的編碼權(quán)限字段。

返回:

返回 Builder 對象。

decodedPath

public Uri.Builder decodedPath(String path)

設置要編碼的當前分層 URI 中路徑字段的斜線 (/) 以外的字符。

參數(shù):

參數(shù)名稱 參數(shù)描述
path 指示要為分層 URI 設置的解碼路徑字段。

返回:

返回 Builder 對象。

encodedPath

public Uri.Builder encodedPath(String path)

設置當前分層 URI 的路徑字段。

參數(shù):

參數(shù)名稱 參數(shù)描述
path 指示要為分層 URI 設置的編碼路徑字段。

返回:

返回 Builder 對象。

appendDecodedPath

public Uri.Builder appendDecodedPath(String path)

將解碼后的路徑附加到當前分層 URI 中的現(xiàn)有路徑。

如果 URI 中的 path 字段沒有設置,這個添加的路徑將被作為絕對路徑處理。

參數(shù):

參數(shù)名稱 參數(shù)描述
path 指示要附加到分層 URI 的解碼路徑。 路徑不得以斜杠 (/) 開頭。

返回:

返回 Builder 對象。

appendEncodedPath

public Uri.Builder appendEncodedPath(String path)

將編碼路徑附加到當前分層 URI 中的現(xiàn)有路徑。

如果 URI 中的 path 字段沒有設置,這個添加的路徑將被作為絕對路徑處理。

參數(shù):

參數(shù)名稱 參數(shù)描述
path 指示要附加到分層 URI 的編碼路徑。 路徑不得以斜杠 (/) 開頭。

返回:

返回 Builder 對象。

decodedQuery

public Uri.Builder decodedQuery(String query)

設置當前分層 URI 中查詢字段的所有字符進行編碼,包括問號 (?) 和等號 (=)。

參數(shù):

參數(shù)名稱 參數(shù)描述
query 指示要為分層 URI 設置的解碼查詢字段。

返回:

返回 Builder 對象。

encodedQuery

public Uri.Builder encodedQuery(String query)

設置當前分層 URI 的查詢字段。

參數(shù):

參數(shù)名稱 參數(shù)描述
query 指示要為分層 URI 設置的編碼查詢字段。

返回:

返回 Builder 對象。

appendDecodedQueryParam

public Uri.Builder appendDecodedQueryParam(String key, String value)

將解碼后的查詢附加到當前分層 URI。

參數(shù):

參數(shù)名稱 參數(shù)描述
key 指示解碼查詢的鍵。
value 指示解碼查詢的值。

返回:

返回 Builder 對象。

clearQuery

public Uri.Builder clearQuery()

清除當前分層 URI 的查詢字段。

返回:

返回 Builder 對象。

decodedFragment

public Uri.Builder decodedFragment(String fragment)

設置要編碼的當前 URI 中的片段字段的所有字符。

參數(shù):

參數(shù)名稱 參數(shù)描述
fragment 指示要為 URI 設置的解碼片段字段。

返回:

返回 Builder 對象。

encodedFragment

public Uri.Builder encodedFragment(String fragment)

設置當前 URI 的片段字段。

參數(shù):

參數(shù)名稱 參數(shù)描述
fragment 指示要為 URI 設置的編碼片段字段。

返回:

返回 Builder 對象。

build

public Uri build()

基于當前的 Builder 對象創(chuàng)建一個 Uri 實例。

返回:

如果設置了 opaqueSsp 參數(shù),則返回一個不透明的 URI; 否則返回分層 URI。

Throws:

Throw名稱 Throw描述
UnsupportedOperationException 如果 opaqueSsp 不為 null 但 scheme 為 null,則引發(fā)此異常。

toString

public String toString()

獲取通過 Builder 創(chuàng)建的 Uri 的字符串表示形式。

重寫:

Object 類中的 toString

返回:

返回通過 Builder 創(chuàng)建的 Uri 的字符串表示形式。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號