OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 part of dart.isolate; | 5 part of dart.isolate; |
6 | 6 |
7 class IsolateSpawnException implements Exception { | 7 class IsolateSpawnException implements Exception { |
8 const IsolateSpawnException(String this._s); | 8 const IsolateSpawnException(String this._s); |
9 String toString() => "IsolateSpawnException: '$_s'"; | 9 String toString() => "IsolateSpawnException: '$_s'"; |
10 final String _s; | 10 final String _s; |
11 } | 11 } |
12 | 12 |
13 /** | 13 /** |
14 * The initial [ReceivePort] available by default for this isolate. This | 14 * The initial [ReceivePort] available by default for this isolate. This |
15 * [ReceivePort] is created automatically and it is commonly used to establish | 15 * [ReceivePort] is created automatically and it is commonly used to establish |
16 * the first communication between isolates (see [spawnFunction] and | 16 * the first communication between isolates (see [spawnFunction] and |
17 * [spawnUri]). | 17 * [spawnUri]). |
18 */ | 18 */ |
19 external ReceivePort get port; | 19 ReceivePort get port => _Isolate.port; |
20 | 20 |
21 /** | 21 /** |
22 * Creates and spawns an isolate that shares the same code as the current | 22 * Creates and spawns an isolate that shares the same code as the current |
23 * isolate, but that starts from [topLevelFunction]. The [topLevelFunction] | 23 * isolate, but that starts from [topLevelFunction]. The [topLevelFunction] |
24 * argument must be a static top-level function or a static method that takes no | 24 * argument must be a static top-level function or a static method that takes no |
25 * arguments. It is illegal to pass a function closure. | 25 * arguments. It is illegal to pass a function closure. |
26 * | 26 * |
27 * When any isolate starts (even the main script of the application), a default | 27 * When any isolate starts (even the main script of the application), a default |
28 * [ReceivePort] is created for it. This port is available from the top-level | 28 * [ReceivePort] is created for it. This port is available from the top-level |
29 * getter [port] defined in this library. | 29 * getter [port] defined in this library. |
30 * | 30 * |
31 * [spawnFunction] returns a [SendPort] derived from the child isolate's default | 31 * [spawnFunction] returns a [SendPort] derived from the child isolate's default |
32 * port. | 32 * port. |
33 * | 33 * |
34 * See comments at the top of this library for more details. | 34 * See comments at the top of this library for more details. |
35 */ | 35 */ |
36 // Note this feature is not yet available in the dartvm. | 36 SendPort spawnFunction(void topLevelFunction(), |
37 external SendPort spawnFunction(void topLevelFunction(), | 37 [bool UnhandledExceptionCallback(IsolateUnhandledException e)]) |
38 [bool UnhandledExceptionCallback(IsolateUnhandledException e)]); | 38 => _Isolate.spawnFunction(topLevelFunction, UnhandledExceptionCallback); |
| 39 |
39 /** | 40 /** |
40 * Creates and spawns an isolate whose code is available at [uri]. Like with | 41 * Creates and spawns an isolate whose code is available at [uri]. Like with |
41 * [spawnFunction], the child isolate will have a default [ReceivePort], and a | 42 * [spawnFunction], the child isolate will have a default [ReceivePort], and a |
42 * this function returns a [SendPort] derived from it. | 43 * this function returns a [SendPort] derived from it. |
43 * | 44 * |
44 * See comments at the top of this library for more details. | 45 * See comments at the top of this library for more details. |
45 */ | 46 */ |
46 external SendPort spawnUri(String uri); | 47 SendPort spawnUri(String uri) => _Isolate.spawnUri(uri); |
47 | 48 |
48 /** | 49 /** |
49 * [SendPort]s are created from [ReceivePort]s. Any message sent through | 50 * [SendPort]s are created from [ReceivePort]s. Any message sent through |
50 * a [SendPort] is delivered to its respective [ReceivePort]. There might be | 51 * a [SendPort] is delivered to its respective [ReceivePort]. There might be |
51 * many [SendPort]s for the same [ReceivePort]. | 52 * many [SendPort]s for the same [ReceivePort]. |
52 * | 53 * |
53 * [SendPort]s can be transmitted to other isolates. | 54 * [SendPort]s can be transmitted to other isolates. |
54 */ | 55 */ |
55 abstract class SendPort { | 56 abstract class SendPort { |
56 | 57 |
(...skipping 81 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
138 | 139 |
139 } | 140 } |
140 | 141 |
141 // TODO(kasperl): Document this. | 142 // TODO(kasperl): Document this. |
142 abstract class SendPortSync { | 143 abstract class SendPortSync { |
143 | 144 |
144 callSync(var message); | 145 callSync(var message); |
145 | 146 |
146 } | 147 } |
147 | 148 |
| 149 // The VM doesn't support accessing external globals in the same library. We |
| 150 // therefore create this wrapper class. |
| 151 // TODO(6997): Don't go through static class for external variables. |
| 152 abstract class _Isolate { |
| 153 external static ReceivePort get port; |
| 154 external static SendPort spawnFunction(void topLevelFunction(), |
| 155 [bool UnhandledExceptionCallback(IsolateUnhandledException e)]); |
| 156 external static SendPort spawnUri(String uri); |
| 157 } |
| 158 |
148 /** | 159 /** |
149 * Wraps unhandled exceptions thrown during isolate execution. It is | 160 * Wraps unhandled exceptions thrown during isolate execution. It is |
150 * used to show both the error message and the stack trace for unhandled | 161 * used to show both the error message and the stack trace for unhandled |
151 * exceptions. | 162 * exceptions. |
152 */ | 163 */ |
153 class IsolateUnhandledException implements Exception { | 164 class IsolateUnhandledException implements Exception { |
154 /** Message being handled when exception occurred. */ | 165 /** Message being handled when exception occurred. */ |
155 final message; | 166 final message; |
156 | 167 |
157 /** Wrapped exception. */ | 168 /** Wrapped exception. */ |
158 final source; | 169 final source; |
159 | 170 |
160 /** Trace for the wrapped exception. */ | 171 /** Trace for the wrapped exception. */ |
161 final Object stackTrace; | 172 final Object stackTrace; |
162 | 173 |
163 const IsolateUnhandledException(this.message, this.source, this.stackTrace); | 174 const IsolateUnhandledException(this.message, this.source, this.stackTrace); |
164 | 175 |
165 String toString() { | 176 String toString() { |
166 return 'IsolateUnhandledException: exception while handling message: ' | 177 return 'IsolateUnhandledException: exception while handling message: ' |
167 '${message} \n ' | 178 '${message} \n ' |
168 '${source.toString().replaceAll("\n", "\n ")}\n' | 179 '${source.toString().replaceAll("\n", "\n ")}\n' |
169 'original stack trace:\n ' | 180 'original stack trace:\n ' |
170 '${stackTrace.toString().replaceAll("\n","\n ")}'; | 181 '${stackTrace.toString().replaceAll("\n","\n ")}'; |
171 } | 182 } |
172 } | 183 } |
OLD | NEW |