テスト

package:spring_boot_starter_flutter_security/testing.dart は、spring_security_core のテストヘルパー withMockUser、withAuthentication、withAnonymousUser を再エクスポートします。アプリのテストに他の依存関係は不要です。ウィジェットテストでは、パッケージの Bean は他の Bean と同じように置き換えます。

使う理由

ガードされたサービス、PrincipalView、ガードされた画面のテストには、プロバイダーやログインウィンドウなしのユーザーが必要です。ヘルパーはユーザーとしてコードを実行し、Bean のオーバーライドは、テストのマシンにないプラットフォームの部品 (安全なストレージ、ウィンドウ) を置き換えます。

例

import 'package:spring_boot_starter_flutter_security/testing.dart';
import 'package:test/test.dart';

void main() {
  test('an admin sees the orders', () async {
    await withMockUser(() async {
      expect(await orders.all(), isNotEmpty);
    }, roles: ['ADMIN']);
  });
}

ウィジェットテストでのフェイク

パッケージのすべての Bean は、アプリケーションがその型のものを宣言すると身を引き、springBootTest(overrides:) がそれらを置き換えます。

final app = springBootTest(
  springApplication,
  overrides: [
    BeanOverride<SecretStore>(InMemorySecretStore()),   // テストのマシンにキーチェーンはない
    BeanOverride<OAuth2LoginService>(FakeLoginService()), // プロバイダーなし
  ],
);
Bean 置き換えるもの
SecretStore InMemorySecretStore
OAuth2LoginService ユーザーを SecurityContextHolder に置くフェイク
AuthorizationWindow リダイレクトで応答するフェイク。偽のプロバイダーに対して本物のログインのサービスをテストするため
DPoPKey Dart で作った鍵

PrincipalNotifier は SecurityContextHolder に従うので、withMockUser も偽のログインも、PrincipalBuilder と PrincipalView を再ビルドします。

Spring (Java) との対応

spring-security-test の @WithMockUser です。

関連項目