
# Spring との違い

`spring_boot_starter_test` は Spring Boot のテストサポートに従っています。`@SpringBootTest`、`@TestBean`、`MockMvc`、`ApplicationContextRunner`、Testcontainers です。このページでは、そうでない箇所とその理由を列挙します。

## 使う理由

Dart のテストランナーは `package:test` で、テストファイルは `main` 関数であり、実行時にモックを作ったりテストクラスをスキャンしたりするリフレクションはありません。スターターは Spring の名前と形を保ち、それをジェネレーターが書ける関数の上に組み立てています。

## 例

```dart
// ここでは: 関数。テストクラスはそこに生成される
final app = springBootTest(springApplication, profiles: ['test']);
```

```java
// Spring: アノテーションを付けたクラス
@SpringBootTest
@ActiveProfiles("test")
class ShopTest { ... }
```

## 違い

| Spring Boot | ここでは | 理由 |
|---|---|---|
| クラスに `@SpringBootTest` | `main` や `group` のテストのための `springBootTest`。クラスは `void main() => runSpringTests();` とともにそこに生成される | テストファイルは `main` 関数 |
| コンテキストのキャッシュがテストクラス間でコンテキストを共有する | 各 `springBootTest` は自分のコンテキストを起動し、それをその `main` や `group` のテストが共有する | 各テストファイルは個別にコンパイルされ実行される |
| `@MockitoBean` はモックやスパイを生成し、各テストの後にリセットする | `BeanOverride` と `@TestBean` は出来上がったオブジェクトを受け取る。何もリセットされない | リフレクションがない。任意のモックライブラリを使い、`setUp` でリセットする |
| 既存の Bean がないオーバーライドは失敗する | インスタンスが追加される | |
| `@AutoConfigureMockMvc` | 不要: Web スターターがあれば `app.mockMvc` は常に動く | |
| `status().isOk()`、`jsonPath(...)` | マッチャーを使う `andExpect(status:, json:)` | Dart の `matcher` |
| `WebTestClient`、`TestRestTemplate` | なし: `localServerPort` に対して Feign クライアントか `HttpClient` | |
| テストスライス (`@WebMvcTest`、`@DataJpaTest`...) と `@TestConfiguration` | `spring_boot_starter_data` の `@DataTest` のみ。構成の一部には追加のモジュールか `ApplicationContextRunner` | |
| テストはマシンの環境変数を見る | `systemEnvironment` (`@TestEnvironment`) で設定しない限り空 | マシンに依存しないテスト |
| `classMode` と `methodMode` を持つ `@DirtiesContext` | クラスに付けると各テストの後、メソッドに付けるとその後。モードはない | いずれにせよ各クラスは自分のコンテキストを持つ |
| static メソッドの `@DynamicPropertySource`、`DynamicPropertyRegistrar` の Bean | `dynamicProperties:` パラメーター、または static な `@DynamicPropertySource()` メソッド。レジストラーの Bean はない | |
| `@Nested` の内部クラス | インスタンスを持つ `@Nested()` フィールド | Dart には内部クラスがない |
| テストクラスでのコンストラクター注入 | フィールドのみ | 生成コードがクラスを生成する |
| `OutputCaptureExtension` | `SpringLog` のレコードのための `captureLogs` と `@CapturedOutput()` | |
| `ApplicationContextRunner.withBean(Class, Supplier)` | `withBean<T>(supplier)`。`withBeanOverride` と `withSystemEnvironment` を追加 | クラスの代わりに型引数 |
| `withAllowCircularReferences(true)` | すべての実行を失敗させる | 早期参照がない |
| `@Testcontainers` は Docker がないと失敗する | クラスはスキップされる。`CONTAINERS_REQUIRED=true` で失敗させる | |
| Testcontainers のモジュール、ネットワーク、Compose | `PostgresContainer`、`KeycloakContainer`、`GenericContainer`、`Network`。Compose はない | |

## 名前の衝突

`package:test` (`matcher` を通して) と `spring_core_dart` はどちらも `Description` を定義しています (`spring_core_dart` のものは `@Description` アノテーションです)。テストファイルがそれを使う場合にだけ問題になります: `import 'package:test/test.dart' hide Description;`。

## 関連項目

- [spring_boot_starter_test](index.md)
- [spring_boot_dart の違い](../spring-boot-dart/differences.md)
