Add 'Server' and 'User-Agent' default header fields.

sdk/lib/io/http.dart

 // Copyright (c) 2013, 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.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 153 matching lines @@
    * Sets the timeout, in seconds, for sessions of this [HttpServer].
    * The default timeout is 20 minutes.
    */
   set sessionTimeout(int timeout);
 
   /**
    * Returns an [HttpConnectionsInfo] object summarizing the number of
    * current connections handled by the server.
    */
   HttpConnectionsInfo connectionsInfo();
+
+  /**
+   * Set and get the version of the [:HttpServer:]. The string will be set as

[Søren Gjesse, 2013/06/11 11:02:00]

Change

  Set and get the version of the [:HttpServer:].

to something like

  Set and get the default value of the `Server` header for all responses
generated by this [HttpServer].

Also document the actual default value.

[Anders Johnsen, 2013/06/11 11:37:55]

Done.

+   * the [:Server:] header field for all [HttpResponse]s.

[Søren Gjesse, 2013/06/11 11:02:00]

You can use ` ` instead of [: :].

[Anders Johnsen, 2013/06/11 11:37:55]

Done.

+   *
+   * If the version is set to [:null:]. the field won't be set.

[Søren Gjesse, 2013/06/11 11:02:00]

the field won't be set -> no default `Server` header will be added to each
response.

[Anders Johnsen, 2013/06/11 11:37:55]

Done.

+   */
+  String version;

[Søren Gjesse, 2013/06/11 11:02:00]

This should be called serverHeader (or maybe even serverHeaderValue). There is
not a well established name for this as there is for user agent.

[Anders Johnsen, 2013/06/11 11:37:55]

Done.

 }
 
 
 /**
  * Summary statistics about an [HttpServer]s current socket connections.
  */
 class HttpConnectionsInfo {
   /**
    * Total number of socket connections.
    */
@@ skipping 688 matching lines @@
 abstract class HttpClient {
   static const int DEFAULT_HTTP_PORT = 80;
   static const int DEFAULT_HTTPS_PORT = 443;
 
   /**
    * Get and set the idle timeout of non-active persistent (keep-alive)
    * connections. The default value is 15 seconds.
    */
   Duration idleTimeout;
 
+  /**
+   * Set and get the user agent of the [:HttpClient:]. The string will be set as
+   * the [:User-Agent:] header field for all [HttpClientRequest]s.
+   *
+   * If the version is set to [:null:]. the field won't be set.
+   */
+  String userAgent;
+
   factory HttpClient() => new _HttpClient();
 
   /**
    * Opens a HTTP connection. The returned [HttpClientRequest] is used to
    * fill in the content of the request before sending it. The 'host' header for
    * the request will be set to the value [host]:[port]. This can be overridden
    * through the [HttpClientRequest] interface before the request is sent.
    * NOTE if [host] is an IP address this will still be set in the 'host'
    * header.
    */
@@ skipping 478 matching lines @@
 class RedirectLimitExceededException extends RedirectException {
   const RedirectLimitExceededException(List<RedirectInfo> redirects)
       : super("Redirect limit exceeded", redirects);
 }
 
 
 class RedirectLoopException extends RedirectException {
   const RedirectLoopException(List<RedirectInfo> redirects)
       : super("Redirect loop detected", redirects);
 }