org.daisy.dotify.api.obfl.ExpressionFactoryMaker Maven / Gradle / Ivy

Go to download
package org.daisy.dotify.api.obfl;

import java.util.ServiceLoader;

/**
 * Like all maker classes in the api, this
 * class is only used directly in SPI context. Unlike some other classes however,
 * this class does not implement a service interface that can be used from
 * OSGi. The reason for this is that the implementation simply returns
 * a single instance of the lower level interface with references populated
 * with SPI. To use in OSGi context, request the lower level service directly
 * from the DS registry.
 *
 * @author Joel Håkansson
 */
//TODO: deprecate or add service layer
//See: https://github.com/joeha480/dotify/issues/161
public class ExpressionFactoryMaker {
    private final ExpressionFactory proxy;

    /**
     * Creates a new expression factory maker.
     */
    public ExpressionFactoryMaker() {
        // Gets the first formatter engine (assumes there is at least one).
        proxy = ServiceLoader.load(ExpressionFactory.class).iterator().next();
        proxy.setCreatedWithSPI();
    }

    /**
     * Creates a new expression factory maker instance.
     *
     * @return returns a new expression factory maker instance
     */
    public static ExpressionFactoryMaker newInstance() {
        return new ExpressionFactoryMaker();
    }

    /**
     * Gets an expression factory.
     *
     * @return returns an expression factory
     */
    public ExpressionFactory getFactory() {
        return proxy;
    }

}