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.

"ThreadSafe"

Method Summary

Methods

Modifier and Type	Method and Description
ComponentInstance	newInstance(Dictionary<String,?> properties) Create and activate a new component configuration.

Method Detail

newInstance

ComponentInstance newInstance(Dictionary<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.