要素の詳細

• value

  @AliasFor(value="locations")
  public abstract java.lang.String[] value

  locations() のエイリアス。

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

  導入:

  3.0

  関連事項:

  inheritLocations()

  デフォルト:

  {}

• locations

  @AliasFor(value="value")
  public abstract java.lang.String[] locations

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

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

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

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

  導入:

  2.5

  関連事項:

  inheritLocations()

  デフォルト:

  {}

• classes

  public abstract java.lang.Class<?>[] classes

  ApplicationContext のロードに使用するアノテーション付きクラス。

  アノテーション付きクラスが指定されていない場合にデフォルトの構成クラスがどのように検出されるかについて詳しくは、AnnotationConfigContextLoader.detectDefaultConfigurationClasses() の javadoc を確認してください。デフォルトローダーの詳細については、loader() のドキュメントを参照してください。

  導入:

  3.1

  関連事項:

  Configuration, AnnotationConfigContextLoader, inheritLocations()

  デフォルト:

  {}

• initializers

  public abstract java.lang.Class<? extends ApplicationContextInitializer<?>>[] initializers

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

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

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

  導入:

  3.2

  関連事項:

  ApplicationContextInitializer, ConfigurableApplicationContext, inheritInitializers(), loader()

  デフォルト:

  {}

• inheritLocations

  public abstract boolean inheritLocations

  resource locations またはテストスーパークラスのアノテーション付きクラスを継承するかどうか。

  デフォルト値は 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

  public abstract 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

  public abstract java.lang.Class<? 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

  public abstract java.lang.String name

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

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

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

  導入:

  3.2.2

  デフォルト:

  ""