org.apache.felix.dm

Enum ComponentState

java.lang.Object

java.lang.Enum<ComponentState>

org.apache.felix.dm.ComponentState

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<ComponentState>

public enum ComponentState
extends java.lang.Enum<ComponentState>

Component states. Any state listeners registered using @link Component.add(ComponentStateListener) method are notified with the following stated whenever the component state changes.

Enum Constant Summary

Enum Constants

Enum Constant and Description
INACTIVE The component is not currently started, and is inactive.
INSTANTIATED_AND_WAITING_FOR_REQUIRED The component is instantiated and waiting for dynamic required dependencies defined in init callback.
STARTED The component has been called in its started callback.
STARTING The component is starting.
STOPPED the component is stopped.
STOPPING the component is stopping.
TRACKING_OPTIONAL The component is started.
WAITING_FOR_REQUIRED The component is waiting for some required dependencies defined in the Activator.

Method Summary

Modifier and Type	Method and Description
static ComponentState	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static ComponentState[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INACTIVE

public static final ComponentState INACTIVE

The component is not currently started, and is inactive.

WAITING_FOR_REQUIRED

public static final ComponentState WAITING_FOR_REQUIRED

The component is waiting for some required dependencies defined in the Activator. At this point the component has not yet been called in its init callback.

INSTANTIATED_AND_WAITING_FOR_REQUIRED

public static final ComponentState INSTANTIATED_AND_WAITING_FOR_REQUIRED

The component is instantiated and waiting for dynamic required dependencies defined in init callback.

STARTING

public static final ComponentState STARTING

The component is starting. At this point, all required dependencies have been injected (including dynamic dependencies added from the init method), but the start callback has not yet been called and the service has not been registered yet.

STARTED

public static final ComponentState STARTED

The component has been called in its started callback. At this point, the component has not yet been registered in the service registry.

TRACKING_OPTIONAL

public static final ComponentState TRACKING_OPTIONAL

The component is started. At this point, the component:

• has been called in its start callback
• the optional dependency callbacks have been invoked (if some optional dependencies are available)
• and the service has been registered

STOPPING

public static final ComponentState STOPPING

the component is stopping. At this point, the service is still registered.

STOPPED

public static final ComponentState STOPPED

the component is stopped. At this point, the service has been unregistered.

Method Detail

values

public static ComponentState[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ComponentState c : ComponentState.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ComponentState valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null