Package org.osgi.service.component.annotations

Enum ConfigurationPolicy

  • All Implemented Interfaces:
    Serializable, Comparable<ConfigurationPolicy>
    public enum ConfigurationPolicy
extends Enum<ConfigurationPolicy>
    Configuration Policy for the Component annotation.

    Controls whether component configurations must be satisfied depending on the presence of a corresponding Configuration object in the OSGi Configuration Admin service. A corresponding configuration is a Configuration object where the PID is the name of the component.

    Since:
    1.1

    • Enum Constant Detail

      • OPTIONAL

        public static final ConfigurationPolicy OPTIONAL
        Use the corresponding Configuration object if present but allow the component to be satisfied even if the corresponding Configuration object is not present.

      • REQUIRE

        public static final ConfigurationPolicy REQUIRE
        There must be a corresponding Configuration object for the component configuration to become satisfied.

      • IGNORE

        public static final ConfigurationPolicy IGNORE
        Always allow the component configuration to be satisfied and do not use the corresponding Configuration object even if it is present.

    • Method Detail

      • values

        public static ConfigurationPolicy[] 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 (ConfigurationPolicy c : ConfigurationPolicy.values())
    System.out.println(c);
        Returns:
        an array containing the constants of this enum type, in the order they are declared

      • valueOf

        public static ConfigurationPolicy 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