android.net.Uri 簡介

public abstract class android.net.Uri extends Object implements Parcelable, Comparable<Uri>

Uri 的組成及示例

scheme://host:port/path?query
 

<scheme>://<authority><absolute path>?<query>#<fragment>

• 1）scheme：訪問資源的命名機制，通過這個可以獲悉Uri的具體資源存在形式，如http、content、file、market等
  
• 2）authority：存放資源的主機名。authority 應該是scheme:// 之後到第一次出現 ‘/’ 或‘?’ 或‘#’之間的string
  
• 3）path：authority之後第一個 ‘/’ 開始到 ‘?’ 或 ‘#’ 之前的string（包含‘/‘）
  
• 4）query：‘？‘ 號之後 ‘#‘ 號之前的string（類似get請求時的提交的參數）
  

打開一個網頁  http://blog.3gstdy.com/  
發送短信	smsto:10086
發送彩信（相當於發送帶附件的短信）	content://media/external/images/media/23
打開地圖並定位到一個點  geo:52.76,-79.0342  
撥打電話  tel:10086  
打開文件  file:///sdcard/download/everything.mp3  
打開發郵件界面  mailto:[email protected]  
尋找某個應用  market://search?q=pname:pkg_name  
顯示地圖（經緯度）	geo:39.9,116.3
路徑規劃  http://maps.google .com/maps?f=d&saddr=startLat%20startLng&daddr=endLat%20endLng&hl=en

<data android:host="string"
      android:mimeType="string"
      android:path="string"
      android:pathPattern="string"
      android:pathPrefix="string"
      android:port="string"
      android:scheme="string" />

get**和getEncoded**等方法的區別

for (int i = 0; i < bytesLength; i++) {  
    encoded.append(‘%‘);  
    encoded.append(HEX_DIGITS[(bytes[i] & 0xf0) >> 4]);  
    encoded.append(HEX_DIGITS[bytes[i] & 0xf]);  
}  

Uri uri = new Uri.Builder().path("包青天").build();
Log.i("bqt", uri.getPath() + "  " + uri.getEncodedPath());//包青天  %E5%8C%85%E9%9D%92%E5%A4%A9
Uri uri1 = new Uri.Builder().encodedPath("%E5%8C%85%E9%9D%92%E5%A4%A9").build();
Log.i("bqt", uri1.getPath() + "  " + uri1.getEncodedPath());//包青天  %E5%8C%85%E9%9D%92%E5%A4%A9
Uri uri2 = new Uri.Builder().path("bqt").build();
Log.i("bqt", uri2.getPath() + "  " + uri2.getEncodedPath());//bqt  bqt
Uri uri3 = new Uri.Builder().encodedPath("包青天").build();
Log.i("bqt", uri3.getPath() + "  " + uri3.getEncodedPath());//包青天  包青天

android.net.Uri【API】

• static String decode(String s) Decodes ‘%‘-escaped octets in the given string using the UTF-8 scheme.
  
• static String encode(String s, String allow) Encodes characters in the given string as ‘%‘-escaped octets using the UTF-8 scheme.
  
• static String encode(String s) Encodes characters in the given string as ‘%‘-escaped octets using the UTF-8 scheme.
  
• static Uri fromFile(File file) Creates a Uri from a file.
  
• static Uri fromParts(String scheme, String ssp, String fragment) Creates an opaque Uri from the given components.
  
• static Uri parse(String uriString) Creates a Uri which parses the given encoded URI string.
  
• static Uri withAppendedPath(Uri baseUri, String pathSegment) Creates a new Uri by appending an already-encoded path segment to a base Uri.

• String getQueryParameter(String key) Searches the query string for the first value with the given key.
  
• Set<String> getQueryParameterNames() Returns a set of the unique names of all query parameters.
  
• List<String> getQueryParameters(String key) Searches the query string for parameter values with the given key.
  
• boolean getBooleanQueryParameter(String key, boolean defaultValue) Searches the query string for the first value with the given key and interprets it as a boolean value.
  
• boolean isAbsolute() Returns true if this URI is absolute, i.e. if it contains an explicit明確的 scheme.
  
• boolean isOpaque() Returns true if this URI is opaque不透明的、模糊的 like "mailto:[email protected]".
  
• Uri normalizeScheme() Return an equivalent等價的 URI with a lowercase小寫的 scheme component組成. normalize：使正常化、使標準化
  

• abstract String getEncodedAuthority() Gets the encoded/decoded authority part of this URI.

• abstract String getEncodedFragment() Gets the encoded/decoded fragment part of this URI, everything after the ‘#‘.

• abstract String getEncodedPath() Gets the encoded/decoded path.

• abstract String getEncodedQuery() Gets the encoded/decoded query component from this URI.

• abstract String getHost() Gets the encoded host from the authority for this URI.

• abstract int getPort() Gets the port from the authority for this URI.

• abstract String getScheme() Gets the scheme of this URI. Example: "http"

• abstract String getEncodedUserInfo() Gets the encoded user information from the authority.
  

• abstract String getLastPathSegment() Gets the decoded last segment in the path.
  
• abstract List<String> getPathSegments() Gets the decoded path segments.
  

• abstract String getSchemeSpecificPart() Gets the scheme-specific part of this URI, i.e. everything between the scheme separator ‘:‘ and the fragment separator ‘#‘.
  
• abstract String getEncodedSchemeSpecificPart() Gets the scheme-specific part of this URI, i.e. everything between the scheme separator ‘:‘ and the fragment separator ‘#‘.
  

• abstract Uri.Builder buildUpon() Constructs a new builder, copying the attributes from this Uri.
• abstract boolean isHierarchical() Returns true if this URI is hierarchical like "http://google.com".
  
• abstract boolean isRelative() Returns true if this URI is relative, i.e. if it doesn‘t contain an explicit明確的 scheme.
  
• abstract String toString() Returns the encoded string representation of this URI.
  

Uri.Builder【文檔及API】

<scheme>://<authority><absolute path>?<query>#<fragment>

<relative or absolute path>?<query>#<fragment> 

//<authority><absolute path>?<query>#<fragment>

<scheme>:<opaque part>#<fragment>

• Uri build() Constructs a Uri with the current attributes.
  

• Uri.Builder authority(String authority) Encodes and sets the authority.
• Uri.Builder encodedAuthority(String authority) Sets the previously encoded authority.

• Uri.Builder path(String path) Sets the path.
  
• Uri.Builder encodedPath(String path) Sets the previously encoded path.
  
• Uri.Builder appendPath(String newSegment) Encodes the given segment and appends it to the path.
  
• Uri.Builder appendEncodedPath(String newSegment) Appends the given segment片段、分割 to the path.
  

• Uri.Builder query(String query) Encodes and sets the query.
  
• Uri.Builder encodedQuery(String query) Sets the previously encoded query.
  
• Uri.Builder appendQueryParameter(String key, String value) Encodes the key and value and then appends the parameter to the query string.
  
• Uri.Builder clearQuery() Clears the the previously set query.
  

• Uri.Builder scheme(String scheme) Sets the scheme.

• Uri.Builder fragment(String fragment) Encodes and sets the fragment.
  
• Uri.Builder encodedFragment(String fragment) Sets the previously encoded fragment.
  

• Uri.Builder opaquePart(String opaquePart) Encodes and sets the given opaque scheme-specific-part.
  
• Uri.Builder encodedOpaquePart(String opaquePart) Sets the previously encoded opaque scheme-specific-part.

android.net.Uri 簡介 API