Uri
abstract class Uri : Comparable<Uri!>, Parcelable
| kotlin.Any | |
| ↳ | android.net.Uri |
Immutable URI reference. A URI reference includes a URI and a fragment, the component of the URI following a '#'. Builds and parses URI references which conform to RFC 2396.
In the interest of performance, this class performs little to no validation. Behavior is undefined for invalid input. This class is very forgiving--in the face of invalid input, it will return garbage rather than throw an exception unless otherwise specified.
Summary
| Nested classes | |
|---|---|
|
Helper class for building or manipulating URI references. |
|
| Inherited constants | |
|---|---|
| Public methods | |
|---|---|
| abstract Uri.Builder! |
Constructs a new builder, copying the attributes from this Uri. |
| open Int |
Compares the string representation of this Uri with that of another. |
| open static String! |
Decodes '%'-escaped octets in the given string using the UTF-8 scheme. |
| open static String! |
Encodes characters in the given string as '%'-escaped octets using the UTF-8 scheme. |
| open static String! |
Encodes characters in the given string as '%'-escaped octets using the UTF-8 scheme. |
| open Boolean |
Compares this Uri to another object for equality. |
| open static Uri! |
Creates a Uri from a file. |
| open static Uri! |
Creates an opaque Uri from the given components. |
| abstract String? |
Gets the decoded authority part of this URI. |
| open Boolean |
getBooleanQueryParameter(key: String!, defaultValue: Boolean)Searches the query string for the first value with the given key and interprets it as a boolean value. |
| abstract String? |
Gets the encoded authority part of this URI. |
| abstract String? |
Gets the encoded fragment part of this URI, everything after the '#'. |
| abstract String? |
Gets the encoded path. |
| abstract String? |
Gets the encoded query component from this URI. |
| abstract String! |
Gets the scheme-specific part of this URI, i. |
| abstract String? |
Gets the encoded user information from the authority. |
| abstract String? |
Gets the decoded fragment part of this URI, everything after the '#'. |
| abstract String? |
getHost()Gets the encoded host from the authority for this URI. |
| abstract String? |
Gets the decoded last segment in the path. |
| abstract String? |
getPath()Gets the decoded path. |
| abstract MutableList<String!>! |
Gets the decoded path segments. |
| abstract Int |
getPort()Gets the port from the authority for this URI. |
| abstract String? |
getQuery()Gets the decoded query component from this URI. |
| open String? |
getQueryParameter(key: String!)Searches the query string for the first value with the given key. |
| open MutableSet<String!>! |
Returns a set of the unique names of all query parameters. |
| open MutableList<String!>! |
getQueryParameters(key: String!)Searches the query string for parameter values with the given key. |
| abstract String? |
Gets the scheme of this URI. |
| abstract String! |
Gets the scheme-specific part of this URI, i. |
| abstract String? |
Gets the decoded user information from the authority. |
| open Int |
hashCode()Hashes the encoded string represention of this Uri consistently with |
| open Boolean |
Returns true if this URI is absolute, i. |
| abstract Boolean |
Returns true if this URI is hierarchical like "http://google. |
| open Boolean |
isOpaque()Returns true if this URI is opaque like "mailto:nobody@google. |
| abstract Boolean |
Returns true if this URI is relative, i. |
| open Uri! |
Return an equivalent URI with a lowercase scheme component. |
| open static Uri! |
Creates a Uri which parses the given encoded URI string. |
| abstract String |
toString()Returns the encoded string representation of this URI. |
| open static Uri! |
withAppendedPath(baseUri: Uri!, pathSegment: String!)Creates a new Uri by appending an already-encoded path segment to a base Uri. |
| open static Unit |
writeToParcel(out: Parcel!, uri: Uri!)Writes a Uri to a Parcel. |
| Inherited functions | |
|---|---|
| Properties | |
|---|---|
| static Parcelable.Creator<Uri!> |
Reads Uris from Parcels. |
| static Uri! |
The empty URI, equivalent to "". |
Public methods
buildUpon
abstract fun buildUpon(): Uri.Builder!
Constructs a new builder, copying the attributes from this Uri.
compareTo
open fun compareTo(other: Uri!): Int
Compares the string representation of this Uri with that of another.
| Parameters | |
|---|---|
o |
the object to be compared. |
| Return | |
|---|---|
Int |
a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object. |
| Exceptions | |
|---|---|
java.lang.NullPointerException |
if the specified object is null |
java.lang.ClassCastException |
if the specified object's type prevents it from being compared to this object. |
decode
open static fun decode(s: String!): String!
Decodes '%'-escaped octets in the given string using the UTF-8 scheme. Replaces invalid octets with the unicode replacement character ("\\uFFFD").
| Parameters | |
|---|---|
s |
String!: encoded string to decode |
| Return | |
|---|---|
String! |
the given string with escaped octets decoded, or null if s is null |
encode
open static fun encode(s: String!): String!
Encodes characters in the given string as '%'-escaped octets using the UTF-8 scheme. Leaves letters ("A-Z", "a-z"), numbers ("0-9"), and unreserved characters ("_-!.~'()*") intact. Encodes all other characters.
| Parameters | |
|---|---|
s |
String!: string to encode |
| Return | |
|---|---|
String! |
an encoded version of s suitable for use as a URI component, or null if s is null |
encode
open static fun encode(
s: String!,
allow: String!
): String!
Encodes characters in the given string as '%'-escaped octets using the UTF-8 scheme. Leaves letters ("A-Z", "a-z"), numbers ("0-9"), and unreserved characters ("_-!.~'()*") intact. Encodes all other characters with the exception of those specified in the allow argument.
| Parameters | |
|---|---|
s |
String!: string to encode |
allow |
String!: set of additional characters to allow in the encoded form, null if no characters should be skipped |
| Return | |
|---|---|
String! |
an encoded version of s suitable for use as a URI component, or null if s is null |
equals
open fun equals(other: Any?): Boolean
Compares this Uri to another object for equality. Returns true if the encoded string representations of this Uri and the given Uri are equal. Case counts. Paths are not normalized. If one Uri specifies a default port explicitly and the other leaves it implicit, they will not be considered equal.
| Parameters | |
|---|---|
obj |
the reference object with which to compare. |
o |
This value may be null. |
| Return | |
|---|---|
Boolean |
true if this object is the same as the obj argument; false otherwise. |
fromFile
open static fun fromFile(file: File!): Uri!
Creates a Uri from a file. The URI has the form "file://". Encodes path characters with the exception of '/'.
Example: "file:///tmp/android.txt"
| Return | |
|---|---|
Uri! |
a Uri for the given file |
| Exceptions | |
|---|---|
java.lang.NullPointerException |
if file is null |
fromParts
open static fun fromParts(
scheme: String!,
ssp: String!,
fragment: String!
): Uri!
Creates an opaque Uri from the given components. Encodes the ssp which means this method cannot be used to create hierarchical URIs.
| Parameters | |
|---|---|
scheme |
String!: of the URI |
ssp |
String!: scheme-specific-part, everything between the scheme separator (':') and the fragment separator ('#'), which will get encoded |
fragment |
String!: fragment, everything after the '#', null if undefined, will get encoded |
| Return | |
|---|---|
Uri! |
Uri composed of the given scheme, ssp, and fragment |
| Exceptions | |
|---|---|
java.lang.NullPointerException |
if scheme or ssp is null |
See Also
getAuthority
abstract fun getAuthority(): String?
Gets the decoded authority part of this URI. For server addresses, the authority is structured as follows: [ userinfo '@' ] host [ ':' port ]
Examples: "google.com", "bob@google.com:80"
| Return | |
|---|---|
String? |
the authority for this URI or null if not present |
getBooleanQueryParameter
open fun getBooleanQueryParameter(
key: String!,
defaultValue: Boolean
): Boolean
Searches the query string for the first value with the given key and interprets it as a boolean value. "false" and "0" are interpreted as false, everything else is interpreted as true.
| Parameters | |
|---|---|
key |
String!: which will be decoded |
defaultValue |
Boolean: the default value to return if there is no query parameter for key |
| Return | |
|---|---|
Boolean |
the boolean interpretation of the query parameter key |
getEncodedAuthority
abstract fun getEncodedAuthority(): String?
Gets the encoded authority part of this URI. For server addresses, the authority is structured as follows: [ userinfo '@' ] host [ ':' port ]
Examples: "google.com", "bob@google.com:80"
| Return | |
|---|---|
String? |
the authority for this URI or null if not present |
getEncodedFragment
abstract fun getEncodedFragment(): String?
Gets the encoded fragment part of this URI, everything after the '#'.
| Return | |
|---|---|
String? |
the encoded fragment or null if there isn't one |
getEncodedPath
abstract fun getEncodedPath(): String?
Gets the encoded path.
| Return | |
|---|---|
String? |
the encoded path, or null if this is not a hierarchical URI (like "mailto:nobody@google.com") or the URI is invalid |
getEncodedQuery
abstract fun getEncodedQuery(): String?
Gets the encoded query component from this URI. The query comes after the query separator ('?') and before the fragment separator ('#'). This method would return "q=android" for "http://www.google.com/search?q=android".
| Return | |
|---|---|
String? |
the encoded query or null if there isn't one |
getEncodedSchemeSpecificPart
abstract fun getEncodedSchemeSpecificPart(): String!
Gets the scheme-specific part of this URI, i.e. everything between the scheme separator ':' and the fragment separator '#'. If this is a relative URI, this method returns the entire URI. Leaves escaped octets intact.
Example: "//www.google.com/search?q=android"
| Return | |
|---|---|
String! |
the encoded scheme-specific-part |
getEncodedUserInfo
abstract fun getEncodedUserInfo(): String?
Gets the encoded user information from the authority. For example, if the authority is "nobody@google.com", this method will return "nobody".
| Return | |
|---|---|
String? |
the user info for this URI or null if not present |
getFragment
abstract fun getFragment(): String?
Gets the decoded fragment part of this URI, everything after the '#'.
| Return | |
|---|---|
String? |
the decoded fragment or null if there isn't one |
getHost
abstract fun getHost(): String?
Gets the encoded host from the authority for this URI. For example, if the authority is "bob@google.com", this method will return "google.com".
| Return | |
|---|---|
String? |
the host for this URI or null if not present |
getLastPathSegment
abstract fun getLastPathSegment(): String?
Gets the decoded last segment in the path.
| Return | |
|---|---|
String? |
the decoded last segment or null if the path is empty |
getPath
abstract fun getPath(): String?
Gets the decoded path.
| Return | |
|---|---|
String? |
the decoded path, or null if this is not a hierarchical URI (like "mailto:nobody@google.com") or the URI is invalid |
getPathSegments
abstract fun getPathSegments(): MutableList<String!>!
Gets the decoded path segments.
| Return | |
|---|---|
MutableList<String!>! |
decoded path segments, each without a leading or trailing '/' |
getPort
abstract fun getPort(): Int
Gets the port from the authority for this URI. For example, if the authority is "google.com:80", this method will return 80.
| Return | |
|---|---|
Int |
the port for this URI or -1 if invalid or not present |
getQuery
abstract fun getQuery(): String?
Gets the decoded query component from this URI. The query comes after the query separator ('?') and before the fragment separator ('#'). This method would return "q=android" for "http://www.google.com/search?q=android".
| Return | |
|---|---|
String? |
the decoded query or null if there isn't one |
getQueryParameter
open fun getQueryParameter(key: String!): String?
Searches the query string for the first value with the given key.
Warning: Prior to Jelly Bean, this decoded the '+' character as '+' rather than ' '.
| Parameters | |
|---|---|
key |
String!: which will be encoded |
| Return | |
|---|---|
String? |
the decoded value or null if no parameter is found |
| Exceptions | |
|---|---|
java.lang.UnsupportedOperationException |
if this isn't a hierarchical URI |
java.lang.NullPointerException |
if key is null |
getQueryParameterNames
open fun getQueryParameterNames(): MutableSet<String!>!
Returns a set of the unique names of all query parameters. Iterating over the set will return the names in order of their first occurrence.
| Return | |
|---|---|
MutableSet<String!>! |
a set of decoded names |
| Exceptions | |
|---|---|
java.lang.UnsupportedOperationException |
if this isn't a hierarchical URI |
getQueryParameters
open fun getQueryParameters(key: String!): MutableList<String!>!
Searches the query string for parameter values with the given key.
| Parameters | |
|---|---|
key |
String!: which will be encoded |
| Return | |
|---|---|
MutableList<String!>! |
a list of decoded values |
| Exceptions | |
|---|---|
java.lang.UnsupportedOperationException |
if this isn't a hierarchical URI |
java.lang.NullPointerException |
if key is null |
getScheme
abstract fun getScheme(): String?
Gets the scheme of this URI. Example: "http"
| Return | |
|---|---|
String? |
the scheme or null if this is a relative URI |
getSchemeSpecificPart
abstract fun getSchemeSpecificPart(): String!
Gets the scheme-specific part of this URI, i.e. everything between the scheme separator ':' and the fragment separator '#'. If this is a relative URI, this method returns the entire URI. Decodes escaped octets.
Example: "//www.google.com/search?q=android"
| Return | |
|---|---|
String! |
the decoded scheme-specific-part |
getUserInfo
abstract fun getUserInfo(): String?
Gets the decoded user information from the authority. For example, if the authority is "nobody@google.com", this method will return "nobody".
| Return | |
|---|---|
String? |
the user info for this URI or null if not present |
hashCode
open fun hashCode(): Int
Hashes the encoded string represention of this Uri consistently with equals(java.lang.Object).
| Return | |
|---|---|
Int |
a hash code value for this object. |
isAbsolute
open fun isAbsolute(): Boolean
Returns true if this URI is absolute, i.e. if it contains an explicit scheme.
| Return | |
|---|---|
Boolean |
true if this URI is absolute, false if it's relative |
isHierarchical
abstract fun isHierarchical(): Boolean
Returns true if this URI is hierarchical like "http://google.com". Absolute URIs are hierarchical if the scheme-specific part starts with a '/'. Relative URIs are always hierarchical.
isOpaque
open fun isOpaque(): Boolean
Returns true if this URI is opaque like "mailto:nobody@google.com". The scheme-specific part of an opaque URI cannot start with a '/'.
isRelative
abstract fun isRelative(): Boolean
Returns true if this URI is relative, i.e. if it doesn't contain an explicit scheme.
| Return | |
|---|---|
Boolean |
true if this URI is relative, false if it's absolute |
normalizeScheme
open fun normalizeScheme(): Uri!
Return an equivalent URI with a lowercase scheme component. This aligns the Uri with Android best practices for intent filtering.
For example, "HTTP://www.android.com" becomes "http://www.android.com"
All URIs received from outside Android (such as user input, or external sources like Bluetooth, NFC, or the Internet) should be normalized before they are used to create an Intent.
This method does not validate bad URIs, or 'fix' poorly formatted URIs - so do not use it for input validation. A Uri will always be returned, even if the Uri is badly formatted to begin with and a scheme component cannot be found.
| Return | |
|---|---|
Uri! |
normalized Uri (never null) |
parse
open static fun parse(uriString: String!): Uri!
Creates a Uri which parses the given encoded URI string.
| Parameters | |
|---|---|
uriString |
String!: an RFC 2396-compliant, encoded URI |
| Return | |
|---|---|
Uri! |
Uri for this given uri string |
| Exceptions | |
|---|---|
java.lang.NullPointerException |
if uriString is null |
toString
abstract fun toString(): String
Returns the encoded string representation of this URI. Example: "http://google.com/"
| Return | |
|---|---|
String |
a string representation of the object. |
withAppendedPath
open static fun withAppendedPath(
baseUri: Uri!,
pathSegment: String!
): Uri!
Creates a new Uri by appending an already-encoded path segment to a base Uri.
| Parameters | |
|---|---|
baseUri |
Uri!: Uri to append path segment to |
pathSegment |
String!: encoded path segment to append |
| Return | |
|---|---|
Uri! |
a new Uri based on baseUri with the given segment appended to the path |
| Exceptions | |
|---|---|
java.lang.NullPointerException |
if baseUri is null |
writeToParcel
open static fun writeToParcel(
out: Parcel!,
uri: Uri!
): Unit
Writes a Uri to a Parcel.
| Parameters | |
|---|---|
out |
Parcel!: parcel to write to |
uri |
Uri!: to write, can be null |