isolate
isolate は、Dart がコードを並列に実行する方法です。プログラムの一部分で、独自のメモリーと独自のイベントループを持ち、一度に一つのことをします。Spring for Dart のアプリケーションは、追加を求めないかぎり、一つの isolate、main で動きます。このセクションでは、isolate を追加する方法と、isolate が何をしているかを見る方法を説明します。
使う理由
一つの isolate は一つのプロセッサーコアを使います。8 コアのマシンで一つの isolate から応答するサーバーは、7 つのコアを使わないままにします。そして一つの長い計算 (数メガバイトの JSON の解析、画像のリサイズ) は、終わるまで、ほかのすべてのリクエスト、またはアプリのすべてのフレームを止めます。
isolate を増やせば、ほかのコアを使えます。その代償は、isolate 同士が何も共有しないことです。これが、開発者が最初に知っておくべき Java との違いです。
| Java のスレッド | Dart の isolate | |
|---|---|---|
| メモリー | ほかのスレッドとヒープを共有する | 独自のメモリーを持つ。何も共有しない |
| シングルトン Bean | 一つのオブジェクトで、すべてのスレッドから見える | アプリケーションを実行する isolate ごとに一つのオブジェクト |
| データの受け渡し | 参照 | コピー: 関数、その引数、その結果がコピーされる |
| 状態の保護 | ロック、synchronized、並行コレクション |
保護するものはない: ほかの isolate からは届かない |
| 全員が見る必要のある状態 | Bean のフィールド | isolate の外: データベース、共有ストア |
そのため、コードが別のスレッドに割り込まれることはなく、ロックも必要ありません。そして、Bean のフィールドにあるカウンターは、アプリケーションがしたことではなく、その isolate がしたことを数えます。
例
import 'package:spring_boot_dart/spring_boot_dart.dart';
@Component()
class Migrations {
Migrations(this.isolate);
final IsolateInfo isolate;
// アプリケーションを実行するすべての isolate で動くが、マイグレーションは一つだけで行う。
@PostConstruct()
void run() {
if (isolate.primary) migrate();
}
}
isolate が一つ (デフォルト) のとき、isolate.primary は常に true で、上のコードはこれまでと同じ動きをします。
アプリケーションの isolate
| ログでの名前 | 種類 | 起動するもの | そこで動くもの |
|---|---|---|---|
main |
main |
プログラム | アプリケーション全体。デフォルトでは唯一の isolate で、常にプライマリ isolate |
isolate-1、isolate-2、… |
server |
Web サーバーのプール。server.isolates.count が 1 より大きいとき |
もう一度アプリケーション全体。独自の Bean を持ち、同じポートを使う。isolate のプール を参照 |
task-1、task-2、… |
task |
IsolateTaskExecutor。最初のタスクのとき |
一度に一つの関数と、その引数。Bean はない。タスクエグゼキューター を参照 |
サーバーのプールの isolate は、独自のタスクエグゼキューターを持ちます。その isolate は両方の名前を持ちます: isolate-2-task-1。
アプリケーションが自分で起動する isolate (Isolate.run、compute) は、このどれでもありません。フレームワークはそれを知りません。コンパイルされたプログラムは、自分の isolate を列挙できないためです。IsolateLoads.track を使うと、動いている間、タスクマネージャーに表示されます。isolate の負荷 を参照してください。
IsolateInfo
IsolateInfo は、コードがどの isolate で動いているかを伝えます。Spring Boot では Bean isolateInfo です。Spring Boot なしでは IsolateInfo.current を読みます。
| メンバー | 意味 |
|---|---|
name |
ログでの isolate の名前: main、またはプールでは isolate-2 |
index |
プールでの番号。プライマリでは 0 |
primary |
アプリケーションの最初の isolate かどうか: ほかの isolate を起動したもので、プールがなければ唯一のもの |
IsolateInfo.current |
このコードが動いている isolate。プールは、起動する各 isolate で、アプリケーションがそこで起動する前にこれを設定する |
primary は、isolate ごとに一度ではなく、アプリケーションで一度だけ行う必要のある作業に使います。スケジュールされたジョブ、データのマイグレーション、ウォームアップなどです。Bean 全体をプライマリ isolate だけに置くには、@ConditionalOnPrimaryIsolate() を付けます (条件 を参照)。ほかの isolate からその isolate に問い合わせるには、最初の isolate に問い合わせる を参照してください。
IsolateInfo.current は static フィールドで、各 isolate は独自の static を持ちます。自分で起動した isolate では、誰もこれを設定していません。そこでは、その isolate が何であっても、デフォルト (main、プライマリ) になります。
各プラットフォームでできること
| Dart VM、AOT 実行ファイル (サーバー、ツール) | スマートフォンやデスクトップの Flutter | ブラウザー | |
|---|---|---|---|
| アプリケーションの isolate | main |
main |
main。存在する唯一の isolate |
Web サーバーのプール (server.isolates.*) |
使える | 使えない: 設定は警告とともに無視され、サーバーはアプリの isolate にとどまる | サーバーがない: Web スターターのモジュールはブラウザービルドに入らない |
IsolateTaskExecutor |
isolate のプール | isolate のプール。重い作業は、描画する isolate から離れる | isolate を起動できない: タスクは呼び出した isolate で、そのイベントループの後のターンに、同じ API で動く |
main の負荷 (IsolateLoadSampler) |
遅れ、busy (働いていた時間の割合)、プロセスの常駐メモリー |
同じ | 遅れと busy。ブラウザーが伝える場合 (performance.memory、Chromium) は使用中の JavaScript ヒープ。それ以外ではメモリーはない |
| タスクマネージャーでのエンジンのスレッド | なし: エンジンがない | raster、platform、io。Flutter スターターのタスクマネージャーがある場合 |
raster のみ |
Flutter アプリは、別の isolate で自分の Bean をもう一度動かすことができません。ウィジェット、アセット、プラグインは、最初の isolate にしか存在しないためです。サーバーのプールがサーバープログラムのためのものであるのは、そのためです。
ログでの表示
すべての isolate には名前があり、ログに表示されます。
ロギングバックエンドがない場合、アプリケーションの最初の isolate 以外の isolate で書かれた行は、isolate の名前で始まります。
[isolate-2] [neon.checkout] INFO: paid 12.5
[task-1] [neon.reports] WARNING: 3 rows skipped
main の行はこれまでどおりです: [neon.checkout] INFO: paid 12.5。
spring_boot_starter_logging がある場合、パターンの %thread (または %t) は isolate の名前で、デフォルトのコンソール行にも入っています。
2026-10-23T21:08:01.580Z INFO 4711 --- [shop] [neon] [ isolate-2] neon.checkout : paid 12.5 {order=1}
タスクエグゼキューターの isolate はアプリケーションを実行しないため、ロギングの構成を持ちません。タスクがログに出すものは、アプリケーションがロギングスターターを使っている場合も、最初の形式で書かれます。
Bean
spring_boot_dart は、このセクションの Bean を宣言します。それぞれ、アプリケーションが独自のものを宣言すると除外されます: isolateInfo、isolateLoadSampler、isolateTaskExecutor、isolateLoads、isolateReports、primaryIsolate。組み込みの Bean を参照してください。
クラスは spring_core_dart (package:spring_core_dart/core.dart) にあり、Spring Boot なしでも動きます。
final executor = IsolateTaskExecutor();
final sum = await executor.submitWith(total, numbers);
await executor.shutdown();
Spring (Java) との対応
Spring には IsolateInfo に対応するものはありません。Spring の Bean は一つの JVM とそのスレッドを共有するためです。IsolateTaskExecutor は ThreadPoolTaskExecutor の位置に、サーバーのプールは Tomcat のワーカースレッドの位置にあります。違いは上の表の一点です: 何も共有しません。
ページ一覧
- タスクエグゼキューター:
IsolateTaskExecutor、submitとsubmitWith、別の isolate に渡るもの、プールとそのプロパティ。 - isolate の負荷:
IsolateLoads、タスクマネージャーの行、遅れとbusyの計測方法とそれではわからないこと、track、すべての isolate からのレポート。 - 最初の isolate に問い合わせる:
PrimaryIsolateとPrimaryIsolateHandler。アプリケーションで一つだけ存在する必要のあるもののために。