Page History

public interface Factory {
    /**
     * Create an instance manager (i.e. component type instance).
     * @param configuration : the configuration properties for this component.
     * @return the created instance manager.
     * @throw UnacceptableConfiguration if the given configuration is not consistent for the factory
     */
    ComponentInstance createComponentInstance(Dictionary configuration) throw UnacceptableConfiguration;

    /**
     * Create an instance manager (i.e. component type instance).
     * This has these service interaction in the scope given in argument.
     * @param configuration : the configuration properties for this component.
     * @param serviceContext : the service context of the component.
     * @return the created instance manager.
     * @throw UnacceptableConfiguration if the given configuration is not consistent for the factory
     */
    ComponentInstance createComponentInstance(Dictionary configuration, ServiceContext serviceContext) throw UnacceptableConfiguration;

    /**
     * Get the component type information containing provided service, configuration properties ...
     * @return the component type information.
     */
    ComponentDescription getComponentDescription();

    /**
     * Check if the given configuration is acceptable as a configuration of a component instance.
     * @param conf : the configuration to test
     * @return true if the configuration is acceptable
     */
    boolean isAcceptable(Dictionary conf);

    /**
     * @return the name of the factory.
     */
    String getName();

}