Save This Page
Home » spring-framework-2.5.5-with-dependencies » org.springframework » beans » factory » config » [javadoc | source]
org.springframework.beans.factory.config
public interface: ConfigurableListableBeanFactory [javadoc | source]

All Implemented Interfaces:
    ListableBeanFactory, ConfigurableBeanFactory, AutowireCapableBeanFactory

All Known Implementing Classes:
    DefaultListableBeanFactory, XmlBeanFactory

Configuration interface to be implemented by most listable bean factories. In addition to ConfigurableBeanFactory , it provides facilities to analyze and modify bean definitions, and to pre-instantiate singletons.

This subinterface of org.springframework.beans.factory.BeanFactory is not meant to be used in normal application code: Stick to org.springframework.beans.factory.BeanFactory or org.springframework.beans.factory.ListableBeanFactory for typical use cases. This interface is just meant to allow for framework-internal plug'n'play even when needing access to bean factory configuration methods.

Method from org.springframework.beans.factory.config.ConfigurableListableBeanFactory Summary:
freezeConfiguration,   getBeanDefinition,   ignoreDependencyInterface,   ignoreDependencyType,   isAutowireCandidate,   isConfigurationFrozen,   preInstantiateSingletons,   registerResolvableDependency
Method from org.springframework.beans.factory.config.ConfigurableListableBeanFactory Detail:
 public  void freezeConfiguration()
    Freeze all bean definitions, signalling that the registered bean definitions will not be modified or post-processed any further.

    This allows the factory to aggressively cache bean definition metadata.

 public BeanDefinition getBeanDefinition(String beanName) throws NoSuchBeanDefinitionException
    Return the registered BeanDefinition for the specified bean, allowing access to its property values and constructor argument value (which can be modified during bean factory post-processing).

    A returned BeanDefinition object should not be a copy but the original definition object as registered in the factory. This means that it should be castable to a more specific implementation type, if necessary.

    NOTE: This method does not consider ancestor factories. It is only meant for accessing local bean definitions of this factory.

 public  void ignoreDependencyInterface(Class ifc)
    Ignore the given dependency interface for autowiring.

    This will typically be used by application contexts to register dependencies that are resolved in other ways, like BeanFactory through BeanFactoryAware or ApplicationContext through ApplicationContextAware.

    By default, only the BeanFactoryAware interface is ignored. For further types to ignore, invoke this method for each type.

 public  void ignoreDependencyType(Class type)
    Ignore the given dependency type for autowiring: for example, String. Default is none.
 public boolean isAutowireCandidate(String beanName,
    DependencyDescriptor descriptor) throws NoSuchBeanDefinitionException
    Determine whether the specified bean qualifies as an autowire candidate, to be injected into other beans which declare a dependency of matching type.

    This method checks ancestor factories as well.

 public boolean isConfigurationFrozen()
    Return whether this factory's bean definitions are frozen, i.e. are not supposed to be modified or post-processed any further.
 public  void preInstantiateSingletons() throws BeansException
    Ensure that all non-lazy-init singletons are instantiated, also considering FactoryBeans . Typically invoked at the end of factory setup, if desired.
 public  void registerResolvableDependency(Class dependencyType,
    Object autowiredValue)
    Register a special dependency type with corresponding autowired value.

    This is intended for factory/context references that are supposed to be autowirable but are not defined as beans in the factory: e.g. a dependency of type ApplicationContext resolved to the ApplicationContext instance that the bean is living in.

    Note: There are no such default types registered in a plain BeanFactory, not even for the BeanFactory interface itself.