Package net.shibboleth.shared.spring.factory

Class AbstractFactoryBean<T>

java.lang.Object
net.shibboleth.shared.spring.factory.AbstractFactoryBean<T>
Type Parameters:
T - the bean type
All Implemented Interfaces:
Aware, BeanClassLoaderAware, BeanFactoryAware, DisposableBean, FactoryBean<T>, InitializingBean
@Deprecated(forRemoval=true, since="9.3") public abstract class AbstractFactoryBean<T> extends Object implements FactoryBean<T>, BeanClassLoaderAware, BeanFactoryAware, InitializingBean, DisposableBean
Deprecated, for removal: This API element is subject to removal in a future version.
For removal in 10.0
Cloned from Spring's base class to fix bug they won't acknowledge regarding the ability for createInstance() to return null.

Simple template superclass for FactoryBean implementations that creates a singleton or a prototype object, depending on a flag.

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 getObject() method.

Else, this class will create a new instance every time the getObject() method is invoked. Subclasses are responsible for implementing the abstract createInstance() template method to actually create the object(s) to expose.

Since:
9.1.0
See Also:

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    private class 
    AbstractFactoryBean.EarlySingletonInvocationHandler
    Deprecated, for removal: This API element is subject to removal in a future version.
    Reflective InvocationHandler for lazy access to the actual singleton object.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private ClassLoader
    beanClassLoader
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    private BeanFactory
    beanFactory
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    private T
    earlySingletonInstance
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    private boolean
    initialized
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    private boolean
    singleton
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    private T
    singletonInstance
    Deprecated, for removal: This API element is subject to removal in a future version.
     

    Fields inherited from interface org.springframework.beans.factory.FactoryBean

    OBJECT_TYPE_ATTRIBUTE

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractFactoryBean()
    Deprecated, for removal: This API element is subject to removal in a future version.
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    afterPropertiesSet()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Eagerly create the singleton instance, if necessary.
    protected abstract T
    createInstance()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Template method that subclasses must override to construct the object returned by this factory.
    void
    destroy()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Destroy the singleton instance, if any.
    protected void
    destroyInstance(T instance)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Callback for destroying a singleton instance.
    protected BeanFactory
    getBeanFactory()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Return the BeanFactory that this bean runs in.
    protected TypeConverter
    getBeanTypeConverter()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a bean type converter from the BeanFactory that this bean runs in.
    private T
    getEarlySingletonInstance()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Determine an 'early singleton' instance, exposed in case of a circular reference.
    protected Class<?>[]
    getEarlySingletonInterfaces()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Return an array of interfaces that a singleton object exposed by this FactoryBean is supposed to implement, for use with an 'early singleton proxy' that will be exposed in case of a circular reference.
    final T
    getObject()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Expose the singleton instance or create a new prototype instance.
    abstract Class<?>
    getObjectType()
    Deprecated, for removal: This API element is subject to removal in a future version.
    This abstract method declaration mirrors the method in the FactoryBean interface, for a consistent offering of abstract template methods.
    private T
    getSingletonInstance()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Expose the singleton instance (for access through the 'early singleton' proxy).
    boolean
    isSingleton()
    Deprecated, for removal: This API element is subject to removal in a future version.
    void
    setBeanClassLoader(ClassLoader classLoader)
    Deprecated, for removal: This API element is subject to removal in a future version.
    void
    setBeanFactory(BeanFactory beanFactory)
    Deprecated, for removal: This API element is subject to removal in a future version.
    void
    setSingleton(boolean singleton)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set if a singleton should be created, or a new object on each request otherwise.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • singleton

      private boolean singleton
      Deprecated, for removal: This API element is subject to removal in a future version.

    • beanClassLoader

      @Nullable private ClassLoader beanClassLoader
      Deprecated, for removal: This API element is subject to removal in a future version.

    • beanFactory

      @Nullable private BeanFactory beanFactory
      Deprecated, for removal: This API element is subject to removal in a future version.

    • initialized

      private boolean initialized
      Deprecated, for removal: This API element is subject to removal in a future version.

    • singletonInstance

      @Nullable private T singletonInstance
      Deprecated, for removal: This API element is subject to removal in a future version.

    • earlySingletonInstance

      @Nullable private T earlySingletonInstance
      Deprecated, for removal: This API element is subject to removal in a future version.

  • Constructor Details

    • AbstractFactoryBean

      public AbstractFactoryBean()
      Deprecated, for removal: This API element is subject to removal in a future version.

  • Method Details

    • setSingleton

      public void setSingleton(boolean singleton)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set if a singleton should be created, or a new object on each request otherwise. Default is true (a singleton).
      Parameters:
      singleton - flag to set

    • isSingleton

      public boolean isSingleton()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specified by:
      isSingleton in interface FactoryBean<T>

    • setBeanClassLoader

      public void setBeanClassLoader(@Nonnull ClassLoader classLoader)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specified by:
      setBeanClassLoader in interface BeanClassLoaderAware

    • setBeanFactory

      public void setBeanFactory(@Nullable BeanFactory beanFactory)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specified by:
      setBeanFactory in interface BeanFactoryAware

    • getBeanFactory

      @Nullable protected BeanFactory getBeanFactory()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Return the BeanFactory that this bean runs in.
      Returns:
      bean factory

    • getBeanTypeConverter

      @Nonnull protected TypeConverter getBeanTypeConverter()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a bean type converter from the BeanFactory that this bean runs in. This is typically a fresh instance for each call, since TypeConverters are usually not thread-safe.

      Falls back to a SimpleTypeConverter when not running in a BeanFactory.

      Returns:
      type converter
      See Also:

    • afterPropertiesSet

      public void afterPropertiesSet() throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Eagerly create the singleton instance, if necessary.
      Specified by:
      afterPropertiesSet in interface InitializingBean
      Throws:
      Exception

    • getObject

      @Nullable public final T getObject() throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Expose the singleton instance or create a new prototype instance.
      Specified by:
      getObject in interface FactoryBean<T>
      Throws:
      Exception
      See Also:

    • getEarlySingletonInstance

      @Nullable private T getEarlySingletonInstance() throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Determine an 'early singleton' instance, exposed in case of a circular reference. Not called in a non-circular scenario.
      Returns:
      early singleton
      Throws:
      Exception - on error

    • getSingletonInstance

      @Nullable private T getSingletonInstance() throws IllegalStateException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Expose the singleton instance (for access through the 'early singleton' proxy).
      Returns:
      the singleton instance that this FactoryBean holds
      Throws:
      IllegalStateException - if the singleton instance is not initialized

    • destroy

      public void destroy() throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Destroy the singleton instance, if any.
      Specified by:
      destroy in interface DisposableBean
      Throws:
      Exception
      See Also:

    • getObjectType

      @Nullable public abstract Class<?> getObjectType()
      Deprecated, for removal: This API element is subject to removal in a future version.
      This abstract method declaration mirrors the method in the FactoryBean interface, for a consistent offering of abstract template methods.
      Specified by:
      getObjectType in interface FactoryBean<T>
      See Also:

    • createInstance

      @Nullable protected abstract T createInstance() throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Template method that subclasses must override to construct the object returned by this factory.

      Invoked on initialization of this FactoryBean in case of a singleton; else, on each getObject() call.

      Returns:
      the object returned by this factory
      Throws:
      Exception - if an exception occurred during object creation
      See Also:

    • getEarlySingletonInterfaces

      @Nullable protected Class<?>[] getEarlySingletonInterfaces()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Return an array of interfaces that a singleton object exposed by this FactoryBean is supposed to implement, for use with an 'early singleton proxy' that will be exposed in case of a circular reference.

      The default implementation returns this FactoryBean's object type, provided that it is an interface, or null otherwise. The latter indicates that early singleton access is not supported by this FactoryBean. This will lead to a FactoryBeanNotInitializedException getting thrown.

      Returns:
      the interfaces to use for 'early singletons', or null to indicate a FactoryBeanNotInitializedException
      See Also:

    • destroyInstance

      protected void destroyInstance(@Nullable T instance) throws Exception
      Deprecated, for removal: This API element is subject to removal in a future version.
      Callback for destroying a singleton instance. Subclasses may override this to destroy the previously created instance.

      The default implementation is empty.

      Parameters:
      instance - the singleton instance, as returned by createInstance()
      Throws:
      Exception - in case of shutdown errors
      See Also: