SIGQUIT toggles VM service HTTP server

runtime/bin/vmservice/server.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 vmservice_io;
 
 class WebSocketClient extends Client {
   static const int PARSE_ERROR_CODE = 4000;
   static const int BINARY_MESSAGE_ERROR_CODE = 4001;
   static const int NOT_MAP_ERROR_CODE = 4002;
@@ skipping 62 matching lines @@
   dynamic toJson() {
     Map map = super.toJson();
     map['type'] = 'HttpRequestClient';
     map['request'] = '$request';
     return map;
   }
 }
 
 class Server {
   static const WEBSOCKET_PATH = '/ws';
-  String observatoryPath = '/index.html';
-  final String ip;
-  int port;
+  static const ROOT_REDIRECT_PATH = '/index.html';
 
-  final VMService service;
+  final VMService _service;
+  final String _ip;
+  final int _port;
+
   HttpServer _server;
+  bool get running => _server != null;
+  bool _displayMessages = false;
 
-  Server(this.service, this.ip, this.port);
+  Server(this._service, this._ip, this._port) {
+    _displayMessages = (_ip != '127.0.0.1' || _port != 8181);
+  }
 
   bool _shouldServeObservatory(HttpRequest request) {
     if (request.headers['Observatory-Version'] != null) {
       // Request is already coming from Observatory.
       return false;
     }
     // TODO(johnmccutchan): Test with obscure browsers.
     if (request.headers.value(HttpHeaders.USER_AGENT).contains('Mozilla')) {
       // Request is coming from a browser but not Observatory application.
       // Serve Observatory and let the Observatory make the real request.
       return true;
     }
     // All other user agents are assumed to be textual.
     return false;
   }
 
   void _requestHandler(HttpRequest request) {
     // Allow cross origin requests with 'observatory' header.
     request.response.headers.add('Access-Control-Allow-Origin', '*');
     request.response.headers.add('Access-Control-Allow-Headers',
                                  'Observatory-Version');
 
     if (request.method != 'GET') {
       // Not a GET request. Do nothing.
       request.response.close();
       return;
     }
 
     final String path =
-          request.uri.path == '/' ? observatoryPath : request.uri.path;
+          request.uri.path == '/' ? ROOT_REDIRECT_PATH : request.uri.path;
 
     if (path == WEBSOCKET_PATH) {
       WebSocketTransformer.upgrade(request).then((WebSocket webSocket) {
-        new WebSocketClient(webSocket, service);
+        new WebSocketClient(webSocket, _service);
       });
       return;
     }
 
     var resource = Resource.resources[path];
     if (resource == null && _shouldServeObservatory(request)) {
-      resource = Resource.resources[observatoryPath];
+      resource = Resource.resources[ROOT_REDIRECT_PATH];
       assert(resource != null);
     }
     if (resource != null) {
       // Serving up a static resource (e.g. .css, .html, .png).
       request.response.headers.contentType =
           ContentType.parse(resource.mimeType);
       request.response.add(resource.data);
       request.response.close();
       return;
     }
     var message = new Message.fromUri(request.uri);
-    var client = new HttpRequestClient(request, service);
+    var client = new HttpRequestClient(request, _service);
     client.onMessage(null, message);
   }
 
-  Future startServer() {
-    return HttpServer.bind(ip, port).then((s) {
-      // Only display message when port is automatically selected.
-      var display_message = (ip != '127.0.0.1' || port != 8181);
-      // Retrieve port.
-      port = s.port;
+  Future startup() {
+    if (_server != null) {
+      // Already running.
+      return new Future.value(this);
+    }
+
+    // Startup HTTP server.
+    return HttpServer.bind(_ip, _port).then((s) {
       _server = s;
       _server.listen(_requestHandler);
-      if (display_message) {
+      if (_displayMessages) {
+        var ip = _server.address.address.toString();
+        var port = _server.port.toString();
         print('Observatory listening on http://$ip:$port');
       }
-      return s;
+      // Server is up and running.
+      return this;
+    }).catchError((e, st) {
+      print('Could not start Observatory HTTP server:\n$e\n$st\n');
+      return this;
     });
   }
+
+  Future shutdown(bool forced) {
+    if (_server == null) {
+      // Not started.
+      return new Future.value(this);
+    }
+
+    // Force displaying of status messages if we are forcibly shutdown.
+    _displayMessages = _displayMessages || forced;
+
+    // Shutdown HTTP server and subscription.
+    var ip = _server.address.address.toString();
+    var port = _server.port.toString();
+    return _server.close(force: forced).then((_) {
+      if (_displayMessages) {
+        print('Observatory no longer listening on http://$ip:$port');
+      }
+      _server = null;
+      return this;
+    }).catchError((e, st) {
+      _server = null;
+      print('Could not shutdown Observatory HTTP server:\n$e\n$st\n');
+      return this;
+    });
+  }
+
 }