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

要素の詳細

• value

  @AliasFor("locations") StringSE[] value

  locations() のエイリアス。

  この属性は、locations() と組み合わせて使用することはできませんが、locations() の代わりに使用することができます。

  導入:

  3.0

  関連事項:

  • inheritLocations()

  デフォルト:

  {}

• locations

  @AliasFor("value") StringSE[] locations

  ApplicationContext のロードに使用するリソースの場所。

  特に相対パスの場合に、実行時に場所がどのように解釈されるかについての詳細は、AbstractContextLoader.modifyLocations() の Javadoc を確認してください。また、指定されていない場合に使用されるデフォルトの場所の詳細については、AbstractContextLoader.generateDefaultLocations() のドキュメントを参照してください。

  前述のデフォルトルールは、locations が設定されている場合に実行時に使用される効果的なデフォルト実装である GenericXmlContextLoader や GenericGroovyXmlContextLoader などの標準 AbstractContextLoader サブクラスにのみ適用されることに注意してください。デフォルトローダーの詳細については、loader() のドキュメントを参照してください。

  この属性は、value() と組み合わせて使用することはできませんが、value() の代わりに使用することができます。

  導入:

  2.5

  関連事項:

  • inheritLocations()

  デフォルト:

  {}

• classes

  ClassSE<?>[] classes

  ApplicationContext のロードに使用するコンポーネントクラス。

  コンポーネントクラスが指定されていない場合のデフォルト構成クラスの検出方法の詳細については、AnnotationConfigContextLoader.detectDefaultConfigurationClasses() の javadoc を確認してください。デフォルトローダーの詳細については、loader() のドキュメントを参照してください。

  導入:

  3.1

  関連事項:

  • Configuration
  • AnnotationConfigContextLoader
  • inheritLocations()

  デフォルト:

  {}

• initializers

  ClassSE<? extends ApplicationContextInitializer<?>>[] initializers

  ConfigurableApplicationContext の初期化に使用するアプリケーションコンテキスト初期化子クラス。

  宣言された各イニシャライザーによってサポートされる具体的な ConfigurableApplicationContext 型は、使用中の SmartContextLoader によって作成された ApplicationContext の型と互換性がなければなりません。

  SmartContextLoader 実装は通常、Spring の Ordered インターフェースが実装されているかどうか、@Order アノテーションが存在するかどうかを検出し、呼び出す前にインスタンスをソートします。

  導入:

  3.2

  関連事項:

  • ApplicationContextInitializer
  • ConfigurableApplicationContext
  • inheritInitializers()
  • loader()

  デフォルト:

  {}

• inheritLocations

  boolean inheritLocations

  テストスーパークラスおよびエンクロージングクラスからのリソースの場所またはコンポーネントクラスを継承するかどうか。

  デフォルト値は true です。これは、アノテーション付きのテストクラスが、テストスーパークラスとそれを囲むクラスによって定義されたリソースの場所またはコンポーネントクラスを継承することを意味します。具体的には、特定のテストクラスのリソースの場所またはコンポーネントクラスが、テストスーパークラスおよびそれを囲むクラスによって定義されたリソースの場所またはコンポーネントクラスのリストに追加されます。サブクラスとネストされたクラスには、リソースの場所またはコンポーネントクラスのリストを拡張するオプションがあります。

  inheritLocations が false に設定されている場合、アノテーション付きテストクラスのリソースの場所またはコンポーネントクラスは、スーパークラスおよびそれを囲むクラスによって定義されたリソースの場所またはコンポーネントクラスをシャドウイングして効果的に置き換えます。

  パスベースのリソースロケーションを使用する次の例では、ExtendedTest の ApplicationContext が "base-context.xml" および "extended-context.xml" からこの順序でロードされます。"extended-context.xml" で定義された Bean は、"base-context.xml" で定義された Bean をオーバーライドできます。

   @ContextConfiguration("base-context.xml")
   public class BaseTest {
       // ...
   }
  
   @ContextConfiguration("extended-context.xml")
   public class ExtendedTest extends BaseTest {
       // ...
   }
   

  同様に、コンポーネントクラスを使用する次の例では、ExtendedTest の ApplicationContext が BaseConfig および ExtendedConfig 構成クラスからこの順序でロードされます。ExtendedConfig で定義された Bean は、BaseConfig で定義された Bean をオーバーライドできます。

   @ContextConfiguration(classes=BaseConfig.class)
   public class BaseTest {
       // ...
   }
  
   @ContextConfiguration(classes=ExtendedConfig.class)
   public class ExtendedTest extends BaseTest {
       // ...
   }
   

  導入:

  2.5

  デフォルト:

  true

• inheritInitializers

  boolean inheritInitializers

  テストスーパークラスおよびそれを囲むクラスからのコンテキスト初期化子を継承する必要があるかどうか。

  デフォルト値は true です。これは、アノテーション付きのテストクラスが、テストスーパークラスとそれを囲むクラスによって定義されたアプリケーションコンテキスト初期化子を継承することを意味します。具体的には、特定のテストクラスの初期化子は、テストスーパークラスとそれを囲むクラスによって定義された初期化子のセットに追加されます。サブクラスとネストされたクラスには、初期化子のセットを拡張するオプションがあります。

  inheritInitializers が false に設定されている場合、アノテーション付きテストクラスの初期化子はシャドウになり、スーパークラスとそれを囲むクラスによって定義された初期化子を効果的に置き換えます。

  次の例では、ExtendedTest の ApplicationContext は、BaseInitializer および ExtendedInitializer を使用して初期化されます。ただし、イニシャライザーが呼び出される順序は、イニシャライザーが Ordered を実装しているか、@Order でアノテーションが付けられているかによって異なることに注意してください。

   @ContextConfiguration(initializers = BaseInitializer.class)
   public class BaseTest {
       // ...
   }
  
   @ContextConfiguration(initializers = ExtendedInitializer.class)
   public class ExtendedTest extends BaseTest {
       // ...
   }
   

  導入:

  3.2

  デフォルト:

  true

• loader

  ClassSE<? extends ContextLoader> loader

  ApplicationContext のロードに使用する SmartContextLoader（または ContextLoader）の型。

  指定しない場合、ローダーは、@ContextConfiguration でアノテーションが付けられた、またはメタアノテーションが付けられ、明示的なローダーを指定する最初のスーパークラスまたはそれを囲むクラスから継承されます。型階層またはそれを囲むクラス階層に明示的なローダーが指定されていない場合は、代わりにデフォルトのローダーが使用されます。

  実行時に選択されるデフォルトの具象実装は、@WebAppConfiguration の有無に応じて DelegatingSmartContextLoader または WebDelegatingSmartContextLoader になります。さまざまな具象 SmartContextLoaders のデフォルトの動作の詳細については、Javadoc で AbstractContextLoader、GenericXmlContextLoader、GenericGroovyXmlContextLoader、AnnotationConfigContextLoader、GenericXmlWebContextLoader、GenericGroovyXmlWebContextLoader、AnnotationConfigWebContextLoader を確認してください。

  導入:

  2.5

  デフォルト:

  org.springframework.test.context.ContextLoader.class

• name

  StringSE name

  この構成で表されるコンテキスト階層レベルの名前。

  指定しない場合、名前は、階層内で宣言されたすべてのコンテキスト内の数値レベルに基づいて推測されます。

  この属性は、@ContextHierarchy を使用して構成されたテストクラス階層または囲みクラス階層内で使用される場合にのみ適用されます。この場合、この名前は、スーパークラスまたは囲みで定義された階層レベルの同じ名前の構成とこの構成をマージまたはオーバーライドするために使用できます。クラス。詳細については、@ContextHierarchy の Javadoc を参照してください。

  導入:

  3.2.2

  デフォルト:

  ""