Class Storage

java.lang.Object
com.google.gwt.storage.client.Storage

public final class Storage extends Object
Implements the HTML5 Storage interface.

You can obtain a Storage by either invoking getLocalStorageIfSupported() or getSessionStorageIfSupported().

Experimental API: This API is still under development and is subject to change.

If Web Storage is NOT supported in the browser, these methods return null.

Note: Storage events into other windows are not supported.

This may not be supported on all browsers.

See Also:
  • Field Details

  • Method Details

    • addStorageEventHandler

      public static HandlerRegistration addStorageEventHandler(StorageEvent.Handler handler)
      Registers an event handler for StorageEvents.
      Parameters:
      handler -
      Returns:
      HandlerRegistration used to remove this handler
      See Also:
    • getLocalStorageIfSupported

      public static Storage getLocalStorageIfSupported()
      Returns a Local Storage.

      The returned storage is associated with the origin of the Document.

      Returns:
      the localStorage instance, or null if Web Storage is NOT supported.
      See Also:
    • getSessionStorageIfSupported

      public static Storage getSessionStorageIfSupported()
      Returns a Session Storage.

      The returned storage is associated with the current top-level browsing context.

      Returns:
      the sessionStorage instance, or null if Web Storage is NOT supported.
      See Also:
    • isLocalStorageSupported

      public static boolean isLocalStorageSupported()
      Returns true if the localStorage part of the Storage API is supported on the running platform.
    • isSessionStorageSupported

      public static boolean isSessionStorageSupported()
      Returns true if the sessionStorage part of the Storage API is supported on the running platform.
    • isSupported

      public static boolean isSupported()
      Returns true if the Storage API (both localStorage and sessionStorage) is supported on the running platform.
    • removeStorageEventHandler

      public static void removeStorageEventHandler(StorageEvent.Handler handler)
      De-registers an event handler for StorageEvents.
      Parameters:
      handler -
      See Also:
    • clear

      public void clear()
      Removes all items in the Storage.
      See Also:
    • getItem

      public String getItem(String key)
      Returns the item in the Storage associated with the specified key.
      Parameters:
      key - the key to a value in the Storage
      Returns:
      the value associated with the given key
      See Also:
    • getLength

      public int getLength()
      Returns the number of items in this Storage.
      Returns:
      number of items in this Storage
      See Also:
    • key

      public String key(int index)
      Returns the key at the specified index.
      Parameters:
      index - the index of the key
      Returns:
      the key at the specified index in this Storage
      See Also:
    • removeItem

      public void removeItem(String key)
      Removes the item in the Storage associated with the specified key.
      Parameters:
      key - the key to a value in the Storage
      See Also:
    • setItem

      public void setItem(String key, String data)
      Sets the value in the Storage associated with the specified key to the specified data. Note: The empty string may not be used as a key.
      Parameters:
      key - the key to a value in the Storage
      data - the value associated with the key
      See Also: