Package org.osgi.service.component
Interface ComponentFactory
-
@ProviderType public interface ComponentFactory
When a component is declared with thefactory
attribute on itscomponent
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 $
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method 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 ornull
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 aservice
element, the component instance has been registered as a service. - Throws:
ComponentException
- If Service Component Runtime is unable to activate the component configuration.
-
-