パッケージ org.springframework.boot.test.autoconfigure.web.reactive

アノテーションインターフェース WebFluxTest

@TargetSE(TYPESE) @RetentionSE(RUNTIMESE) @DocumentedSE @InheritedSE @BootstrapWith(org.springframework.boot.test.autoconfigure.web.reactive.WebFluxTestContextBootstrapper.class) @ExtendWith(org.springframework.test.context.junit.jupiter.SpringExtension.class) @OverrideAutoConfiguration(enabled=false) @TypeExcludeFilters(WebFluxTypeExcludeFilter.class) @AutoConfigureCache @AutoConfigureJson @AutoConfigureWebFlux @AutoConfigureWebTestClient @ImportAutoConfiguration public @interface WebFluxTest
Spring WebFlux コンポーネントのみに焦点を当てた Spring WebFlux テストに使用できるアノテーション。

このアノテーションを使用すると、WebFlux テストに関連する自動構成のみが有効になります。同様に、コンポーネントスキャンは、次のアノテーションが付けられた Bean に制限されます。

また、次のものを実装する Bean もあります。

  • Converter
  • GenericConverter
  • IDialect（Thymeleaf が利用可能な場合）
  • Module（Jackson が利用可能な場合）
  • WebExceptionHandler
  • WebFluxConfigurer
  • WebFilter

デフォルトでは、@WebFluxTest でアノテーションが付けられたテストも WebTestClient を自動構成します。WebTestClient をより細かく制御するには、@AutoConfigureWebTestClient アノテーションを使用できます。

通常、@WebFluxTest は @MockBean または @Import と組み合わせて使用され、@Controller Bean に必要なコラボレーターを作成します。

アプリケーション構成全体をロードして WebTestClient を使用する場合は、このアノテーションではなく、@SpringBootTest と @AutoConfigureWebTestClient の組み合わせを検討する必要があります。

JUnit 4 を使用する場合、このアノテーションは @RunWith(SpringRunner.class) と組み合わせて使用する必要があります。

導入:
2.0.0
作成者:
Stephane Nicoll, Artsiom Yudovin
関連事項:

  • オプション要素の概要

    オプション要素
    修飾子と型
    オプションの要素
    説明
    ClassSE<?>[]
    controllers
    テストするコントローラーを指定します。
    ClassSE<?>[]
    excludeAutoConfiguration
    このテストに適用する必要がある自動構成の除外。
    ComponentScan.Filter[]
    excludeFilters
    それ以外の場合はアプリケーションコンテキストに追加される Bean のフィルタリングに使用できる除外フィルターのセット。
    ComponentScan.Filter[]
    includeFilters
    他の方法でフィルタリングされた Bean をアプリケーションコンテキストに追加するために使用できる一連の組み込みフィルター。
    StringSE[]
    properties
    テストの実行前に Spring Environment に追加する必要がある key = value 形式のプロパティ。
    boolean
    useDefaultFilters
    @SpringBootApplication でデフォルトのフィルタリングを使用するかどうかを決定します。
    ClassSE<?>[]
    value
    テストするコントローラーを指定します。

  • 要素の詳細

    • properties

      StringSE[] properties
      テストの実行前に Spring Environment に追加する必要がある key = value 形式のプロパティ。
      戻り値:
      追加するプロパティ
      導入:
      2.1.0
      デフォルト:
      {}

    • value

      @AliasFor("controllers") ClassSE<?>[] value
      テストするコントローラーを指定します。これは、他の属性が定義されていない場合に簡潔にするために使用できる controllers() のエイリアスです。詳細については、controllers() を参照してください。
      戻り値:
      テストするコントローラー
      関連事項:
      デフォルト:
      {}

    • controllers

      @AliasFor("value") ClassSE<?>[] controllers
      テストするコントローラーを指定します。すべての @Controller Bean をアプリケーションコンテキストに追加する必要がある場合は、空白のままにすることができます。
      戻り値:
      テストするコントローラー
      関連事項:
      デフォルト:
      {}

    • useDefaultFilters

      boolean useDefaultFilters
      @SpringBootApplication でデフォルトのフィルタリングを使用するかどうかを決定します。デフォルトでは、@Controller （明示的な controllers が定義されていない場合）、@ControllerAdvice および WebFluxConfigurer Bean のみが含まれます。
      戻り値:
      デフォルトのフィルターを使用する必要がある場合
      関連事項:
      デフォルト:
      true

    • includeFilters

      ComponentScan.Filter[] includeFilters
      他の方法でフィルタリングされた Bean をアプリケーションコンテキストに追加するために使用できる一連の組み込みフィルター。
      戻り値:
      適用するフィルターを含める
      デフォルト:
      {}

    • excludeFilters

      ComponentScan.Filter[] excludeFilters
      それ以外の場合はアプリケーションコンテキストに追加される Bean のフィルタリングに使用できる除外フィルターのセット。
      戻り値:
      適用するフィルターを除外する
      デフォルト:
      {}

    • excludeAutoConfiguration

      @AliasFor(annotation=ImportAutoConfiguration.class, attribute="exclude") ClassSE<?>[] excludeAutoConfiguration
      このテストに適用する必要がある自動構成の除外。
      戻り値:
      適用する自動構成除外
      デフォルト:
      {}