com.cedarsolutions.client.gwt.widget.NativeUtils Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of cedar-common-gwt Show documentation

Utility code for use with GWT and Mvp4g.

There is a newer version: 5.8.4

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *
 *              C E D A R
 *          S O L U T I O N S       "Software done right."
 *           S O F T W A R E
 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *
 * Copyright (c) 2013-2014 Kenneth J. Pronovici.
 * All rights reserved.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the Apache License, Version 2.0.
 * See LICENSE for more information about the licensing terms.
 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *
 * Author   : Kenneth J. Pronovici 
 * Language : Java 6
 * Project  : Common Java Functionality
 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
package com.cedarsolutions.client.gwt.widget;

/**
 * Utility methods implemented in native Javascript.
 *
 * 
 * Generally speaking, methods in here are intended to be used only
 * by other utility classes, i.e. WidgetUtils.  Calling these directly
 * in your code makes it difficult to unit test, because they can't
 * really be mocked.  That's why they're all kept together here in
 * this utility class.  Applications should follow a similar pattern.
 * 
 *
 * @author Kenneth J. Pronovici 
 */
public class NativeUtils {

    /** Get $wnd.location.href from the browser's DOM. */
    public static native String getWndLocationHref() /*-{
        return $wnd.location.href;
    }-*/;

    /** Redirect the current page to an external URL. */
    public static native void redirect(String url) /*-{
        $wnd.location = url;
    }-*/;

    /**
     * Open the referenced URL, as for download via a button click.
     * @see Stack Overflow
     */
    public static native void openUrl(String url)/*-{
        $wnd.open(url, "target=_blank")
    }-*/;

}