Knopflerfish OSGi 5.2.0

org.osgi.service.component
Interface ComponentFactory


public interface ComponentFactory

When a component is declared with the factory attribute on its component element, the 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.

Author:
$Id: 659fb05e2876297c27589e9007fd327f1d87fd90 $
ThreadSafe
Consumers of this API must not implement this interface

Method Summary
 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 the Service Component Runtime is unable to activate the component configuration.

Knopflerfish OSGi 5.2.0