Uri abstract class
A parsed URI, such as a URL.
See also:
- URIs in the library tour
- RFC-3986
Static Properties
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 thequery
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 ofbytes
. - Uri.dataFromString(String content, { String mimeType, Encoding encoding, Map<String, String> parameters, bool base64: false }) factory
-
Creates a
data:
URI containing thecontent
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
-
Returns the authority component.
- data → UriData read-only
-
Access the structure of a
data:
URI. - fragment → String read-only
-
Returns the fragment identifier component.
- hasAbsolutePath → bool read-only
-
Returns whether the URI has an absolute path (starting with '/').
- hasAuthority → bool read-only
-
Returns whether the URI has an
authority
component. - hasEmptyPath → bool read-only
-
Returns whether the URI has an empty path.
- hasFragment → bool read-only
-
Returns whether the URI has a fragment part.
- hashCode → int read-only
-
Returns a hash code computed as
toString().hashCode
. - hasPort → bool read-only
-
Returns whether the URI has an explicit port.
- hasQuery → bool read-only
-
Returns whether the URI has a query part.
- hasScheme → bool read-only
-
Returns whether the URI has a
scheme
component. - host → String read-only
-
Returns the host part of the authority component.
- isAbsolute → bool read-only
-
Returns whether the URI is absolute.
- origin → String read-only
-
Returns the origin of the URI in the form scheme://host:port for the schemes http and https.
- path → String read-only
-
Returns the path component.
- pathSegments → List<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. - port → int read-only
-
Returns the port part of the authority component.
- query → String read-only
-
Returns the query component. The returned query is encoded. To get direct access to the decoded query use
queryParameters
. - queryParameters → Map<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.
- queryParametersAll → Map<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.
- scheme → String read-only
-
The scheme component of the URI.
- userInfo → String read-only
-
Returns the user info part of the authority component.
- runtimeType → Type 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 tothis
. - resolveUri(
Uri reference) → Uri -
Resolve
reference
as an URI relative tothis
. - 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