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.

Author:

$Id: a6422fc517a31533b1188d5ab9d9ee95a7a52c8a $

ThreadSafe

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.