Interface ComponentFactory<S>

  • Type Parameters:
    S - Type of Service

    @ProviderType
    public interface ComponentFactory<S>
    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: bbe0dd318af3a76ba4c18f964c60ae8578b97982 $
    • Method Detail

      • newInstance

        ComponentInstance<S> 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.