程序包 cn.taketoday.context

接口 ConfigurableApplicationContext

所有超级接口:
ApplicationContext, ApplicationEventPublisher, AutoCloseable, BeanFactory, Closeable, DependencyInjectorProvider, cn.taketoday.core.env.EnvironmentCapable, HierarchicalBeanFactory, Lifecycle, MessageSource, cn.taketoday.core.io.PatternResourceLoader, cn.taketoday.core.io.ResourceLoader
所有已知实现类:
AbstractApplicationContext, AbstractRefreshableApplicationContext, AbstractRefreshableConfigApplicationContext, AbstractXmlApplicationContext, AnnotationConfigApplicationContext, ClassPathXmlApplicationContext, FileSystemXmlApplicationContext, GenericApplicationContext, GenericXmlApplicationContext, StandardApplicationContext, StaticApplicationContext
public interface ConfigurableApplicationContext extends ApplicationContext, Lifecycle, Closeable
SPI interface to be implemented by most if not all application contexts. Provides facilities to configure an application context in addition to the application context client methods in the ApplicationContext interface.

Configuration and lifecycle methods are encapsulated here to avoid making them obvious to ApplicationContext client code. The present methods should only be used by startup and shutdown code.

作者:
Juergen Hoeller, Chris Beams, Sam Brannen, TODAY 2018-11-14 21:16

  • 字段详细资料

    • CONFIG_LOCATION_DELIMITERS

      static final String CONFIG_LOCATION_DELIMITERS
      Any number of these characters are considered delimiters between multiple context config paths in a single String value.
      另请参阅:

    • CONVERSION_SERVICE_BEAN_NAME

      static final String CONVERSION_SERVICE_BEAN_NAME
      Name of the ConversionService bean in the factory. If none is supplied, default conversion rules apply.
      从以下版本开始:
      4.0
      另请参阅:

    • LOAD_TIME_WEAVER_BEAN_NAME

      static final String LOAD_TIME_WEAVER_BEAN_NAME
      Name of the LoadTimeWeaver bean in the factory. If such a bean is supplied, the context will use a temporary ClassLoader for type matching, in order to allow the LoadTimeWeaver to process all actual bean classes.
      从以下版本开始:
      4.0
      另请参阅:

    • SHUTDOWN_HOOK_THREAD_NAME

      static final String SHUTDOWN_HOOK_THREAD_NAME
      Name of the shutdown hook thread: "ContextShutdownHook".
      从以下版本开始:
      4.0
      另请参阅:

  • 方法详细资料

    • getEnvironment

      cn.taketoday.core.env.ConfigurableEnvironment getEnvironment()
      Get configurable environment
      指定者:
      getEnvironment 在接口中 ApplicationContext
      指定者:
      getEnvironment 在接口中 cn.taketoday.core.env.EnvironmentCapable
      返回:
      ConfigurableEnvironment never be null
      从以下版本开始:
      2.1.0

    • getBeanFactory

      ConfigurableBeanFactory getBeanFactory()
      Get AbstractBeanFactory
      指定者:
      getBeanFactory 在接口中 ApplicationContext
      返回:
      A bean factory

    • addBeanFactoryPostProcessor

      void addBeanFactoryPostProcessor(BeanFactoryPostProcessor postProcessor)
      Add a new BeanFactoryPostProcessor that will get applied to the internal bean factory of this application context on refresh, before any of the bean definitions get evaluated. To be invoked during context configuration.
      参数:
      postProcessor - the factory processor to register
      从以下版本开始:
      2.1.7

    • setId

      void setId(String id)
      Set the unique id of this application context.
      从以下版本开始:
      4.0

    • setParent

      void setParent(@Nullable ApplicationContext parent)
      Set the parent of this application context.

      Note that the parent shouldn't be changed: It should only be set outside a constructor if it isn't available when an object of this class is created, for example in case of WebApplicationContext setup.

      参数:
      parent - the parent context
      从以下版本开始:
      4.0

    • setEnvironment

      void setEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment)
      Set the Environment for this application context.
      参数:
      environment - the new environment
      从以下版本开始:
      4.0

    • addProtocolResolver

      void addProtocolResolver(cn.taketoday.core.io.ProtocolResolver resolver)
      Register the given protocol resolver with this application context, allowing for additional resource protocols to be handled.

      Any such resolver will be invoked ahead of this context's standard resolution rules. It may therefore also override any default rules.

      从以下版本开始:
      4.0

    • setClassLoader

      void setClassLoader(ClassLoader classLoader)
      Specify the ClassLoader to load class path resources and bean classes with.

      This context class loader will be passed to the internal bean factory.

      从以下版本开始:
      4.0
      另请参阅:
      • DefaultResourceLoader(ClassLoader)

    • refresh

      void refresh() throws ApplicationContextException
      Load or refresh the persistent representation of the configuration, which might be from Java-based configuration or some other format.

      As this is a startup method, it should destroy already created singletons if it fails, to avoid dangling resources. In other words, after invocation of this method, either all or no singletons at all should be instantiated.

      抛出:
      ApplicationContextException - if the bean factory could not be initialized
      IllegalStateException - if already initialized and multiple refresh attempts are not supported
      从以下版本开始:
      2.0.1

    • registerShutdownHook

      void registerShutdownHook()
      Register a shutdown hook with the JVM runtime, closing this context on JVM shutdown unless it has already been closed at that time.

      This method can be called multiple times. Only one shutdown hook (at max) will be registered for each context instance.

      The name of the shutdown hook thread should be SHUTDOWN_HOOK_THREAD_NAME.

      另请参阅:

    • close

      void close()
      Close this application context, releasing all resources and locks that the implementation might hold. This includes destroying all cached singleton beans.

      Note: Does not invoke close on a parent context; parent contexts have their own, independent lifecycle.

      This method can be called multiple times without side effects: Subsequent close calls on an already closed context will be ignored.

      指定者:
      close 在接口中 ApplicationContext
      指定者:
      close 在接口中 AutoCloseable
      指定者:
      close 在接口中 Closeable

    • addApplicationListener

      void addApplicationListener(ApplicationListener<?> listener)
      Add a new ApplicationListener that will be notified on context events such as context refresh and context shutdown.

      Note that any ApplicationListener registered here will be applied on refresh if the context is not active yet, or on the fly with the current event multicaster in case of a context that is already active.

      参数:
      listener - the ApplicationListener to register
      从以下版本开始:
      4.0
      另请参阅:

    • removeApplicationListener

      void removeApplicationListener(ApplicationListener<?> listener)
      Remove the given ApplicationListener from this context's set of listeners, assuming it got registered via addApplicationListener(cn.taketoday.context.ApplicationListener<?>) before.
      参数:
      listener - the ApplicationListener to deregister
      从以下版本开始:
      4.0

    • isActive

      boolean isActive()
      Determine whether this application context is active, that is, whether it has been refreshed at least once and has not been closed yet.
      返回:
      whether the context is still active
      从以下版本开始:
      4.0
      另请参阅: