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;。

関連項目