Add HTTP handler registration to the HTTP server

runtime/bin/http.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.
 
 /**
  * HTTP status codes.
  */
 interface HttpStatus {
   static final int CONTINUE = 100;
   static final int SWITCHING_PROTOCOLS = 101;
@@ skipping 35 matching lines @@
   static final int BAD_GATEWAY = 502;
   static final int SERVICE_UNAVAILABLE = 503;
   static final int GATEWAY_TIMEOUT = 504;
   static final int HTTP_VERSION_NOT_SUPPORTED = 505;
   // Client generated status code.
   static final int NETWORK_CONNECT_TIMEOUT_ERROR = 599;
 }
 
 
 /**
+ * Interface to implement by HTTP request handler classes.

[Mads Ager (google), 2012/04/18 12:22:08]

to be implemented

+ */
+
+interface RequestHandler {
+  void onRequest(HttpRequest request, HttpResponse response);
+}
+
+
+/**
  * HTTP server.
  */
 interface HttpServer default _HttpServer {
   HttpServer();
 
   /**
    * Start listening for HTTP requests on the specified [host] and
    * [port]. For each HTTP request the handler set through [onRequest]
    * will be invoked. If a [port] of 0 is specified the server will
    * choose an ephemeral port. The optional argument [backlog] can be
    * used to specify the listen backlog for the underlying OS listen
    * setup.
    */
   void listen(String host, int port, [int backlog]);
 
   /**
    * Attach the HTTP server to an existing ServerSocket. If the HttpServer is
    * closed, the HttpServer will just detach itself, and not close
    * [serverSocket].
    */
   void listenOn(ServerSocket serverSocket);
 
   /**
+   * Adds a request handler to the list of request handlers. The
+   * request path is matched against the specified pattern. The first
+   * handler for which pattern which matches will be handed the

[Mads Ager (google), 2012/04/18 12:22:08]

for which the pattern matches will be ...

+   * request. The [handler] can be either an object implementing the
+   * [RequestHandler] interface or a function taking two arguments.

[Mads Ager (google), 2012/04/18 12:22:08]

Maybe spell out what the arguments are?

+   */
+  addRequestHandler(RegExp pattern, Object handler);
+
+  /**
+   * Sets the request handler. This request handler will be called if

[Mads Ager (google), 2012/04/18 12:22:08]

Sets the default request handler.

+   * none of the request handlers registered by [addRequestHandler]
+   * matches the current request. If no default request handler is set

[Mads Ager (google), 2012/04/18 12:22:08]

matches -> match

+   * the server will just respond with status code [:NOT_FOUND:] (404).
+   */
+  void set defaultRequestHandler(Object handler);
+
+  /**
    * Stop server listening.
    */
   void close();
 
   /**
    * Returns the port that the server is listening on. This can be
    * used to get the actual port used when a value of 0 for [port] is
    * specified in the [listen] call.
    */
   int get port();
 
   /**
-   * Sets the handler that gets called when a new HTTP request is received.
-   */
-  void set onRequest(void callback(HttpRequest, HttpResponse));
-
-  /**
    * Sets the error handler that is called when a connection error occurs.
    */
   void set onError(void callback(Exception e));
 }
 
 
 /**
  * Access to the HTTP headers for requests and responses. In some
  * situations the headers will be imutable and the mutating methods
  * will then throw exceptions.
@@ skipping 407 matching lines @@
    */
   InputStream get inputStream();
 }
 
 
 class HttpException implements Exception {
   const HttpException([String this.message = ""]);
   String toString() => "HttpException: $message";
   final String message;
 }