| OLD | NEW |
| 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 library pub.barback.web_socket_api; | 5 library pub.barback.web_socket_api; |
| 6 | 6 |
| 7 import 'dart:async'; | 7 import 'dart:async'; |
| 8 import 'dart:io'; | 8 import 'dart:io'; |
| 9 | 9 |
| 10 import 'package:http_parser/http_parser.dart'; | 10 import 'package:http_parser/http_parser.dart'; |
| 11 import 'package:path/path.dart' as path; | 11 import 'package:path/path.dart' as path; |
| 12 import 'package:json_rpc_2/json_rpc_2.dart' as json_rpc; | 12 import 'package:json_rpc_2/json_rpc_2.dart' as json_rpc; |
| 13 | 13 |
| 14 import '../exit_codes.dart' as exit_codes; | 14 import '../exit_codes.dart' as exit_codes; |
| 15 import '../io.dart'; | 15 import '../io.dart'; |
| 16 import '../log.dart' as log; | 16 import '../log.dart' as log; |
| 17 import '../utils.dart'; | 17 import '../utils.dart'; |
| 18 import 'asset_environment.dart'; | 18 import 'asset_environment.dart'; |
| 19 | 19 |
| 20 /// Implements the [WebSocket] API for communicating with a running pub serve | 20 /// Implements the [WebSocket] API for communicating with a running pub serve |
| 21 /// process, mainly for use by the Editor. | 21 /// process, mainly for use by the Editor. |
| 22 /// | 22 /// |
| 23 /// This is a [JSON-RPC 2.0](http://www.jsonrpc.org/specification) server. Its | 23 /// This is a [JSON-RPC 2.0](http://www.jsonrpc.org/specification) server. Its |
| 24 /// methods are described in the method-level documentation below. | 24 /// methods are described in the method-level documentation below. |
| 25 class WebSocketApi { | 25 class WebSocketApi { |
| 26 final CompatibleWebSocket _socket; | |
| 27 final AssetEnvironment _environment; | 26 final AssetEnvironment _environment; |
| 28 final _server = new json_rpc.Server(); | 27 final json_rpc.Server _server; |
| 29 | 28 |
| 30 /// Whether the application should exit when this connection closes. | 29 /// Whether the application should exit when this connection closes. |
| 31 bool _exitOnClose = false; | 30 bool _exitOnClose = false; |
| 32 | 31 |
| 33 WebSocketApi(this._socket, this._environment) { | 32 WebSocketApi(CompatibleWebSocket socket, this._environment) |
| 33 : _server = new json_rpc.Server(socket) { |
| 34 _server.registerMethod("urlToAssetId", _urlToAssetId); | 34 _server.registerMethod("urlToAssetId", _urlToAssetId); |
| 35 _server.registerMethod("pathToUrls", _pathToUrls); | 35 _server.registerMethod("pathToUrls", _pathToUrls); |
| 36 _server.registerMethod("serveDirectory", _serveDirectory); | 36 _server.registerMethod("serveDirectory", _serveDirectory); |
| 37 _server.registerMethod("unserveDirectory", _unserveDirectory); | 37 _server.registerMethod("unserveDirectory", _unserveDirectory); |
| 38 | 38 |
| 39 /// Tells the server to exit as soon as this WebSocket connection is closed. | 39 /// Tells the server to exit as soon as this WebSocket connection is closed. |
| 40 /// | 40 /// |
| 41 /// This takes no arguments and returns no results. It can safely be called | 41 /// This takes no arguments and returns no results. It can safely be called |
| 42 /// as a JSON-RPC notification. | 42 /// as a JSON-RPC notification. |
| 43 _server.registerMethod("exitOnClose", () { | 43 _server.registerMethod("exitOnClose", () { |
| 44 _exitOnClose = true; | 44 _exitOnClose = true; |
| 45 }); | 45 }); |
| 46 } | 46 } |
| 47 | 47 |
| 48 /// Listens on the socket. | 48 /// Listens on the socket. |
| 49 /// | 49 /// |
| 50 /// Returns a future that completes when the socket has closed. It will | 50 /// Returns a future that completes when the socket has closed. It will |
| 51 /// complete with an error if the socket had an error, otherwise it will | 51 /// complete with an error if the socket had an error, otherwise it will |
| 52 /// complete to `null`. | 52 /// complete to `null`. |
| 53 Future listen() { | 53 Future listen() { |
| 54 return _socket.listen((request) { | 54 _server.listen().then((_) { |
| 55 _server.parseRequest(request).then((response) { | |
| 56 if (response != null) _socket.add(response); | |
| 57 }); | |
| 58 }, cancelOnError: true).asFuture().then((_) { | |
| 59 if (!_exitOnClose) return; | 55 if (!_exitOnClose) return; |
| 60 log.message("WebSocket connection closed, terminating."); | 56 log.message("WebSocket connection closed, terminating."); |
| 61 flushThenExit(exit_codes.SUCCESS); | 57 flushThenExit(exit_codes.SUCCESS); |
| 62 }); | 58 }); |
| 63 } | 59 } |
| 64 | 60 |
| 65 /// Given a URL to an asset that is served by pub, returns the ID of the | 61 /// Given a URL to an asset that is served by pub, returns the ID of the |
| 66 /// asset that would be accessed by that URL. | 62 /// asset that would be accessed by that URL. |
| 67 /// | 63 /// |
| 68 /// The method name is "urlToAssetId" and it takes a "url" parameter for the | 64 /// The method name is "urlToAssetId" and it takes a "url" parameter for the |
| (...skipping 236 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 305 | 301 |
| 306 | 302 |
| 307 /// The pub-specific JSON RPC error codes. | 303 /// The pub-specific JSON RPC error codes. |
| 308 class _Error { | 304 class _Error { |
| 309 /// The specified directory is not being served. | 305 /// The specified directory is not being served. |
| 310 static const NOT_SERVED = 1; | 306 static const NOT_SERVED = 1; |
| 311 | 307 |
| 312 /// The specified directory overlaps one or more ones already being served. | 308 /// The specified directory overlaps one or more ones already being served. |
| 313 static const OVERLAPPING = 2; | 309 static const OVERLAPPING = 2; |
| 314 } | 310 } |
| OLD | NEW |