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.

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.