org.nuiton.jaxx.runtime.application.ApplicationContext Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jaxx-runtime Show documentation
JAXX Runtime api
The newest version!
package org.nuiton.jaxx.runtime.application;

/*-
 * #%L
 * JAXX :: Runtime
 * %%
 * Copyright (C) 2008 - 2024 Code Lutin, Ultreia.io
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Lesser Public License for more details.
 *
 * You should have received a copy of the GNU General Lesser Public
 * License along with this program.  If not, see
 * .
 * #L%
 */

import org.nuiton.jaxx.runtime.JAXXContext;
import org.nuiton.jaxx.runtime.context.JAXXInitialContext;
import org.nuiton.jaxx.runtime.swing.session.SwingSessionHelper;

import javax.swing.SwingUtilities;
import java.awt.Frame;
import java.io.Closeable;
import java.util.List;

/**
 * Application context (only one instance should exists and it is initialized by the {@link ApplicationBoot}).
 * 
 * Created by tchemit on 26/01/2018.
 *
 * @author Tony Chemit - [email protected]
 */
public interface ApplicationContext> extends JAXXContext, Closeable {

    /**
     * Install the application into the given {@code context}.
     *
     * @param context where to install application context
     */
    void install(JAXXContext context);

    /**
     * @return a new initial context within this application context.
     */
    JAXXInitialContext toInitialContext();

    /**
     * @return application boot
     */
    ApplicationBoot getBoot();

    /**
     * @return application config
     */
    Config getConfig();

    List> components();

    List> variables();

    /**
     * @return {@code true} if context is closed.
     * @see ApplicationBoot#isClosed()
     */
    boolean isClosed();

    default boolean isClosing() {
        return getBoot().isClosing();
    }
    void addAction(String actionLabel, Runnable action);

    void handlingError(String message, Exception e);

    void handlingError(Exception e);

    void displayInfo(String startMessage);

    @Override
    void close();

    void lock() throws InterruptedException;

    void unlock();

    void busy();

    void notBusy();

    Frame getMainUI();

    Frame newMainUI();

    void removeMainUI();

    SwingSessionHelper getSwingSessionHelper();

    default void setMainUIVisible(Frame ui, boolean replace) {
        SwingUtilities.invokeLater(() -> ui.setVisible(true));
        getSwingSessionHelper().addComponent(ui, replace);
    }

}