パッケージ org.springframework.boot.test.autoconfigure.orm.jpa

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

@TargetSE(TYPESE) @RetentionSE(RUNTIMESE) @DocumentedSE @InheritedSE @BootstrapWith(org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTestContextBootstrapper.class) @ExtendWith(org.springframework.test.context.junit.jupiter.SpringExtension.class) @OverrideAutoConfiguration(enabled=false) @TypeExcludeFilters(DataJpaTypeExcludeFilter.class) @Transactional @AutoConfigureCache @AutoConfigureDataJpa @AutoConfigureTestDatabase @AutoConfigureTestEntityManager @ImportAutoConfiguration public @interface DataJpaTest
JPA コンポーネントのみに焦点を当てた JPA テストのアノテーション。

このアノテーションを使用すると、Data JPA テストに関連する自動構成のみが有効になります。同様に、コンポーネントスキャンは JPA リポジトリとエンティティ (@Entity) に制限されます。

デフォルトでは、@DataJpaTest アノテーションが付けられたテストはトランザクションであり、各テストの終わりにロールバックします。また、組み込みのインメモリデータベースを使用します（明示的または通常自動構成された DataSource を置き換えます）。@AutoConfigureTestDatabase アノテーションを使用して、これらの設定をオーバーライドできます。

SQL クエリは、spring.jpa.show-sql プロパティを true に設定することにより、デフォルトでログに記録されます。これは、showSql 属性を使用して無効にできます。

完全なアプリケーション構成をロードしたいが、埋め込みデータベースを使用する場合は、このアノテーションではなく、@SpringBootTest と @AutoConfigureTestDatabase の組み合わせを検討する必要があります。

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

導入:
1.4.0
作成者:
Phillip Webb, Artsiom Yudovin, Scott Frederick
関連事項:

  • オプション要素のサマリー

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

  • 要素の詳細

    • properties

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

    • showSql

      @PropertyMapping("spring.jpa.show-sql") boolean showSql
      SQL 出力をログに記録する必要がある場合。
      戻り値:
      SQL がログに記録されている場合
      デフォルト:
      true

    • bootstrapMode

      @PropertyMapping("spring.data.jpa.repositories.bootstrap-mode") org.springframework.data.repository.config.BootstrapMode bootstrapMode
      テストリポジトリサポート用の BootstrapMode。デフォルトは BootstrapMode.DEFAULT です。
      戻り値:
      リポジトリのテストに使用する BootstrapMode 
      デフォルト:
      DEFAULT

    • useDefaultFilters

      boolean useDefaultFilters
      @SpringBootApplication でデフォルトのフィルタリングを使用するかどうかを決定します。デフォルトでは、Bean は含まれません。
      戻り値:
      デフォルトのフィルターを使用する必要がある場合
      関連事項:
      デフォルト:
      true

    • includeFilters

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

    • excludeFilters

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

    • excludeAutoConfiguration

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