OLD | NEW |
(Empty) | |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 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. |
| 4 |
| 5 library barback.serialize; |
| 6 |
| 7 import 'dart:async'; |
| 8 import 'dart:isolate'; |
| 9 |
| 10 import 'package:stack_trace/stack_trace.dart'; |
| 11 |
| 12 import 'asset/asset_id.dart'; |
| 13 import 'utils.dart'; |
| 14 |
| 15 /// Converts [id] into a serializable map. |
| 16 Map serializeId(AssetId id) => {'package': id.package, 'path': id.path}; |
| 17 |
| 18 /// Converts [stream] into a [SendPort] with which another isolate can request |
| 19 /// the data from [stream]. |
| 20 SendPort serializeStream(Stream stream) { |
| 21 var receivePort = new ReceivePort(); |
| 22 receivePort.first.then((sendPort) { |
| 23 stream.listen((data) => sendPort.send({'type': 'data', 'data': data}), |
| 24 onDone: () => sendPort.send({'type': 'done'}), |
| 25 onError: (error, stackTrace) { |
| 26 sendPort.send({ |
| 27 'type': 'error', |
| 28 'error': CrossIsolateException.serialize(error, stackTrace) |
| 29 }); |
| 30 }); |
| 31 }); |
| 32 |
| 33 return receivePort.sendPort; |
| 34 } |
| 35 |
| 36 /// Converts a serializable map into an [AssetId]. |
| 37 AssetId deserializeId(Map id) => new AssetId(id['package'], id['path']); |
| 38 |
| 39 /// Convert a [SendPort] whose opposite is waiting to send us a stream into a |
| 40 /// [Stream]. |
| 41 /// |
| 42 /// No stream data will actually be sent across the isolate boundary until |
| 43 /// someone subscribes to the returned stream. |
| 44 Stream deserializeStream(SendPort sendPort) { |
| 45 return callbackStream(() { |
| 46 var receivePort = new ReceivePort(); |
| 47 sendPort.send(receivePort.sendPort); |
| 48 return receivePort.transform( |
| 49 const StreamTransformer(_deserializeTransformer)); |
| 50 }); |
| 51 } |
| 52 |
| 53 /// The body of a [StreamTransformer] that deserializes the values in a stream |
| 54 /// sent by [serializeStream]. |
| 55 StreamSubscription _deserializeTransformer(Stream input, bool cancelOnError) { |
| 56 var subscription; |
| 57 var transformed = input.transform(new StreamTransformer.fromHandlers( |
| 58 handleData: (data, sink) { |
| 59 if (data['type'] == 'data') { |
| 60 sink.add(data['data']); |
| 61 } else if (data['type'] == 'error') { |
| 62 var exception = new CrossIsolateException.deserialize(data['error']); |
| 63 sink.addError(exception, exception.stackTrace); |
| 64 } else { |
| 65 assert(data['type'] == 'done'); |
| 66 sink.close(); |
| 67 subscription.cancel(); |
| 68 } |
| 69 })); |
| 70 subscription = transformed.listen(null, cancelOnError: cancelOnError); |
| 71 return subscription; |
| 72 } |
| 73 |
| 74 /// An exception that was originally raised in another isolate. |
| 75 /// |
| 76 /// Exception objects can't cross isolate boundaries in general, so this class |
| 77 /// wraps as much information as can be consistently serialized. |
| 78 class CrossIsolateException implements Exception { |
| 79 /// The name of the type of exception thrown. |
| 80 /// |
| 81 /// This is the return value of [error.runtimeType.toString()]. Keep in mind |
| 82 /// that objects in different libraries may have the same type name. |
| 83 final String type; |
| 84 |
| 85 /// The exception's message, or its [toString] if it didn't expose a `message` |
| 86 /// property. |
| 87 final String message; |
| 88 |
| 89 /// The exception's stack chain, or `null` if no stack chain was available. |
| 90 final Chain stackTrace; |
| 91 |
| 92 /// Loads a [CrossIsolateException] from a serialized representation. |
| 93 /// |
| 94 /// [error] should be the result of [CrossIsolateException.serialize]. |
| 95 CrossIsolateException.deserialize(Map error) |
| 96 : type = error['type'], |
| 97 message = error['message'], |
| 98 stackTrace = error['stack'] == null ? null : |
| 99 new Chain.parse(error['stack']); |
| 100 |
| 101 /// Serializes [error] to an object that can safely be passed across isolate |
| 102 /// boundaries. |
| 103 static Map serialize(error, [StackTrace stack]) { |
| 104 if (stack == null && error is Error) stack = error.stackTrace; |
| 105 return { |
| 106 'type': error.runtimeType.toString(), |
| 107 'message': getErrorMessage(error), |
| 108 'stack': stack == null ? null : new Chain.forTrace(stack).toString() |
| 109 }; |
| 110 } |
| 111 |
| 112 String toString() => "$message\n$stackTrace"; |
| 113 } |
OLD | NEW |