程序包 cn.taketoday.test.context.support

类 AbstractContextLoader

java.lang.Object
cn.taketoday.test.context.support.AbstractContextLoader
所有已实现的接口:
ContextLoader, SmartContextLoader
直接已知子类:
AbstractGenericContextLoader, AbstractGenericWebContextLoader, InfraApplicationContextLoader
public abstract class AbstractContextLoader extends Object implements SmartContextLoader
Abstract application context loader that provides a basis for all concrete implementations of the ContextLoader SPI. Provides a Template Method based approach for processing resource locations.

AbstractContextLoader also provides a basis for all concrete implementations of the SmartContextLoader SPI. For backwards compatibility with the ContextLoader SPI, processContextConfiguration(ContextConfigurationAttributes) delegates to processLocations(Class, String...).

从以下版本开始:
4.0
作者:
Sam Brannen, Juergen Hoeller, Phillip Webb, Harry Yang
另请参阅:

  • 字段详细资料

    • log

      private static final cn.taketoday.logging.Logger log

    • SLASH

      private static final String SLASH
      另请参阅:

    • EMPTY_STRING_ARRAY

      private static final String[] EMPTY_STRING_ARRAY

  • 构造器详细资料

    • AbstractContextLoader

      public AbstractContextLoader()

  • 方法详细资料

    • processContextConfiguration

      public void processContextConfiguration(ContextConfigurationAttributes configAttributes)
      The default implementation processes locations analogous to processLocations(Class, String...), using the declaring class as the test class and the resource locations retrieved from the supplied configuration attributes as the locations to process. The processed locations are then set in the supplied configuration attributes.

      Can be overridden in subclasses — for example, to process annotated classes instead of resource locations.

      指定者:
      processContextConfiguration 在接口中 SmartContextLoader
      参数:
      configAttributes - the context configuration attributes to process
      另请参阅:

    • prepareContext

      protected void prepareContext(cn.taketoday.context.ConfigurableApplicationContext context, MergedContextConfiguration mergedConfig)
      Prepare the ConfigurableApplicationContext created by this SmartContextLoader before bean definitions are read.

      The default implementation:

      • Sets the active bean definition profiles from the supplied MergedContextConfiguration in the Environment of the context.
      • Adds PropertySources for all resource locations and inlined properties from the supplied MergedContextConfiguration to the Environment of the context.
      • Determines what (if any) context initializer classes have been supplied via the MergedContextConfiguration and instantiates and invokes each with the given application context.
        • Any ApplicationContextInitializers implementing Ordered or annotated with @Order will be sorted appropriately.
      参数:
      context - the newly created application context
      mergedConfig - the merged context configuration
      另请参阅:

    • invokeApplicationContextInitializers

      private void invokeApplicationContextInitializers(cn.taketoday.context.ConfigurableApplicationContext context, MergedContextConfiguration mergedConfig)

    • customizeContext

      protected void customizeContext(cn.taketoday.context.ConfigurableApplicationContext context, MergedContextConfiguration mergedConfig)
      Customize the ConfigurableApplicationContext created by this ContextLoader after bean definitions have been loaded into the context but before the context has been refreshed.

      The default implementation delegates to all context customizers that have been registered with the supplied mergedConfig.

      参数:
      context - the newly created application context
      mergedConfig - the merged context configuration

    • processLocations

      public final String[] processLocations(Class<?> clazz, String... locations)
      If the supplied locations are null or empty and isGenerateDefaultLocations() returns true, default locations will be generated (i.e., detected) for the specified class and the configured resource suffixes; otherwise, the supplied locations will be modified if necessary and returned.
      指定者:
      processLocations 在接口中 ContextLoader
      指定者:
      processLocations 在接口中 SmartContextLoader
      参数:
      clazz - the class with which the locations are associated: to be used when generating default locations
      locations - the unmodified locations to use for loading the application context (can be null or empty)
      返回:
      a processed array of application context resource locations
      另请参阅:

    • processLocationsInternal

      private String[] processLocationsInternal(Class<?> clazz, String... locations)

    • generateDefaultLocations

      protected String[] generateDefaultLocations(Class<?> clazz)
      Generate the default classpath resource locations array based on the supplied class.

      For example, if the supplied class is com.example.MyTest, the generated locations will contain a single string with a value of "classpath:com/example/MyTest<suffix>", where <suffix> is the value of the first configured resource suffix for which the generated location actually exists in the classpath.

      The implementation of this method adheres to the contract defined in the SmartContextLoader SPI. Specifically, this method will preemptively verify that the generated default location actually exists. If it does not exist, this method will log a warning and return an empty array.

      Subclasses can override this method to implement a different default location generation strategy.

      参数:
      clazz - the class for which the default locations are to be generated
      返回:
      an array of default application context resource locations
      另请参阅:

    • modifyLocations

      protected String[] modifyLocations(Class<?> clazz, String... locations)
      Generate a modified version of the supplied locations array and return it.

      The default implementation simply delegates to TestContextResourceUtils.convertToClasspathResourcePaths(java.lang.Class<?>, java.lang.String...).

      Subclasses can override this method to implement a different location modification strategy.

      参数:
      clazz - the class with which the locations are associated
      locations - the resource locations to be modified
      返回:
      an array of modified application context resource locations

    • isGenerateDefaultLocations

      protected boolean isGenerateDefaultLocations()
      Determine whether default resource locations should be generated if the locations provided to processLocations(Class, String...) are null or empty.

      The semantics of this method have been overloaded to include detection of either default resource locations or default configuration classes. Consequently, this method can also be used to determine whether default configuration classes should be detected if the classes present in the configuration attributes supplied to processContextConfiguration(ContextConfigurationAttributes) are null or empty.

      Can be overridden by subclasses to change the default behavior.

      返回:
      always true by default

    • getResourceSuffixes

      protected String[] getResourceSuffixes()
      Get the suffixes to append to ApplicationContext resource locations when detecting default locations.

      The default implementation simply wraps the value returned by getResourceSuffix() in a single-element array, but this can be overridden by subclasses in order to support multiple suffixes.

      返回:
      the resource suffixes; never null or empty
      另请参阅:

    • getResourceSuffix

      protected abstract String getResourceSuffix()
      Get the suffix to append to ApplicationContext resource locations when detecting default locations.

      Subclasses must provide an implementation of this method that returns a single suffix. Alternatively subclasses may provide a no-op implementation of this method and override getResourceSuffixes() in order to provide multiple custom suffixes.

      返回:
      the resource suffix; never null or empty
      另请参阅: