org.uberfire.client.workbench.WorkbenchLayoutImpl.java Source code

Java tutorial

Introduction

Here is the source code for org.uberfire.client.workbench.WorkbenchLayoutImpl.java

Source

/*
 * Copyright 2016 Red Hat, Inc. and/or its affiliates.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.uberfire.client.workbench;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Comparator;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import javax.annotation.PostConstruct;
import javax.enterprise.context.ApplicationScoped;
import javax.inject.Inject;

import com.google.gwt.animation.client.Animation;
import com.google.gwt.core.client.Scheduler;
import com.google.gwt.dom.client.Style;
import com.google.gwt.dom.client.Style.Position;
import com.google.gwt.dom.client.Style.Unit;
import com.google.gwt.user.client.Timer;
import com.google.gwt.user.client.Window;
import com.google.gwt.user.client.ui.AbsolutePanel;
import com.google.gwt.user.client.ui.DockLayoutPanel;
import com.google.gwt.user.client.ui.HasWidgets;
import com.google.gwt.user.client.ui.HeaderPanel;
import com.google.gwt.user.client.ui.RequiresResize;
import com.google.gwt.user.client.ui.SimpleLayoutPanel;
import com.google.gwt.user.client.ui.Widget;
import org.jboss.errai.common.client.dom.DOMUtil;
import org.jboss.errai.common.client.dom.Div;
import org.jboss.errai.common.client.dom.HTMLElement;
import org.jboss.errai.common.client.ui.ElementWrapperWidget;
import org.jboss.errai.ioc.client.container.SyncBeanDef;
import org.jboss.errai.ioc.client.container.SyncBeanManager;
import org.uberfire.client.util.Layouts;
import org.uberfire.client.workbench.docks.UberfireDocksContainer;
import org.uberfire.client.workbench.widgets.dnd.WorkbenchDragAndDropManager;
import org.uberfire.client.workbench.widgets.dnd.WorkbenchPickupDragController;
import org.uberfire.workbench.model.PerspectiveDefinition;

import static java.util.Collections.sort;

/**
 * The default layout implementation.
 */
@ApplicationScoped
public class WorkbenchLayoutImpl implements WorkbenchLayout {

    public static final String UF_MAXIMIZED_PANEL = "uf-maximized-panel";

    /**
     * Holder for style information that was modified in order to maximize a panel.
     */

    private static final int MAXIMIZED_PANEL_Z_INDEX = 100;
    /**
     * Dock Layout panel: in center root perspective and also (if available) with east west south docks
     */
    private final DockLayoutPanel rootContainer = new DockLayoutPanel(Unit.PX);
    /**
     * The panel within which the current perspective's root view resides. This panel lasts the lifetime of the app; it's
     * cleared and repopulated with the new perspective's root view each time
     * {@link org.uberfire.client.workbench.PanelManager#setPerspective(PerspectiveDefinition)} gets called.
     */
    private final SimpleLayoutPanel perspectiveRootContainer = new SimpleLayoutPanel();
    private final Map<Widget, OriginalStyleInfo> maximizedWidgetOriginalStyles = new HashMap<Widget, OriginalStyleInfo>();
    private SyncBeanManager iocManager;
    /**
     * Top-level widget of the whole workbench layout. This panel contains the nested container panels for headers,
     * footers, and the current perspective. During a normal startup of UberFire, this panel would be added directly to
     * the RootLayoutPanel.
     */
    private HeaderPanel root;
    /**
     * The panel within which the current perspective's header widgets reside. This panel lasts the lifetime of the app;
     * it's cleared and repopulated with the new perspective's root view each time
     * {@link #setHeaderContents(java.util.List)} gets called.
     */
    private Div headerPanel;
    /**
     * The panel within which the current perspective's footer widgets reside. This panel lasts the lifetime of the app;
     * it's cleared and repopulated with the new perspective's root view each time
     * {@link #setFooterContents(java.util.List)} gets called. The actual panel that's used for this is specified by the
     * concrete subclass's constructor.
     */
    private Div footerPanel;
    private WorkbenchDragAndDropManager dndManager;
    /**
     * An abstraction for DockLayoutPanel used by Uberfire Docks.
     */
    private UberfireDocksContainer uberfireDocksContainer;
    /**
     * We read the drag boundary panel out of this, and sandwich it between the root panel and the perspective container panel.
     */
    private WorkbenchPickupDragController dragController;

    public WorkbenchLayoutImpl() {

    }

    @Inject
    public WorkbenchLayoutImpl(SyncBeanManager iocManager, HeaderPanel root, WorkbenchDragAndDropManager dndManager,
            UberfireDocksContainer uberfireDocksContainer, WorkbenchPickupDragController dragController,
            Div headerPanel, Div footerPanel) {

        this.iocManager = iocManager;
        this.root = root;
        this.dndManager = dndManager;
        this.uberfireDocksContainer = uberfireDocksContainer;
        this.dragController = dragController;
        this.headerPanel = headerPanel;
        this.footerPanel = footerPanel;
    }

    @PostConstruct
    private void init() {
        perspectiveRootContainer.ensureDebugId("perspectiveRootContainer");
        headerPanel.setId("workbenchHeaderPanel");
        footerPanel.setId("workbenchFooterPanel");
        dragController.getBoundaryPanel().ensureDebugId("workbenchDragBoundary");
        root.addStyleName("uf-workbench-layout");
    }

    @Override
    public HeaderPanel getRoot() {
        return root;
    }

    @Override
    public HasWidgets getPerspectiveContainer() {
        return perspectiveRootContainer;
    }

    void setHeaderContents(List<Header> headers) {
        DOMUtil.removeAllChildren(headerPanel);
        if (!headers.isEmpty()) {
            for (Header h : headers) {
                headerPanel.appendChild(h.getElement());
            }
            root.setHeaderWidget(createWidgetFrom(headerPanel));
        }
    }

    void setFooterContents(List<Footer> footers) {
        DOMUtil.removeAllChildren(footerPanel);
        if (!footers.isEmpty()) {
            for (Footer f : footers) {
                footerPanel.appendChild(f.getElement());
            }
            root.setFooterWidget(createWidgetFrom(footerPanel));
        }
    }

    ElementWrapperWidget<?> createWidgetFrom(HTMLElement h) {
        return ElementWrapperWidget.getWidget(h);
    }

    @Override
    public void onBootstrap() {
        dndManager.unregisterDropControllers();

        AbsolutePanel dragBoundary = dragController.getBoundaryPanel();
        dragBoundary.add(perspectiveRootContainer);

        setupDocksContainer();
        rootContainer.add(dragBoundary);

        Layouts.setToFillParent(perspectiveRootContainer);
        Layouts.setToFillParent(dragBoundary);
        Layouts.setToFillParent(rootContainer);

        root.setContentWidget(rootContainer);
    }

    private void setupDocksContainer() {
        uberfireDocksContainer.setup(rootContainer, () -> Scheduler.get().scheduleDeferred(() -> onResize()));
    }

    @Override
    public void onResize() {
        resizeTo(Window.getClientWidth(), Window.getClientHeight());
    }

    @Override
    public void resizeTo(int width, int height) {
        root.setPixelSize(width, height);

        // The dragBoundary can't be a LayoutPanel, so it doesn't support ProvidesResize/RequiresResize.
        // We start the cascade of onResize() calls at its immediate child.
        perspectiveRootContainer.onResize();

        new Timer() {
            @Override
            public void run() {
                updateMaximizedPanelSizes();
            }
        }.schedule(5);
    }

    private void updateMaximizedPanelSizes() {
        for (Widget w : maximizedWidgetOriginalStyles.keySet()) {
            Style style = w.getElement().getStyle();
            style.setTop(perspectiveRootContainer.getAbsoluteTop(), Unit.PX);
            style.setLeft(perspectiveRootContainer.getAbsoluteLeft(), Unit.PX);
            style.setWidth(perspectiveRootContainer.getOffsetWidth(), Unit.PX);
            style.setHeight(perspectiveRootContainer.getOffsetHeight(), Unit.PX);

            if (w instanceof RequiresResize) {
                ((RequiresResize) w).onResize();
            }
        }
    }

    @Override
    public void maximize(final Widget w) {
        if (maximizedWidgetOriginalStyles.get(w) != null) {
            return;
        }

        // this allows application-specified background colour, animation, borders, etc.
        w.addStyleName(UF_MAXIMIZED_PANEL);

        new ExpandAnimation(w, maximizedWidgetOriginalStyles, perspectiveRootContainer).run();
    }

    @Override
    public void unmaximize(Widget w) {

        w.removeStyleName(UF_MAXIMIZED_PANEL);

        new CollapseAnimation(w, maximizedWidgetOriginalStyles).run();
    }

    @Override
    public void setMarginWidgets(boolean isStandaloneMode, Set<String> headersToKeep) {
        setHeaderContents(discoverMarginWidgets(isStandaloneMode, headersToKeep, Header.class));
        setFooterContents(discoverMarginWidgets(isStandaloneMode, headersToKeep, Footer.class));
    }

    private <T extends Orderable> List<T> discoverMarginWidgets(boolean isStandaloneMode, Set<String> headersToKeep,
            Class<T> marginType) {
        final Collection<SyncBeanDef<T>> headerBeans = iocManager.lookupBeans(marginType);
        final List<T> instances = new ArrayList<T>();
        for (final SyncBeanDef<T> headerBean : headerBeans) {
            if (!headerBean.isActivated()) {
                continue;
            }

            T instance = headerBean.getInstance();

            // for regular mode (not standalone) we add every header and footer widget;
            // for standalone mode, we only add the ones requested in the URL
            if ((!isStandaloneMode) || headersToKeep.contains(instance.getId())) {
                instances.add(instance);
            }
        }
        sort(instances, new Comparator<Orderable>() {
            @Override
            public int compare(final Orderable o1, final Orderable o2) {
                if (o1.getOrder() < o2.getOrder()) {
                    return 1;
                } else if (o1.getOrder() > o2.getOrder()) {
                    return -1;
                } else {
                    return 0;
                }
            }
        });

        return instances;
    }

    protected Div getHeaderPanel() {
        return headerPanel;
    }

    protected Div getFooterPanel() {
        return footerPanel;
    }

    protected static abstract class AbstractResizeAnimation extends Animation {

        protected final Style style;
        protected final Widget w;
        protected final Map<Widget, OriginalStyleInfo> maximizedWidgetOriginalStyles;

        public AbstractResizeAnimation(final Widget w,
                final Map<Widget, OriginalStyleInfo> maximizedWidgetOriginalStyles) {
            this.w = w;
            this.maximizedWidgetOriginalStyles = maximizedWidgetOriginalStyles;
            style = w.getElement().getStyle();
        }

        @Override
        protected void onUpdate(double progress) {
            final double width = newTarget(w.getElement().getClientWidth(), getTargetWidth(), progress);
            style.setWidth(width, Unit.PX);
            final double height = newTarget(w.getElement().getClientHeight(), getTargetHeight(), progress);
            style.setHeight(height, Unit.PX);
            final double top = newTarget(w.getAbsoluteTop(), getTargetTop(), progress);
            style.setTop(top, Unit.PX);
            final double left = newTarget(w.getAbsoluteLeft(), getTargetLeft(), progress);
            style.setLeft(left, Unit.PX);
        }

        public abstract int getTargetWidth();

        public abstract int getTargetHeight();

        public abstract int getTargetTop();

        public abstract int getTargetLeft();

        public void run() {
            super.run(1000);
        }

        private double newTarget(int current, int target, double progress) {
            return Math.round(current + ((target - current) * progress));
        }

        public void onResize() {
            if (w instanceof RequiresResize) {
                ((RequiresResize) w).onResize();
            }
        }
    }

    protected static class ExpandAnimation extends AbstractResizeAnimation {

        protected final SimpleLayoutPanel perspectiveRootContainer;

        public ExpandAnimation(final Widget w, final Map<Widget, OriginalStyleInfo> maximizedWidgetOriginalStyles,
                final SimpleLayoutPanel perspectiveRootContainer) {
            super(w, maximizedWidgetOriginalStyles);
            this.perspectiveRootContainer = perspectiveRootContainer;
        }

        @Override
        protected void onStart() {
            maximizedWidgetOriginalStyles.put(w, new OriginalStyleInfo(w));
            style.setZIndex(MAXIMIZED_PANEL_Z_INDEX);
            style.setHeight(w.getElement().getClientHeight(), Unit.PX);
            style.setWidth(w.getElement().getClientWidth(), Unit.PX);
            style.setTop(w.getAbsoluteTop(), Unit.PX);
            style.setLeft(w.getAbsoluteLeft(), Unit.PX);
            style.setPosition(Position.FIXED);
        }

        @Override
        public int getTargetWidth() {
            return perspectiveRootContainer.getOffsetWidth();
        }

        @Override
        public int getTargetHeight() {
            return perspectiveRootContainer.getOffsetHeight();
        }

        @Override
        public int getTargetTop() {
            return perspectiveRootContainer.getAbsoluteTop();
        }

        @Override
        public int getTargetLeft() {
            return perspectiveRootContainer.getAbsoluteLeft();
        }

        @Override
        protected void onComplete() {
            super.onComplete();
            onResize();
        }
    }

    protected static class CollapseAnimation extends AbstractResizeAnimation {

        private final OriginalStyleInfo originalStyleInfo;

        public CollapseAnimation(final Widget w,
                final Map<Widget, OriginalStyleInfo> maximizedWidgetOriginalStyles) {
            super(w, maximizedWidgetOriginalStyles);
            originalStyleInfo = maximizedWidgetOriginalStyles.remove(w);
        }

        @Override
        public int getTargetWidth() {
            return originalStyleInfo.getClientWidth();
        }

        @Override
        public int getTargetHeight() {
            return originalStyleInfo.getClientHeight();
        }

        @Override
        public int getTargetTop() {
            return originalStyleInfo.getAbsoluteTop();
        }

        @Override
        public int getTargetLeft() {
            return originalStyleInfo.getAbsoluteLeft();
        }

        @Override
        protected void onComplete() {
            originalStyleInfo.restore(w);
            onResize();
        }
    }

    /**
     * Holder for style information that was modified in order to maximize a panel.
     */
    protected static class OriginalStyleInfo {

        private String position;
        private String top;
        private String left;
        private String width;
        private String height;
        private String zIndex;
        private int absoluteTop;
        private int absoluteLeft;
        private int clientHeight;
        private int clientWidth;

        public OriginalStyleInfo(final Widget w) {
            absoluteLeft = w.getAbsoluteLeft();
            absoluteTop = w.getAbsoluteTop();
            clientHeight = w.getElement().getClientHeight();
            clientWidth = w.getElement().getClientWidth();

            final Style style = w.getElement().getStyle();
            position = style.getPosition();
            top = style.getTop();
            left = style.getLeft();
            width = style.getWidth();
            height = style.getHeight();
            zIndex = style.getZIndex();
        }

        /**
         * Restores to {@code w} all style values to those most recently set on this instance.
         * @param w the widget to restore styles on.
         */
        public void restore(final Widget w) {
            final Style style = w.getElement().getStyle();
            style.setProperty("position", position);
            style.setProperty("top", top);
            style.setProperty("left", left);
            style.setProperty("width", width);
            style.setProperty("height", height);
            style.setProperty("zIndex", zIndex);
        }

        public int getAbsoluteTop() {
            return absoluteTop;
        }

        public int getAbsoluteLeft() {
            return absoluteLeft;
        }

        public int getClientHeight() {
            return clientHeight;
        }

        public int getClientWidth() {
            return clientWidth;
        }
    }
}