
# Spring との違い

`spring_boot_dart` は Spring Boot に従っています。アノテーションも、プロパティの名前も、起動の順序も同じです。このページでは、そうでない箇所をすべて、その理由とともにトピックごとに列挙します。

## 使う理由

違いのほとんどは、次の 3 つの事実から来ています。

- **Dart には実行時のリフレクションもクラスパスもありません。** パッケージはビルド時にスキャンされ、スターターもビルド時に検出され、`lib/resources/` がクラスパスの役割を果たします。
- **シグナルを待ち受ける Dart プログラムは、自分からは決して終了しません。** これがシャットダウンフックの扱いを変えます。
- **黙って無視される古い名前は害になります。** そのため、名前が変わったキーは警告ではなく起動を止めます。

## 例

両者での同じアプリケーション:

```dart
@SpringBootApplication()
void main(List<String> args) => runApplication(args);
```

```java
@SpringBootApplication
public class NeonBooks {
  public static void main(String[] args) {
    SpringApplication.run(NeonBooks.class, args);
  }
}
```

## 起動

| Spring Boot | ここでは | 理由 |
|---|---|---|
| クラスに `@SpringBootApplication`。起動時にクラスパスをスキャンする | `main` 関数に付ける。パッケージは `build_runner` がスキャンし、生成される `springApplication` が Bean とスターターを列挙する | リフレクションがない |
| `SpringApplication.run` はランナーの後に戻る | `runApplication` は同期部分の後に戻る。`runApplicationAsync` はランナーを待つ | ランナーは非同期でありうる |
| `META-INF/spring.factories` の `EnvironmentPostProcessor`、`FailureAnalyzer`、リスナー | `SpringApplication` のコンストラクターに渡す (アナライザーは Bean でもよい) | スキャンするクラスパスがない |
| スターターの `META-INF/spring.factories` のそれ以外のエントリー。`SpringFactoriesLoader.loadFactories(type, classLoader)` で読む | その `@AutoConfigurationModule` の `factories` にある定数。ジェネレーターが生成される `springApplication` にコピーする。`SpringApplication.factories.load<T>()` または `springFactories` Bean で読む。[ファクトリー](auto-configuration.md#ファクトリー) を参照 | スキャンするクラスパスがない |
| `Started app in 0.07 seconds (process running for 0.3)` | プロセスの稼働時間なし | Dart にはプロセスの開始時刻がない |
| バナーは `System.out` に出力される。`banner.txt` の `${application.version}`、`${AnsiColor.*}` | `print` (またはログ)。`${spring-boot.version}`、`${spring-boot.formatted-version}`、Environment のプレースホルダー | マニフェストのバージョンも ANSI のプロパティソースもない |
| `spring.main.allow-circular-references=true` | 対応しない: 循環は常にエラー。`@Lazy()` か `ObjectProvider` を使う | シングルトンの早期参照がない |
| 起動の進捗のフックはない | `StartupProgress` を使う `SpringApplication.progressListener` | モバイルアプリのスプラッシュ画面 |

## 設定ファイルとロケーション

| Spring Boot | ここでは | 理由 |
|---|---|---|
| `classpath:` | `resources:` (`lib/resources/`。ジェネレーターが埋め込む) | クラスパスがない |
| `.properties` は ISO-8859-1 として読まれる | UTF-8。ロケーションに `[encoding=iso-8859-1]`、または `PropertiesPropertySourceLoader(encoding: latin1)` | Dart のファイルは UTF-8 |
| エンコーディングのヒントに任意の Java の文字セット | UTF-8、ISO-8859-1、US-ASCII のみ。それ以外は起動を失敗させる | Dart のコーデック |
| YAML 1.1 (SnakeYAML) | YAML 1.2: `on`、`off`、`yes`、`no` は文字列のまま (`bool` には変換できる)。`0777` は 777 | Dart チームの YAML パーサー |
| `application.xml` と `.xml` のインポート | 読まれない。`x.xml` は起動を失敗させる | `Properties.loadFromXML` がない |
| `env:` のインポート、`classpath*:` のロケーション | 対応しない | |
| `#---` の直後のコメントはドキュメントを結合する | ドキュメントは分かれたまま | 書かれたとおりに読む |
| `;` のグループでは、空白は保たれ、空のエントリーはインポート元のディレクトリになる | 空白は取り除かれ、空のエントリーはスキップされる | |
| `;` のグループのリゾルバーは最初のエントリーから決まる | 各エントリーはそれぞれのプレフィックスで読まれる | |
| ワイルドカードで見つかったファイル内の相対インポートは、パターンを基準に解決される | そのファイルを基準に | |
| ファイルである `configtree:` のロケーションは、`optional:` でも失敗する | ないものとみなされる | |
| `--dart-define` はない | `--dart-define` の値は、コマンドラインのすぐ下のソース | Flutter と Web のアプリにはコマンドラインがない |
| Spring Cloud Config を通した HTTP のインポート | 非同期の起動での `spring.config.import=https://...`。設定サーバーのクライアントはない | |

## プロファイル

| Spring Boot | ここでは |
|---|---|
| Spring Boot 4.1 は、プロファイルに限定されたドキュメントから `spring.profiles.active`、`.default`、`.group.*` を読む | Spring Boot のドキュメントの記述どおり、ドキュメントが適用される場合は起動を失敗させ、適用されない場合は無視する |
| `on-profile` と `spring.config.import` のプレースホルダーは、最初のパスで一度だけ解決される | `on-profile` はプロファイルが決まった時点で、インポートは読まれた時点で解決される |
| 抜けのあるプロファイルグループのリストは起動を失敗させる | 抜けのところまで読む |
| `Profiles.of` は一部の不正な式 (`(dev`、`a &`) を受け入れる | `Malformed profile expression` で失敗する |
| プラットフォームのプロファイルはない | Flutter アプリは `android`、`ios`、`web`、`macos`、`windows`、`linux`、`mobile`、`desktop` と `debug`、`profile`、`release` を得る |

## バインド

| Spring Boot | ここでは | 理由 |
|---|---|---|
| `@EnableConfigurationProperties`、`@ConfigurationPropertiesScan`、ゲッターとセッター | どれも不要。フィールドは直接バインドされる | アノテーションがクラスを Bean にする |
| コンストラクターバインドは、ないプロパティに `null` を渡す | 非 nullable のスカラーがないと起動が止まる。ないコレクションは空、ないネストしたオブジェクトはそのデフォルトを得る | 非 nullable の型 |
| `@ConstructorBinding` がコンストラクターを選ぶ | public な生成的コンストラクターが一つだけで、それがパラメーターを持つクラスのみ | 実装されていない |
| `@DurationUnit(ChronoUnit.SECONDS)` | `@DurationUnit(ChronoUnit.seconds)`。月と年はない | Dart の `Duration` |
| `BindHandler.onFailure` は代わりの値を返す | 失敗を数えるかどうかを返す | エラーは集められ、まとめて報告される |

## 名前が変わったキー

| Spring Boot | ここでは |
|---|---|
| `spring.jackson.*` | `spring.json.*` |
| `spring.cloud.openfeign.*` | `spring.feign.*` |
| `spring.servlet.multipart.*` | `spring.web.multipart.*` |
| `server.servlet.*` | `server.*` |
| `logging.logback.rollingpolicy.*` | `logging.file.rolling-policy.*` |
| `spring.flyway.*` | `spring.sql.migration.*` |

`spring-boot-properties-migrator` は警告するだけです。ここでは、どのソースにある古い名前も起動を止め、新しいキーを示します。

## このプロジェクト独自のキー

`spring.messages.default-locale` (アプリには意味のあるシステムロケールがないことが多い)、Dart VM のホットリロードのための `spring.devtools.restart.enabled`、`spring.remote.allow-insecure`、そして `spring.main.register-shutdown-hook` のデフォルト `false`。

## 自動構成と条件

| Spring Boot | ここでは | 理由 |
|---|---|---|
| 起動時にクラスパスから読まれる `AutoConfiguration.imports` | ビルド時に読まれる `lib/spring_auto_configuration.dart`。新しいスターターには再ビルドが必要 | クラスパスがない |
| クラスの `@AutoConfiguration(before, after)`、`@AutoConfigureOrder` | `@AutoConfigurationModule` の `order`、`before`、`after`。クラスは短い名前で指定する | 単位はモジュール |
| `exclude` はクラスを比較する | `Type` は単純名で比較される | 実行時の `Type` からは名前しか得られない |
| `@ConditionalOnBean(annotation = Service.class)` はメタアノテーションを付けた Bean も見つける | まさにそのアノテーションクラスのみ | アノテーションは普通のオブジェクト |
| `@ConditionalOnClass`、`@ConditionalOnWebApplication` | 利用できない | 実行時にクラスを検索できない |
| レポートは各結果を説明する | 各条件とそれが一致したかどうかを示す | 条件は普通の Dart オブジェクト |
| ビルド時のスイッチはない | `AutoConfigurationModule(build:)` がモジュールをリリースから除く | アプリを小さくする |
| Spring Boot の BOM | リリーストレインと、ビルド時にチェックされる `requires` | pub はパッケージごとに一つのバージョンに解決する |

## JSON

| Spring Boot | ここでは |
|---|---|
| Jackson のすべての機能を持つ `spring.jackson.*` | [組み込みの Bean](built-in-beans.md) のキーを持つ `spring.json.*`。それ以外は警告されて無視される |
| 名前付きのタイムゾーン | `UTC` と固定オフセットのみ: Dart にはタイムゾーンデータベースがない |
| `JsonMapperBuilderCustomizer` は Jackson のビルダーを受け取る | 中核の `JsonMapperBuilder` を受け取る |

## ロギングとシャットダウン

| Spring Boot | ここでは | 理由 |
|---|---|---|
| シャットダウンフックは有効で、JVM の終了時に実行される | デフォルトで無効。SIGINT と SIGTERM でのみ動き、その後 `exit(130)` または `exit(143)` | Dart には終了フックがなく、シグナルのリスナーはプログラムを生かし続ける |
| ロガー名は Java のパッケージ | Dart のライブラリ名、または `SpringLog` に与えた名前 | |
| ログの日時はローカルのタイムゾーン | UTC (ロギングスターターを使う場合) | タイムゾーンデータベースがない |

## 対応していないもの

- `spring.main.allow-circular-references`、`none` 以外の `spring.main.web-application-type`。
- `env:` のインポート、XML のプロパティ、`.env` ファイル、Spring Cloud Config、Consul と Vault のクライアント。
- `logging.config`、`logging.structured.*`。
- `@WebMvcTest` のようなテストスライス。

## 関連項目

- [spring_boot_dart](index.md)
- [すべてのプロパティ](properties.md)
- [外部設定](configuration/index.md)
- [ジェネレーターの違い](../spring-core-dart-generator/differences.md)
