Url

class Url : Uri

Types

Builder

class Builder(uriBuilder: Uri.Builder = Uri.Builder()) : UrlBuilder, Builder

Helper class for building or manipulating URL references. Not safe for concurrent use.

Companion

object Companion

Functions

buildUpon

open override fun buildUpon(): Url.Builder

Constructs a new builder, copying the attributes from this Uri.

compareTo

open operator override fun compareTo(other: Uri): Int

equals

open operator override fun equals(other: Any?): Boolean

Compares this Url to another object for equality. Returns true if the encoded string representations of this Url and the given Url are equal. Case counts. Paths are not normalized. If one Url specifies a default port explicitly and the other leaves it implicit, they will not be considered equal.

getBooleanQueryParameter

open override 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.

getQueryParameter

open override fun getQueryParameter(key: String): String?

Searches the query string for the first value with the given key.

getQueryParameterNames

open override fun getQueryParameterNames(): Set<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.

getQueryParameters

open override fun getQueryParameters(key: String): List<String>

Searches the query string for parameter values with the given key.

hashCode

open override fun hashCode(): Int

Hashes the encoded string representation of this Url consistently with .equals.

normalizeScheme

open override fun normalizeScheme(): Url

Return an equivalent URL with a lowercase scheme component. This aligns the Url with Android best practices for intent filtering.

toString

open override fun toString(): String

Properties

authority

open override val authority: String

Gets the decoded authority part of this URL. For server addresses, the authority is structured as follows: [ userinfo '@' ] host [ ':' port ]

encodedAuthority

open override val encodedAuthority: String

Gets the encoded authority part of this URL. For server addresses, the authority is structured as follows: {@code userinfo '@' host ':' port }

encodedFragment

open override val encodedFragment: String?

Gets the encoded fragment part of this URI, everything after the '#'.

encodedPath

open override val encodedPath: String?

Gets the encoded path.

encodedQuery

open override val encodedQuery: 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".

encodedSchemeSpecificPart

open override val encodedSchemeSpecificPart: String

Gets the scheme-specific part of this URI, i.e. everything between the scheme separator ':' and the fragment separator '#'. Leaves escaped octets intact.

encodedUserInfo

open override val encodedUserInfo: String?

Gets the encoded user information from the authority. For example, if the authority is "nobody@google.com", this method will return "nobody".

fragment

open override val fragment: String?

Gets the decoded fragment part of this URI, everything after the '#'.

host

open override val host: String

Gets the encoded host from the authority for this URL. For example, if the authority is "bob@google.com", this method will return "google.com".

isAbsolute

open override val isAbsolute: Boolean

Returns true if this URI is absolute, i.e. if it contains an explicit scheme.

isHierarchical

open override val 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 override val 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

open override val isRelative: Boolean

Returns true if this URI is relative, i.e. if it doesn't contain an explicit scheme.

lastPathSegment

open override val lastPathSegment: String?

Gets the decoded last segment in the path.

path

open override val path: String?

Gets the decoded path.

pathSegments

open override val pathSegments: List<String>

Gets the decoded path segments.

port

open override val port: Int

Gets the port from the authority for this URI. For example, if the authority is "google.com:80", this method will return 80.

query

open override val query: 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".

scheme