要素の詳細

• value

  @AliasFor(value="locations")
  public abstract StringSE[] value

  locations() のエイリアス。

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

  導入:

  3.0

  関連事項:

  inheritLocations()

  デフォルト:

  {}

• locations

  @AliasFor(value="value")
  public abstract StringSE[] locations

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

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

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

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

  導入:

  2.5

  関連事項:

  inheritLocations()

  デフォルト:

  {}

• classes

  public abstract ClassSE<?>[] classes

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

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

  導入:

  3.1

  関連事項:

  Configuration, AnnotationConfigContextLoader, inheritLocations()

  デフォルト:

  {}

• initializers

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

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

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

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

  導入:

  3.2

  関連事項:

  ApplicationContextInitializer, ConfigurableApplicationContext, inheritInitializers(), loader()

  デフォルト:

  {}

• inheritLocations

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

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

  public abstract StringSE name

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

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

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

  導入:

  3.2.2

  デフォルト:

  ""