ngeoffray@google.com
c1d3f92e1e
Review URL: https://chromiumcodereview.appspot.com//9662046 git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@5352 260f80e4-7a28-3924-810f-c04153c831b5
49 lines
2.2 KiB
Dart
49 lines
2.2 KiB
Dart
// Copyright (c) 2011, 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.
|
|
|
|
|
|
// Dart isolate's API and implementation for frog. Since dartdocs are generated
|
|
// using frog, we include here some additional library level comments.
|
|
|
|
/**
|
|
* The `dart:isolate` library defines APIs to spawn and communicate with
|
|
* isolates.
|
|
*
|
|
* All code in dart runs in the context of an isolate. Each isolate has its own
|
|
* heap, which means that all values in memory, including globals, are available
|
|
* only to that isolate. The only mechanism available to communicate between
|
|
* isolates is to pass messages. Messages are sent through ports. This library
|
|
* defines [ReceivePort] to represent the receiver's end of a communication
|
|
* channel, and [SendPort] to represent the sender's end.
|
|
*
|
|
* All isolates start with an initial receive port, which is set in the
|
|
* top-level property [port]. This port is used to establish the first
|
|
* communication between isolates.
|
|
*
|
|
* Two APIs are available to spawn a new isolate: [spawnFunction] and
|
|
* [spawnUri]. [spawnFunction] creates a new isolate that is using the same
|
|
* source code as the current isolate, [spawnUri] allows spawning an isolate
|
|
* that was written independently.
|
|
*
|
|
* There is currently no way to indicate in the API whether the isolates should
|
|
* run on the same or different threads. The underlying system will schedule the
|
|
* isolate were appropriate. In the near future we will add an API to create DOM
|
|
* isolates. These are isolates that share access to the DOM. All DOM isolates
|
|
* will run on the UI thread.
|
|
*
|
|
* This library is still evolving. New APIs are being added, and some will be
|
|
* deprecated and removed. In particular, the class [Isolate] will be
|
|
* deprecated as soon the dartvm has an implementation working for
|
|
* [spawnFunction] and [spawnUri], and we have an API to spawn DOM isolates.
|
|
*/
|
|
#library("dart:isolate");
|
|
|
|
#import("../uri/uri.dart");
|
|
#source("isolate_api.dart");
|
|
#source("frog/compiler_hooks.dart");
|
|
#source("frog/isolateimpl.dart");
|
|
#source("frog/ports.dart");
|
|
#source("frog/messages.dart");
|
|
#native("frog/natives.js");
|