Package 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.- Version:
- $Revision: 5654 $
-
Method Summary
Modifier and TypeMethodDescriptionnewInstance
(Dictionary properties) Create and activate a new component configuration.
-
Method Details
-
newInstance
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 the Service Component Runtime is unable to activate the component configuration.
-