net.shibboleth.utilities.java.support.component

Class ComponentSupport

java.lang.Object

net.shibboleth.utilities.java.support.component.ComponentSupport

public final class ComponentSupport
extends Object

Support class for working with Component objects.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ComponentSupport() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	destroy(Object obj) If the given object is not null and an instance of DestructableComponent, then this method calls the given object's DestructableComponent.destroy() method.
static void	ifDestroyedThrowDestroyedComponentException(DestructableComponent component) Checks if a component is destroyed and, if so, throws a DestroyedComponentException.
static void	ifInitializedThrowUnmodifiabledComponentException(InitializableComponent component) Checks if a component has been initialized and, if so, throws a UnmodifiableComponentException.
static void	ifNotInitializedThrowUninitializedComponentException(InitializableComponent component) Checks if a component has not been initialized and, if so, throw)s a UninitializedComponentException.
static void	initialize(Object obj) If the given object is not null and an instance of InitializableComponent, then this method calls the given object's InitializableComponent.initialize() method.

Methods inherited from class java.lang.Object

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

Constructor Detail

ComponentSupport

private ComponentSupport()

Constructor.

Method Detail

destroy

public static void destroy(@Nullable
           Object obj)

If the given object is not null and an instance of DestructableComponent, then this method calls the given object's DestructableComponent.destroy() method.

Parameters:

obj - object to destroy, may be null

initialize

public static void initialize(@Nullable
              Object obj)
                       throws ComponentInitializationException

If the given object is not null and an instance of InitializableComponent, then this method calls the given object's InitializableComponent.initialize() method.

Parameters:

obj - object to initialize, may be null

Throws:

ComponentInitializationException - thrown if there is a problem initializing the object

ifDestroyedThrowDestroyedComponentException

public static void ifDestroyedThrowDestroyedComponentException(@Nonnull
                                               DestructableComponent component)

Checks if a component is destroyed and, if so, throws a DestroyedComponentException. If the component is also an instance of IdentifiedComponent, the component's ID is included in the error message.

Parameters:

component - component to check

ifNotInitializedThrowUninitializedComponentException

public static void ifNotInitializedThrowUninitializedComponentException(@Nonnull
                                                        InitializableComponent component)

Checks if a component has not been initialized and, if so, throw)s a UninitializedComponentException. If the component is also an instance of IdentifiedComponent, the component's ID is included in the error message.

Parameters:

component - component to check

ifInitializedThrowUnmodifiabledComponentException

public static void ifInitializedThrowUnmodifiabledComponentException(@Nonnull
                                                     InitializableComponent component)

Checks if a component has been initialized and, if so, throws a UnmodifiableComponentException. If the component is also an instance of IdentifiedComponent, the component's ID is included in the error message.

Parameters:

component - component to check