Enum Constant Detail

• ACTIVE

  public static final ComponentState ACTIVE

  A component is active when all of the properties of the component are set and the activate method was processed (if there is any) successfully.

• FAILED

  public static final ComponentState FAILED

  A component is in the failed state if any of the setter the activate or the update method throws a runtime exception or a configuration cannot be applyed due to multiplicity or type issues.

• FAILED_PERMANENT

  public static final ComponentState FAILED_PERMANENT

  The component will be permanently failed if implementation (or metadata) change is necessary to make it work.

• INACTIVE

  public static final ComponentState INACTIVE

  The component is not yet initialized or it was removed. It is hard to catch this state as

  • As soon as the component context is created, initialization starts.
  • As soon as the component context is inactivated, it is removed from the system completely (as this happens when the container is closed).

• STARTING

  public static final ComponentState STARTING

  The component is instantiated and the setters or the activate method of the component is currently processing.

• STOPPING

  public static final ComponentState STOPPING

  The deactivate function of the component is currently running. STOPPING can be caused due to several reasons:

  • The component is destroyed as the configuration behind the component is deleted
  • Due to a non-dynamic configuration update, the component has to be restarted. In this case the first step is stopping the component.
  • The component was in STARTING or ACTIVE state and there was a failure. In the end of STOPPING, the component will get the FAILED or state.
  • The component was ACTIVE and one of the references became unsatisfied.

• UNSATISFIED

  public static final ComponentState UNSATISFIED

  The component has unsatisfied references.

• UPDATING_CONFIGURATION

  public static final ComponentState UPDATING_CONFIGURATION

  The component instance is just created and new configuration is applied on it. This component can get this state due to the following reasons:

  • the component was FAILED and new configuration arrived
  • the component was UNSATISFIED and new configuration arrived
  • the component was ACTIVE but it had to be stopped to apply non-dynamic changes. In this case the component class is re-instantiated.

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(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:

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

  NullPointerException - if the argument is null