aquality.selenium.core.applications.AqualityServices Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of aquality-selenium-core Show documentation

Library with core functions simplifying work with Selenium-controlled applications.

There is a newer version: 4.2.0

Show newest version

package aquality.selenium.core.applications;

import com.google.inject.Guice;
import com.google.inject.Injector;
import com.google.inject.Provider;

import java.util.function.Function;
import java.util.function.Supplier;

/**
 * Describes methods which help work with Application and dependency injector.
 *
 * @author lenovo
 * @version $Id: $Id
 */
public abstract class AqualityServices  {

    private T app;
    private final Injector injector;

    /**
     * Constructor for AqualityServices.
     *
     * @param applicationProvider a {@link com.google.inject.Provider} object.
     * @param servicesModuleSupplier a {@link java.util.function.Supplier} object.
     * @param  a V object.
     */
    protected > AqualityServices(Provider applicationProvider,
                                                             Supplier servicesModuleSupplier) {
        AqualityModule module = servicesModuleSupplier == null
                ? new AqualityModule<>(applicationProvider)
                : servicesModuleSupplier.get();
        injector = Guice.createInjector(module);
    }

    /**
     * isAppStarted.
     *
     * @return true if the application is already started, false otherwise.
     */
    protected boolean isAppStarted() {
        return app != null && app.isStarted();
    }

    /**
     * Sets the application instance, saving it to DI container.
     *
     * @param application instance to set into container.
     */
    protected void setApp(T application) {
        this.app = application;
    }

    /**
     * Returns an existing application or initializes a new one based on passed parameter.
     *
     * @param startApplicationFunction function to start the application, where the injector could be used.
     * @return started application.
     */
    protected T getApp(Function startApplicationFunction) {
        if (!isAppStarted()) {
            setApp(startApplicationFunction.apply(injector));
        }

        return app;
    }

    /**
     * Gets existing injector based on {@link aquality.selenium.core.applications.AqualityModule} supplier passed to constructor.
     *
     * @return existing injector.
     */
    protected Injector getInjector() {
        return injector;
    }
}