
# 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 がしたことを数えます。

## 例

```dart
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 のプール](../../spring-boot-starter-web/server/isolates.md) を参照 |
| `task-1`、`task-2`、… | `task` | `IsolateTaskExecutor`。最初のタスクのとき | 一度に一つの関数と、その引数。Bean はない。[タスクエグゼキューター](task-executor.md) を参照 |

サーバーのプールの isolate は、独自のタスクエグゼキューターを持ちます。その isolate は両方の名前を持ちます: `isolate-2-task-1`。

アプリケーションが自分で起動する isolate (`Isolate.run`、`compute`) は、このどれでもありません。フレームワークはそれを知りません。コンパイルされたプログラムは、自分の isolate を列挙できないためです。`IsolateLoads.track` を使うと、動いている間、タスクマネージャーに表示されます。[isolate の負荷](load.md) を参照してください。

## 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()` を付けます ([条件](../../spring-boot-dart/conditions.md#conditionalonprimaryisolate) を参照)。ほかの isolate からその isolate に問い合わせるには、[最初の isolate に問い合わせる](primary-isolate.md) を参照してください。

`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 の名前で始まります。

```text
[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 の名前で、デフォルトのコンソール行にも入っています。

```text
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-boot-dart/built-in-beans.md#isolate) を参照してください。

クラスは `spring_core_dart` (`package:spring_core_dart/core.dart`) にあり、Spring Boot なしでも動きます。

```dart
final executor = IsolateTaskExecutor();
final sum = await executor.submitWith(total, numbers);
await executor.shutdown();
```

## Spring (Java) との対応

Spring には `IsolateInfo` に対応するものはありません。Spring の Bean は一つの JVM とそのスレッドを共有するためです。`IsolateTaskExecutor` は `ThreadPoolTaskExecutor` の位置に、サーバーのプールは Tomcat のワーカースレッドの位置にあります。違いは上の表の一点です: 何も共有しません。

## ページ一覧

- [タスクエグゼキューター](task-executor.md): `IsolateTaskExecutor`、`submit` と `submitWith`、別の isolate に渡るもの、プールとそのプロパティ。
- [isolate の負荷](load.md): `IsolateLoads`、タスクマネージャーの行、遅れと `busy` の計測方法とそれではわからないこと、`track`、すべての isolate からのレポート。
- [最初の isolate に問い合わせる](primary-isolate.md): `PrimaryIsolate` と `PrimaryIsolateHandler`。アプリケーションで一つだけ存在する必要のあるもののために。

## 関連項目

- [Web サーバーの isolate のプール](../../spring-boot-starter-web/server/isolates.md)
- [isolate のスケーリング](../../spring-boot-starter-web/server/scaling.md)
- [Actuator の `isolates` エンドポイント](../../spring-boot-actuator/isolates.md)
- [Flutter アプリのタスクマネージャー](../../spring-boot-starter-flutter/isolates.md)
- [条件: @ConditionalOnPrimaryIsolate](../../spring-boot-dart/conditions.md#conditionalonprimaryisolate)
- [SpringLog](../logging/spring-log.md)
