Spring Context 6.1.4 · org.springframework.context.ApplicationContext

Central interface to provide configuration for an application. This is read-only while the application is running, but may be reloaded if the implementation supports this.

An ApplicationContext provides:

Bean factory methods for accessing application components. Inherited from org.springframework.beans.factory.ListableBeanFactory.
The ability to load file resources in a generic fashion. Inherited from the org.springframework.core.io.ResourceLoader interface.
The ability to publish events to registered listeners. Inherited from the ApplicationEventPublisher interface.
The ability to resolve messages, supporting internationalization. Inherited from the MessageSource interface.
Inheritance from a parent context. Definitions in a descendant context will always take priority. This means, for example, that a single parent context can be used by an entire web application, while each servlet has its own child context that is independent of that of any other servlet.

In addition to standard org.springframework.beans.factory.BeanFactory lifecycle capabilities, ApplicationContext implementations detect and invoke ApplicationContextAware beans as well as ResourceLoaderAware, ApplicationEventPublisherAware and MessageSourceAware beans.

Field Summary

Inherited from org.springframework.core.io.support.ResourcePatternResolver:: CLASSPATH_ALL_URL_PREFIX

Method Summary

Modifier and Type	Method and Description
public String	Returns: a name for the deployed application, or the empty String by default getApplicationName() Return a name for the deployed application that this context belongs to.
public AutowireCapableBeanFactory	Returns: the AutowireCapableBeanFactory for this context getAutowireCapableBeanFactory() Expose AutowireCapableBeanFactory functionality for this context.
public String	Returns: a display name for this context (never `null`) getDisplayName() Return a friendly name for this context.
public String	Returns: the unique id of the context, or `null` if none getId() Return the unique id of this application context.
public ApplicationContext	Returns: the parent context, or `null` if there is no parent getParent() Return the parent context, or `null` if there is no parent and this is the root of the context hierarchy.
public long	Returns: the timestamp (ms) when this context was first loaded getStartupDate() Return the timestamp when this context was first loaded.

Inherited from org.springframework.beans.factory.HierarchicalBeanFactory:: containsLocalBean getParentBeanFactory
Inherited from org.springframework.beans.factory.ListableBeanFactory:: containsBeanDefinition findAllAnnotationsOnBean findAnnotationOnBean findAnnotationOnBean getBeanDefinitionCount getBeanDefinitionNames getBeanNamesForAnnotation getBeanNamesForType getBeanNamesForType getBeanNamesForType getBeanNamesForType getBeanProvider getBeanProvider getBeansOfType getBeansOfType getBeansWithAnnotation
Inherited from org.springframework.context.ApplicationEventPublisher:: publishEvent publishEvent
Inherited from org.springframework.context.MessageSource:: getMessage getMessage getMessage
Inherited from org.springframework.core.env.EnvironmentCapable:: getEnvironment
Inherited from org.springframework.core.io.support.ResourcePatternResolver:: getResources

Method Detail

getApplicationName	back to summary
public String getApplicationName() Return a name for the deployed application that this context belongs to. Returns:String a name for the deployed application, or the empty String by default

getApplicationName

back to summary

public String getApplicationName()

Return a name for the deployed application that this context belongs to.

Returns:String: a name for the deployed application, or the empty String by default

getAutowireCapableBeanFactory back to summary

getAutowireCapableBeanFactory	back to summary
public AutowireCapableBeanFactory getAutowireCapableBeanFactory() throws IllegalStateException Expose AutowireCapableBeanFactory functionality for this context. This is not typically used by application code, except for the purpose of initializing bean instances that live outside the application context, applying the Spring bean lifecycle (fully or partly) to them. Alternatively, the internal BeanFactory exposed by the `ConfigurableApplicationContext` interface offers access to the `AutowireCapableBeanFactory` interface too. The present method mainly serves as a convenient, specific facility on the ApplicationContext interface. NOTE: As of 4.2, this method will consistently throw IllegalStateException after the application context has been closed. In current Spring Framework versions, only refreshable application contexts behave that way; as of 4.2, all application context implementations will be required to comply. Returns:AutowireCapableBeanFactory the AutowireCapableBeanFactory for this context Exceptions IllegalStateException: if the context does not support the `AutowireCapableBeanFactory` interface, or does not hold an autowire-capable bean factory yet (e.g. if `refresh()` has never been called), or if the context has been closed already See Also `ConfigurableApplicationContext#refresh()`, `ConfigurableApplicationContext#getBeanFactory()`

public AutowireCapableBeanFactory getAutowireCapableBeanFactory() throws IllegalStateException

Expose AutowireCapableBeanFactory functionality for this context.

This is not typically used by application code, except for the purpose of initializing bean instances that live outside the application context, applying the Spring bean lifecycle (fully or partly) to them.

Alternatively, the internal BeanFactory exposed by the ConfigurableApplicationContext interface offers access to the AutowireCapableBeanFactory interface too. The present method mainly serves as a convenient, specific facility on the ApplicationContext interface.

NOTE: As of 4.2, this method will consistently throw IllegalStateException after the application context has been closed. In current Spring Framework versions, only refreshable application contexts behave that way; as of 4.2, all application context implementations will be required to comply.

Returns:AutowireCapableBeanFactory

the AutowireCapableBeanFactory for this context

Exceptions

IllegalStateException:: if the context does not support the AutowireCapableBeanFactory interface, or does not hold an autowire-capable bean factory yet (e.g. if refresh() has never been called), or if the context has been closed already

getDisplayName back to summary

getDisplayName	back to summary
public String getDisplayName() Return a friendly name for this context. Returns:String a display name for this context (never `null`)

public String getDisplayName()

Return a friendly name for this context.

Returns:String: a display name for this context (never null)

getId back to summary

getId	back to summary
public String getId() Return the unique id of this application context. Returns:String the unique id of the context, or `null` if none Annotations @Nullable

public String getId()

Return the unique id of this application context.

Returns:String

the unique id of the context, or null if none

Annotations

@Nullable

getParent back to summary

getParent	back to summary
public ApplicationContext getParent() Return the parent context, or `null` if there is no parent and this is the root of the context hierarchy. Returns:ApplicationContext the parent context, or `null` if there is no parent Annotations @Nullable

public ApplicationContext getParent()

Return the parent context, or null if there is no parent and this is the root of the context hierarchy.

Returns:ApplicationContext

the parent context, or null if there is no parent

Annotations

@Nullable

getStartupDate	back to summary
public long getStartupDate() Return the timestamp when this context was first loaded. Returns:long the timestamp (ms) when this context was first loaded

getStartupDate

back to summary

public long getStartupDate()

Return the timestamp when this context was first loaded.

Returns:long: the timestamp (ms) when this context was first loaded

public Interface ApplicationContext

Field Summary

Method Summary

Method Detail