org.springframework.context.support
Class AbstractApplicationContext

Direct Known Subclasses:

AbstractXmlApplicationContext, StaticApplicationContext

public abstract class AbstractApplicationContext

implements ConfigurableApplicationContext

Partial implementation of ApplicationContext. Doesn't mandate the type of storage used for configuration, but implements common functionality.

This class uses the Template Method design pattern, requiring concrete subclasses to implement protected abstract methods.

A message source may be supplied as a bean in the default bean factory, with the name "messageSource". Else, message resolution is delegated to the parent context.

Author:

Rod Johnson, Juergen Hoeller

Version: $Revision: 1.29 $

Since: January 21, 2001

See Also: refreshBeanFactory(), getBeanFactory(), MESSAGE_SOURCE_BEAN_NAME

public final static String MESSAGE_SOURCE_BEAN_NAME

Name of the MessageSource bean in the factory. If none is supplied, message resolution is delegated to the parent.

See Also:

MessageSource

public AbstractApplicationContext()

Create a new AbstractApplicationContext with no parent.

public AbstractApplicationContext(ApplicationContext parent)

Create a new AbstractApplicationContext with the given parent context.

Parameters:

parent - parent context

public void close()

Destroy the singletons in the bean factory of this application context.

public boolean containsBean(String name)

public boolean containsBeanDefinition(String name)

public String[] getAliases(String name)
                     throws org.springframework.beans.factory.NoSuchBeanDefinitionException

public Object getBean(String name)
                throws org.springframework.beans.BeansException

public Object getBean(String name, Class requiredType)
                throws org.springframework.beans.BeansException

public int getBeanDefinitionCount()

public String[] getBeanDefinitionNames()

public String[] getBeanDefinitionNames(Class type)

public abstract ConfigurableListableBeanFactory getBeanFactory()

Subclasses must return their internal bean factory here. They should implement the lookup efficiently, so that it can be called repeatedly without a performance penalty.

Returns: this application context's internal bean factory

public Map getBeansOfType(Class type, boolean includePrototypes, boolean includeFactoryBeans)
                    throws org.springframework.beans.BeansException

public String getDisplayName()

Return a friendly name for context

Returns: a display name for the context

public String getMessage(String code, Object[] args, String defaultMessage, Locale locale)

public String getMessage(String code, Object[] args, Locale locale)
                   throws org.springframework.context.NoSuchMessageException

public String getMessage(MessageSourceResolvable resolvable, Locale locale)
                   throws org.springframework.context.NoSuchMessageException

public ApplicationContext getParent()

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

Returns: the parent context, or null if there is no parent

public BeanFactory getParentBeanFactory()

public Resource getResource(String location)

This implementation supports fully qualified URLs, including the "classpath:" pseudo-URL, and context-specific file paths via getResourceByPath. Throws a FileNotFoundException if getResourceByPath returns null.

See Also:

getResourceByPath(java.lang.String), org.springframework.core.io.ResourceEditor.CLASSPATH_URL_PREFIX

public long getStartupDate()

Return the timestamp when this context was first loaded

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

public boolean isSingleton(String name)
                     throws org.springframework.beans.factory.NoSuchBeanDefinitionException

public void publishEvent(ApplicationEvent event)

Publish the given event to all listeners.

Note: Listeners get initialized after the message source, to be able to access it within listener implementations. Thus, message source implementation cannot publish events.

Parameters:

event - event to publish. The event may be application-specific, or a standard framework event.

public void refresh()
              throws org.springframework.beans.BeansException

Load or reload configuration.

Throws:

org.springframework.context.ApplicationContextException - if the configuration was invalid or couldn't be found, or if configuration has already been loaded and reloading is forbidden

BeansException - if the bean factory could not be initialized

public void setParent(ApplicationContext parent)

public String toString()

Show information about this context

Association Links

to Class java.lang.String

Name of the MessageSource bean in the factory. If none is supplied, message resolution is delegated to the parent.

see MessageSource

to Class org.springframework.context.ApplicationContext

Parent context

to Class java.lang.String

Display name

to Class org.springframework.context.MessageSource

MessageSource helper we delegate our implementation of this interface to

to Class org.springframework.context.event.ApplicationEventMulticaster

Helper class used in event publishing. TODO: This could be parameterized as a JavaBean (with a distinguished name specified), enabling a different thread usage policy for event publication.