org.springframework.beans.factory.config

If the "singleton" flag is true (the default), this class will create the object that it creates exactly once on initialization and subsequently return said singleton instance on all calls to the AbstractFactoryBean.getObject() method.

Else, this class will create a new instance every time the AbstractFactoryBean.getObject() method is invoked.

This subinterface of 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.

Integration code for other frameworks can leverage this interface to wire and populate existing bean instances that Spring does not control the lifecycle of.

Can also be used for programmatic registration of inner bean definitions.

Useful for sharing Log instances among multiple beans instead of using one Log instance per class name, e.g.

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.

As of Spring 2.0, the recommended usage is to use custom PropertyEditorRegistrar implementations that in turn register any desired editors on a given org.springframework.beans.PropertyEditorRegistry registry . Each PropertyEditorRegistrar can register any number of custom editors.

 <bean id="customEditorConfigurer" class="org.springframework.beans.factory.config.CustomEditorConfigurer">
 <property name="propertyEditorRegistrars">
 <list>
 <bean class="mypackage.MyCustomDateEditorRegistrar"/>
 <bean class="mypackage.MyObjectEditorRegistrar"/>
 </list>
 </property>
 </bean>

Alternative configuration example with custom editor instances, assuming inner beans for PropertyEditor instances:

 <bean id="customEditorConfigurer" class="org.springframework.beans.factory.config.CustomEditorConfigurer">
 <property name="customEditors">
 <map>
 <entry key="java.util.Date">
 <bean class="mypackage.MyCustomDateEditor"/>
 </entry>
 <entry key="mypackage.MyObject">
 <bean id="myEditor" class="mypackage.MyObjectEditor">
 <property name="myParam"><value>myValue</value></property>
 </bean>
 </entry>
 </map>
 </property>
 </bean>

Also supports "java.lang.String[]"-style array class names and primitive class names (e.g.

Typically used for retrieving public static final constants.

Typically used to suppress default instantiation for specific target beans, for example to create proxies with special TargetSources (pooling targets, lazily initializing targets, etc), or to implement additional injection strategies such as field injection.

NOTE: This interface is a special purpose interface, mainly for internal use within the framework.

As such, this may be used to avoid having a client object directly calling org.springframework.beans.factory.BeanFactory.getBean(String) to get a (typically prototype) bean from a org.springframework.beans.factory.BeanFactory , which would be a violation of the inversion of control principle.

Tries to resolve placeholders as keys first in the user preferences, then in the system preferences, then in this configurer's properties. Thus, behaves like PropertyPlaceholderConfigurer if no corresponding preferences defined.

Supports custom paths for the system and user preferences trees.

org.springframework.context.ApplicationContext implementations such as a org.springframework.web.context.WebApplicationContext may register additional standard scopes specific to their environment, e.g.

Such service locators permit the decoupling of calling code from the org.springframework.beans.factory.BeanFactory API, by using an appropriate custom locator interface.

NOTE: This interface is a special purpose interface, mainly for internal use within the framework.