Uri abstract class

A parsed URI, such as a URL.

See also:

Static Properties

baseUri
read-only

Returns the natural base URI for the current platform.

Static Methods

decodeComponent(String encodedComponent) → String

Decodes the percent-encoding in encodedComponent.

decodeFull(String uri) → String

Decodes the percent-encoding in uri.

decodeQueryComponent(String encodedComponent, { Encoding encoding: UTF8 }) → String

Decodes the percent-encoding in encodedComponent, converting pluses to spaces.

encodeComponent(String component) → String

Encode the string component using percent-encoding to make it safe for literal use as a URI component.

encodeFull(String uri) → String

Encode the string uri using percent-encoding to make it safe for literal use as a full URI.

encodeQueryComponent(String component, { Encoding encoding: UTF8 }) → String

Encode the string component according to the HTML 4.01 rules for encoding the posting of a HTML form as a query string component.

parse(String uri, [ int start = 0, int end ]) → Uri

Creates a new Uri object by parsing a URI string.

parseIPv4Address(String host) → List<int>

Parse the host as an IP version 4 (IPv4) address, returning the address as a list of 4 bytes in network byte order (big endian).

parseIPv6Address(String host, [ int start = 0, int end ]) → List<int>

Parse the host as an IP version 6 (IPv6) address, returning the address as a list of 16 bytes in network byte order (big endian).

splitQueryString(String query, { Encoding encoding: UTF8 }) → Map<String, String>

Returns the query split into a map according to the rules specified for FORM post in the HTML 4.01 specification section 17.13.4. Each key and value in the returned map has been decoded. If the query is the empty string an empty map is returned.

Constructors

Uri({String scheme, String userInfo, String host, int port, String path, Iterable<String> pathSegments, String query, Map<String, dynamic> queryParameters, String fragment })
factory

Creates a new URI from its components.

Uri.dataFromBytes(List<int> bytes, { mimeType: "application/octet-stream", Map<String, String> parameters, percentEncoded: false })
factory

Creates a data: URI containing an encoding of bytes.

Uri.dataFromString(String content, { String mimeType, Encoding encoding, Map<String, String> parameters, bool base64: false })
factory

Creates a data: URI containing the content string.

Uri.directory(String path, { bool windows })
factory

Like Uri.file except that a non-empty URI path ends in a slash.

Uri.file(String path, { bool windows })
factory

Creates a new file URI from an absolute or relative file path.

Uri.http(String authority, String unencodedPath, [ Map<String, String> queryParameters ])
factory

Creates a new http URI from authority, path and query.

Uri.https(String authority, String unencodedPath, [ Map<String, String> queryParameters ])
factory

Creates a new https URI from authority, path and query.

Properties

authorityString
read-only

Returns the authority component.

dataUriData
read-only

Access the structure of a data: URI.

fragmentString
read-only

Returns the fragment identifier component.

hasAbsolutePathbool
read-only

Returns whether the URI has an absolute path (starting with '/').

hasAuthoritybool
read-only

Returns whether the URI has an authority component.

hasEmptyPathbool
read-only

Returns whether the URI has an empty path.

hasFragmentbool
read-only

Returns whether the URI has a fragment part.

hashCodeint
read-only

Returns a hash code computed as toString().hashCode.

hasPortbool
read-only

Returns whether the URI has an explicit port.

hasQuerybool
read-only

Returns whether the URI has a query part.

hasSchemebool
read-only

Returns whether the URI has a scheme component.

hostString
read-only

Returns the host part of the authority component.

isAbsolutebool
read-only

Returns whether the URI is absolute.

originString
read-only

Returns the origin of the URI in the form scheme://host:port for the schemes http and https.

pathString
read-only

Returns the path component.

pathSegmentsList<String>
read-only

Returns the URI path split into its segments. Each of the segments in the returned list have been decoded. If the path is empty the empty list will be returned. A leading slash / does not affect the segments returned.

portint
read-only

Returns the port part of the authority component.

queryString
read-only

Returns the query component. The returned query is encoded. To get direct access to the decoded query use queryParameters.

queryParametersMap<String, String>
read-only

Returns the URI query split into a map according to the rules specified for FORM post in the HTML 4.01 specification section 17.13.4. Each key and value in the returned map has been decoded. If there is no query the empty map is returned.

queryParametersAllMap<String, List<String>>
read-only

Returns the URI query split into a map according to the rules specified for FORM post in the HTML 4.01 specification section 17.13.4. Each key and value in the returned map has been decoded. If there is no query the empty map is returned.

schemeString
read-only

The scheme component of the URI.

userInfoString
read-only

Returns the user info part of the authority component.

runtimeTypeType
read-only, inherited

A representation of the runtime type of the object.

Operators

operator ==(Object other) → bool

A URI is equal to another URI with the same normalized representation.

Methods

isScheme(String scheme) → bool

Whether the scheme of this Uri is scheme.

normalizePath() → Uri

Returns a URI where the path has been normalized.

removeFragment() → Uri

Returns a Uri that differs from this only in not having a fragment.

replace({String scheme, String userInfo, String host, int port, String path, Iterable<String> pathSegments, String query, Map<String, dynamic> queryParameters, String fragment }) → Uri

Returns a new Uri based on this one, but with some parts replaced.

resolve(String reference) → Uri

Resolve reference as an URI relative to this.

resolveUri(Uri reference) → Uri

Resolve reference as an URI relative to this.

toFilePath({bool windows }) → String

Returns the file path from a file URI.

toString() → String

Returns the normalized string representation of the URI.

noSuchMethod(Invocation invocation) → dynamic
inherited

Invoked when a non-existent method or property is accessed.

© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/1.24.3/dart-core/Uri-class.html