org.springframework.context

Interface ApplicationContextAware

All Superinterfaces:

org.springframework.beans.factory.Aware

All Known Implementing Classes:

ApplicationObjectSupport, EventListenerMethodProcessor, LiveBeansView, LocalValidatorFactoryBean, OptionalValidatorFactoryBean, ScheduledAnnotationBeanPostProcessor

public interface ApplicationContextAware
extends org.springframework.beans.factory.Aware

Interface to be implemented by any object that wishes to be notified of the ApplicationContext that it runs in.

Implementing this interface makes sense for example when an object requires access to a set of collaborating beans. Note that configuration via bean references is preferable to implementing this interface just for bean lookup purposes.

This interface can also be implemented if an object needs access to file resources, i.e. wants to call getResource, wants to publish an application event, or requires access to the MessageSource. However, it is preferable to implement the more specific ResourceLoaderAware, ApplicationEventPublisherAware or MessageSourceAware interface in such a specific scenario.

Note that file resource dependencies can also be exposed as bean properties of type Resource, populated via Strings with automatic type conversion by the bean factory. This removes the need for implementing any callback interface just for the purpose of accessing a specific file resource.

ApplicationObjectSupport is a convenience base class for application objects, implementing this interface.

For a list of all bean lifecycle methods, see the BeanFactory javadocs.

Author:

Rod Johnson, Juergen Hoeller, Chris Beams

See Also:

ResourceLoaderAware, ApplicationEventPublisherAware, MessageSourceAware, ApplicationObjectSupport, BeanFactoryAware

Method Summary

Modifier and Type	Method and Description
void	setApplicationContext(ApplicationContext applicationContext) Set the ApplicationContext that this object runs in.

Method Detail

setApplicationContext

void setApplicationContext(ApplicationContext applicationContext)
                    throws org.springframework.beans.BeansException

Set the ApplicationContext that this object runs in. Normally this call will be used to initialize the object.

Invoked after population of normal bean properties but before an init callback such as InitializingBean.afterPropertiesSet() or a custom init-method. Invoked after ResourceLoaderAware.setResourceLoader(org.springframework.core.io.ResourceLoader), ApplicationEventPublisherAware.setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher) and MessageSourceAware, if applicable.

Parameters:

applicationContext - the ApplicationContext object to be used by this object

Throws:

ApplicationContextException - in case of context initialization errors

org.springframework.beans.BeansException - if thrown by application context methods

See Also:

BeanInitializationException