|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.beans.factory.config.AbstractFactoryBean
public abstract class AbstractFactoryBean
Simple template superclass for FactoryBean implementations thats allows for creating a singleton or a prototype, depending on a flag.
If the "singleton" flag is "true" (the default), this class will create
once on initialization and subsequently return the singleton instance.
Else, this class will create a new instance each time. Subclasses are
responsible for implementing the abstract createInstance
template method to actually create the objects to expose.
setSingleton(boolean)
,
createInstance()
Field Summary | |
---|---|
protected Log |
logger
Logger available to subclasses |
Constructor Summary | |
---|---|
AbstractFactoryBean()
|
Method Summary | |
---|---|
void |
afterPropertiesSet()
Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware). |
protected abstract Object |
createInstance()
Template method that subclasses must override to construct the object returned by this factory. |
void |
destroy()
Invoked by a BeanFactory on destruction of a singleton. |
protected void |
destroyInstance(Object instance)
Callback for destroying a singleton instance. |
Object |
getObject()
Return an instance (possibly shared or independent) of the object managed by this factory. |
boolean |
isSingleton()
Is the bean managed by this factory a singleton or a prototype? |
void |
setSingleton(boolean singleton)
Set if a singleton should be created, or a new object on each request else. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.springframework.beans.factory.FactoryBean |
---|
getObjectType |
Field Detail |
---|
protected final Log logger
Constructor Detail |
---|
public AbstractFactoryBean()
Method Detail |
---|
public void setSingleton(boolean singleton)
public boolean isSingleton()
FactoryBean
The singleton status of the FactoryBean itself will generally be provided by the owning BeanFactory; usually, it has to be defined as singleton there.
isSingleton
in interface FactoryBean
public void afterPropertiesSet() throws Exception
InitializingBean
This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.
afterPropertiesSet
in interface InitializingBean
Exception
- in the event of misconfiguration (such
as failure to set an essential property) or if initialization fails.public final Object getObject() throws Exception
FactoryBean
If this method returns null, the factory will consider the FactoryBean as not fully initialized and throw a corresponding FactoryBeanNotInitializedException.
getObject
in interface FactoryBean
null
; a null value
will be considered as an indication of incomplete initialization)
Exception
- in case of creation errorsFactoryBeanNotInitializedException
public void destroy() throws Exception
DisposableBean
destroy
in interface DisposableBean
Exception
- in case of shutdown errors.
Exceptions will get logged but not rethrown to allow
other beans to release their resources too.protected abstract Object createInstance() throws Exception
Invoked on initialization of this FactoryBean in case of
a singleton; else, on each getObject()
call.
Exception
- if an exception occured during object creationgetObject()
protected void destroyInstance(Object instance) throws Exception
The default implementation is empty.
instance
- the singleton instance, as returned by
createInstance()
Exception
- in case of shutdown errorscreateInstance()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |