鴻蒙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)一資源標(biāo)識(shí)符 (URI) 對(duì)象。

標(biāo)準(zhǔn) URI 格式如下:

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

不需要解析不透明的 URI。它也可以是相對(duì) URI。 分層 URI 的標(biāo)準(zhǔn)格式如下:

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

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

[user-info@]host[:port]

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

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

方法總結(jié)

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

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

Builder

public Builder()

Method Detail

scheme

public Uri.Builder scheme(String scheme)

設(shè)置當(dāng)前 URI 的方案字段。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

decodedOpaqueSsp

public Uri.Builder decodedOpaqueSsp(String opaqueSsp)

將當(dāng)前不透明 URI 中的方案特定部分字段設(shè)置為被編碼但不被解析。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

encodedOpaqueSsp

public Uri.Builder encodedOpaqueSsp(String opaqueSsp)

將當(dāng)前不透明 URI 中的方案特定部分字段設(shè)置為不被解析。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

decodedAuthority

public Uri.Builder decodedAuthority(String authority)

設(shè)置當(dāng)前分層 URI 中權(quán)限字段的所有字符進(jìn)行編碼,包括 at 符號(hào) (@) 和冒號(hào) (:)。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

encodedAuthority

public Uri.Builder encodedAuthority(String authority)

設(shè)置當(dāng)前分層 URI 的權(quán)限字段。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

decodedPath

public Uri.Builder decodedPath(String path)

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

參數(shù):

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

返回:

返回 Builder 對(duì)象。

encodedPath

public Uri.Builder encodedPath(String path)

設(shè)置當(dāng)前分層 URI 的路徑字段。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

appendDecodedPath

public Uri.Builder appendDecodedPath(String path)

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

如果 URI 中的 path 字段沒(méi)有設(shè)置,這個(gè)添加的路徑將被作為絕對(duì)路徑處理。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

appendEncodedPath

public Uri.Builder appendEncodedPath(String path)

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

如果 URI 中的 path 字段沒(méi)有設(shè)置,這個(gè)添加的路徑將被作為絕對(duì)路徑處理。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

decodedQuery

public Uri.Builder decodedQuery(String query)

設(shè)置當(dāng)前分層 URI 中查詢字段的所有字符進(jìn)行編碼,包括問(wèn)號(hào) (?) 和等號(hào) (=)。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

encodedQuery

public Uri.Builder encodedQuery(String query)

設(shè)置當(dāng)前分層 URI 的查詢字段。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

appendDecodedQueryParam

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

將解碼后的查詢附加到當(dāng)前分層 URI。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

clearQuery

public Uri.Builder clearQuery()

清除當(dāng)前分層 URI 的查詢字段。

返回:

返回 Builder 對(duì)象。

decodedFragment

public Uri.Builder decodedFragment(String fragment)

設(shè)置要編碼的當(dāng)前 URI 中的片段字段的所有字符。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

encodedFragment

public Uri.Builder encodedFragment(String fragment)

設(shè)置當(dāng)前 URI 的片段字段。

參數(shù):

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

返回:

返回 Builder 對(duì)象。

build

public Uri build()

基于當(dāng)前的 Builder 對(duì)象創(chuàng)建一個(gè) Uri 實(shí)例。

返回:

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

Throws:

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

toString

public String toString()

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

重寫:

Object 類中的 toString

返回:

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

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)