All Downloads are FREE. Search and download functionalities are using the official Maven repository.

ensemble.PageBrowser Maven / Gradle / Ivy

There is a newer version: 2.6.5
Show newest version
/*
 * Copyright (c) 2008, 2014, Oracle and/or its affiliates.
 * All rights reserved. Use is subject to license terms.
 *
 * This file is available and licensed under the following license:
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  - Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  - Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the distribution.
 *  - Neither the name of Oracle Corporation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
package ensemble;

import static ensemble.PlatformFeatures.WEB_SUPPORTED;
import ensemble.samplepage.SourcePage;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.ReadOnlyBooleanProperty;
import javafx.beans.property.ReadOnlyStringProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.scene.Node;
import javafx.scene.layout.Region;
import java.util.LinkedList;
import ensemble.generated.Samples;
import ensemble.samplepage.SamplePage;

/**
 * Sample page navigation with history.
 *
 * Also knows how to create Ensemble pages.
 */
public class PageBrowser extends Region {
    public static final String HOME_URL = "home";
    private HomePage homePage;
    private Page currentPage;
    private SamplePage samplePage;
    private SourcePage sourcePage;
    private String currentPageUrl;
    private DocsPage docsPage;
    private LinkedList pastHistory = new LinkedList<>();
    private LinkedList futureHistory = new LinkedList<>();
    private BooleanProperty forwardPossible = new SimpleBooleanProperty(false);
    public ReadOnlyBooleanProperty forwardPossibleProperty() { return forwardPossible; }
    public boolean isForwardPossible() { return forwardPossible.get(); }
    private BooleanProperty backPossible = new SimpleBooleanProperty(false);
    public ReadOnlyBooleanProperty backPossibleProperty() { return backPossible; }
    public boolean isBackPossible() { return backPossible.get(); }
    private BooleanProperty atHome = new SimpleBooleanProperty(false);
    public ReadOnlyBooleanProperty atHomeProperty() { return atHome; }
    public boolean isAtHome() { return atHome.get(); }
    private StringProperty currentPageTitle = new SimpleStringProperty(null);
    public ReadOnlyStringProperty currentPageTitleProperty() { return currentPageTitle; };
    public String getCurrentPageTitle() { return currentPageTitle.get(); }

    public void forward() {
        String newUrl = futureHistory.pop();
        if (newUrl != null) {
            pastHistory.push(getCurrentPageUrl());
            goToPage(newUrl, null, false);
        }
    }

    public void backward() {
        String newUrl = pastHistory.pop();
        if (newUrl != null) {
            futureHistory.push(getCurrentPageUrl());
            goToPage(newUrl, null, false);
        }
    }

    public void goToSample(SampleInfo sample) {
        goToPage("sample://"+sample.ensemblePath, sample, true);
    }

    public void goToPage(String url) {
        goToPage(url, null, true);
    }

    public void goHome() {
        goToPage(HOME_URL, null, true);
    }

    /**
     * This is called when a inner url has changed inside of a page and we want
     * to update the history.
     *
     * @param newUrl The new url that the currentPage node is displaying
     */
    public void externalPageChange(String newUrl) {
        if (currentPageUrl != null) {
            pastHistory.push(getCurrentPageUrl());
        }
        futureHistory.clear();
        currentPageUrl = newUrl;
    }

    private void goToPage(String url, SampleInfo sample, boolean updateHistory) {
        Page nextPage = null;
        // get node for page
        if (url.equals(HOME_URL)) {
            nextPage = getHomePage();
        } else if (url.startsWith("http://") || url.startsWith("https://")) {
            if (WEB_SUPPORTED) {
                nextPage = updateDocsPage(url);
            } else {
                System.err.println("Web pages are not supported and links to them should be disabled!");
            }
        } else if (sample != null) {
            nextPage = updateSamplePage(sample, url);
        } else if (url.startsWith("sample://")) {
            String samplePath = url.substring("sample://".length());
            if (samplePath.contains("?")) {
                samplePath = samplePath.substring(0, samplePath.indexOf('?') - 1);
            }
            sample = Samples.ROOT.sampleForPath(samplePath);
            if (sample != null) {
                nextPage = updateSamplePage(sample, url);
            } else {
                throw new UnsupportedOperationException("Unknown sample url ["+url+"]");
            }
        } else if (url.startsWith("sample-src://")) {
            String samplePath = url.substring("sample-src://".length());
            if (samplePath.contains("?")) {
                samplePath = samplePath.substring(0, samplePath.indexOf('?') - 1);
            }
            sample = Samples.ROOT.sampleForPath(samplePath);
            if (sample != null) {
                nextPage = updateSourcePage(sample);
            } else {
                System.err.println("Unknown sample url [" + url + "]");
            }
        } else {
            System.err.println("Unknown ensemble page url [" + url + "]");
        }
        if (nextPage != null) {
            // update history
            if (updateHistory) {
                if (currentPageUrl != null) {
                    pastHistory.push(getCurrentPageUrl());
                }
                futureHistory.clear();
            }
            currentPageUrl = url;
            // remove old page
            if (currentPage != null) {
                getChildren().remove((Node) currentPage);
            }
            currentPage = nextPage;
            getChildren().add(currentPage.getNode());
            // update properties
            atHome.set(url.equals(HOME_URL));
            forwardPossible.set(!futureHistory.isEmpty());
            backPossible.set(!pastHistory.isEmpty());
            currentPageTitle.bind(currentPage.titleProperty());
        }
    }

    @Override protected void layoutChildren() {
        if (currentPage != null) {
            currentPage.getNode().resize(getWidth(), getHeight());
        }
    }

    public String getCurrentPageUrl() {
        return currentPageUrl;
    }

    private SamplePage updateSamplePage(SampleInfo sample, String url) {
        if (samplePage == null) {
            samplePage = new SamplePage(sample, url, this);
        } else {
            samplePage.update(sample, url);
        }
        return samplePage;
    }

    private SourcePage updateSourcePage(SampleInfo sample) {
        if (sourcePage == null) {
            sourcePage = new SourcePage();
        }
        sourcePage.setSampleInfo(sample);
        return sourcePage;
    }

    private Page getHomePage() {
        if (homePage == null) {
            homePage = new HomePage(this);
        }
        return homePage;
    }

    private DocsPage updateDocsPage(String url) {
        if (docsPage == null) {
            docsPage = new DocsPage(this);
        }
        docsPage.goToUrl(url);
        return docsPage;
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy