ComponentFactory
Date: 2016-06-25

org.osgi.service.component

## Interface ComponentFactory

-     @ProviderType
      public interface ComponentFactory

  When a component is declared with the `factory` attribute on its `component` element, Service Component Runtime will register a Component Factory service to allow new component configurations to be created and activated rather than automatically creating and activating component configuration as necessary.

- - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `ComponentInstance` | `newInstance(java.util.Dictionary<java.lang.String,?> properties)` Create and activate a new component configuration.

- - ### Method Detail

    - #### newInstance

          ComponentInstance newInstance(java.util.Dictionary<java.lang.String,?> properties)

      Create and activate a new component configuration. Additional properties may be provided for the component configuration.
      Parameters:
        `properties` - Additional properties for the component configuration or `null` if there are no additional properties.
      Returns:
        A `ComponentInstance` object encapsulating the component instance of the component configuration. The component configuration has been activated and, if the component specifies a `service` element, the component instance has been registered as a service.
      Throws:
        `ComponentException` - If Service Component Runtime is unable to activate the component configuration.