Top Description Methods
org.osgi.service.component

public Interface ComponentFactory<S>

Annotations
@ProviderType
Type Parameters
<S>
Type of Service
Imports
java.util.Dictionary, org.osgi.annotation.versioning.ProviderType

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.
Author
$Id: e667a1d73967da49dacbceba06c9a247e0048d33 $

Method Summary

Modifier and TypeMethod and Description
public ComponentInstance<S>

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.
newInstance
(Dictionary<String, ?>
Additional properties for the component configuration or null if there are no additional properties.
properties
)

Create and activate a new component configuration.

Method Detail

newInstanceback to summary
public ComponentInstance<S> newInstance(Dictionary<String, ?> properties)

Create and activate a new component configuration. Additional properties may be provided for the component configuration.

Parameters
properties:Dictionary<String, ?>

Additional properties for the component configuration or null if there are no additional properties.

Returns:ComponentInstance<S>

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.

Exceptions
ComponentException:
If Service Component Runtime is unable to activate the component configuration.