Add Uri.http and Uri.https constructors

sdk/lib/core/uri.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.core;
 
 /**
  * A parsed URI, as specified by RFC-3986, http://tools.ietf.org/html/rfc3986.
  */
 class Uri {
@@ skipping 160 matching lines @@
     } else if (scheme == "https" && port == 443) {
       _port = 0;
     } else {
       _port = port;
     }
     // Fill the path.
     _path = _makePath(path, pathSegments);
   }
 
   /**
+   * Create a new `http` URI with authority, path and query.

[floitsch, 2013/06/17 14:29:01]

Creates

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   *
+   *     // Create the URI http://example.org/path?q=abc.
+   *     Uri uri = new Uri.http("example.org", "/path", { "q" : "abc" });
+   *
+   * The `scheme` is always set to `http`.
+   *
+   * The `userInfo`, `host` and `port` components are set from the
+   * [authority] argument.
+   *
+   * The `path` component is set from the [unencodedPath]
+   * argument. The path passed should not be encoded as this

[floitsch, 2013/06/17 14:29:01]

must not

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   * constructor will encode the path.

[floitsch, 2013/06/17 14:29:01]

encodes

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   *
+   * The `query` component is set from the [queryParameters] argument.

[floitsch, 2013/06/17 14:29:01]

from the optional

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   */

[floitsch, 2013/06/17 14:29:01]

Maybe add some examples. In particular showing what is encoded by the
constructor and what isn't.

Examples:

    new Uri.https("google.com", "search", { "q": "dart" });
    new Uri.http("user:pass@host:8080", "");
    new Uri.http("host", "/a%2F")  // http://host/a%252F

[floitsch, 2013/06/17 14:31:34]

Also add example with space in path.

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+  factory Uri.http(String authority,
+                   String unencodedPath,
+                   [Map<String, String> queryParameters]) {
+    return _makeHttpUri("http", authority, unencodedPath, queryParameters);
+  }
+
+  /**
+   * Create a new `https` URI with authority, path and query.

[floitsch, 2013/06/17 14:29:01]

Creates

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   *
+   * See [Uri.http] constructor for information on the arguments.

[floitsch, 2013/06/17 14:29:01]

This constructor is the same as [Uri.http] except for the scheme which is set to
`https`.

?

[Søren Gjesse, 2013/06/18 06:05:34]

Done.

+   */
+  factory Uri.https(String authority,
+                    String unencodedPath,
+                    [Map<String, String> queryParameters]) {
+    return _makeHttpUri("https", authority, unencodedPath, queryParameters);
+  }
+
+  static Uri _makeHttpUri(String scheme,
+                          String authority,
+                          String unencodedPath,
+                          Map<String, String> queryParameters) {
+    var userInfo = "";
+    var host = "";
+    var port = 0;
+
+    var hostStart = 0;
+    // Split off the user info.
+    bool hasUserInfo = false;
+    for (int i = 0; i < authority.length; i++) {
+      if (authority.codeUnitAt(i) == _AT_SIGN) {
+        hasUserInfo = true;
+        userInfo = authority.substring(0, i);
+        hostStart = i + 1;
+        break;
+      }
+    }
+    // Split host and port.
+    bool hasPort = false;
+    for (int i = hostStart; i < authority.length; i++) {
+      if (authority.codeUnitAt(i) == _COLON) {
+        hasPort = true;
+        host = authority.substring(hostStart, i);
+        if (!host.isEmpty) {
+          var portString = authority.substring(i + 1);
+          if (portString.isNotEmpty) port = int.parse(portString);
+        }
+        break;
+      }
+    }
+    if (!hasPort) {
+      host = hasUserInfo ? authority.substring(hostStart) : authority;
+    }
+
+    return new Uri(scheme: scheme,
+                   userInfo: userInfo,
+                   host: host,
+                   port: port,
+                   pathSegments: unencodedPath.split("/"),
+                   queryParameters: queryParameters);
+  }
+
+  /**
    * 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.
    *
    * The returned list is unmodifiable and will throw [UnsupportedError] on any
    * calls that would mutate it.
    */
   List<String> get pathSegments {
     if (_pathSegments == null) {
@@ skipping 548 matching lines @@
     });
   }
 
   // Frequently used character codes.
   static const int _PERCENT = 0x25;
   static const int _PLUS = 0x2B;
   static const int _SLASH = 0x2F;
   static const int _ZERO = 0x30;
   static const int _NINE = 0x39;
   static const int _COLON = 0x3A;
+  static const int _AT_SIGN = 0x40;
   static const int _UPPER_CASE_A = 0x41;
   static const int _UPPER_CASE_F = 0x46;
   static const int _LOWER_CASE_A = 0x61;
   static const int _LOWER_CASE_F = 0x66;
 
   /**
    * This is the internal implementation of JavaScript's encodeURI function.
    * It encodes all characters in the string [text] except for those
    * that appear in [canonicalTable], and returns the escaped string.
    */
@@ skipping 275 matching lines @@
   void clear() {
     throw new UnsupportedError("Cannot modify an unmodifiable map");
   }
   void forEach(void f(K key, V value)) => _map.forEach(f);
   Iterable<K> get keys => _map.keys;
   Iterable<V> get values => _map.values;
   int get length => _map.length;
   bool get isEmpty => _map.isEmpty;
   bool get isNotEmpty => _map.isNotEmpty;
 }