Package net.shibboleth.shared.component

Class AbstractInitializableComponent

java.lang.Object
net.shibboleth.shared.component.AbstractInitializableComponent
All Implemented Interfaces:
Component, DestructableComponent, InitializableComponent
Direct Known Subclasses:
AbstractIdentifiedInitializableComponent, BasicHttpServletRequestContentTypeValidator, BasicHttpServletRequestMethodValidator, BasicHttpServletRequestParametersValidator, BasicKeystoreKeyStrategy, BasicParserPool, ChainingHttpServletRequestValidator, CookieManager, DataSealer, EncryptedCookieManager, EvaluableScript, IdentifiedComponentManager, ReloadableServiceGaugeSet, ScriptedKeyStrategy
@ThreadSafe public abstract class AbstractInitializableComponent extends Object implements DestructableComponent, InitializableComponent
Base class for things that implement DestructableComponent and InitializableComponent.

  • Field Details

    • isDestroyed

      private boolean isDestroyed
      Whether this component has been destroyed.

    • isInitialized

      private boolean isInitialized
      Whether this component has been initialized.

    • theLog

      private static org.slf4j.Logger theLog
      Used for "user after teardown" warnings only

  • Constructor Details

    • AbstractInitializableComponent

      public AbstractInitializableComponent()

  • Method Details

    • isDestroyed

      @Deprecated(forRemoval=true, since="9.3") public final boolean isDestroyed()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets whether this component has been destroyed. Normally, once a component has been destroyed it cannot be used.
      Specified by:
      isDestroyed in interface DestructableComponent
      Returns:
      true iff the component has been destroyed

    • isInitialized

      public boolean isInitialized()
      Gets whether this component is initialized.
      Specified by:
      isInitialized in interface InitializableComponent
      Returns:
      true iff this component is initialized

    • destroy

      @Deprecated(forRemoval=true, since="9.3") public final void destroy()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Destroys the component.
      Specified by:
      destroy in interface DestructableComponent

    • initialize

      public final void initialize() throws ComponentInitializationException
      Initializes the component.
      Specified by:
      initialize in interface InitializableComponent
      Throws:
      ComponentInitializationException - thrown if there is a problem initializing the component

    • ifDestroyedThrowDestroyedComponentException

      @Deprecated(forRemoval=true, since="9.3") protected void ifDestroyedThrowDestroyedComponentException()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Checks if the component is destroyed and, if so, throws a DestroyedComponentException.

      This will be removed in V6.0.

    • ifNotInitializedThrowUninitializedComponentException

      protected void ifNotInitializedThrowUninitializedComponentException()
      Checks if a component has not been initialized and, if so, throws a UninitializedComponentException.

    • ifInitializedThrowUnmodifiabledComponentException

      protected void ifInitializedThrowUnmodifiabledComponentException()
      Checks if a component has been initialized and, if so, throws a UnmodifiableComponentException.

    • checkSetterPreconditions

      protected final void checkSetterPreconditions()
      Helper for a setter method to check the standard preconditions.

    • checkComponentActive

      protected final void checkComponentActive()
      Helper for any method to throw appropriate exceptions if we are either not initialized, or have been destroyed.

    • doDestroy

      @Deprecated(forRemoval=true, since="9.3") protected void doDestroy()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs component specific destruction logic. This method is executed within the lock on the object being destroyed. The default implementation of this method is a no-op.

      This will be removed in V6.0. Replacement is The OnTeardown annotation.

    • doInitialize

      protected void doInitialize() throws ComponentInitializationException
      Performs the initialization of the component. This method is executed within the lock on the object being initialized. The default implementation of this method is a no-op.
      Throws:
      ComponentInitializationException - thrown if there is a problem initializing the component

    • getLog

      private static org.slf4j.Logger getLog()
      Lazy init a logger.
      Returns:
      the logger.