Spring との違い
spring_boot_starter_test は Spring Boot のテストサポートに従っています。@SpringBootTest、@TestBean、MockMvc、ApplicationContextRunner、Testcontainers です。このページでは、そうでない箇所とその理由を列挙します。
使う理由
Dart のテストランナーは package:test で、テストファイルは main 関数であり、実行時にモックを作ったりテストクラスをスキャンしたりするリフレクションはありません。スターターは Spring の名前と形を保ち、それをジェネレーターが書ける関数の上に組み立てています。
例
// ここでは: 関数。テストクラスはそこに生成される
final app = springBootTest(springApplication, profiles: ['test']);
// 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;。