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 のワーカースレッドの位置にあります。違いは上の表の一点です: 何も共有しません。

ページ一覧

関連項目