Package com.google.gwt.user.client
Class Window.Location
java.lang.Object
com.google.gwt.user.client.Window.Location
- Enclosing class:
Window
This class provides access to the browser's location's object. The location
object contains information about the current URL and methods to manipulate
it.
Location
is a very simple wrapper, so not all browser
quirks are hidden from the user.-
Method Summary
Modifier and TypeMethodDescriptionstatic void
Assigns the window to a new URL.buildListParamMap
(String queryString) Builds the immutable map from String to Listthat we'll return in getParameterMap(). static UrlBuilder
Create aUrlBuilder
based on thisWindow.Location
.static String
getHash()
Gets the string to the right of the URL's hash.static String
getHost()
Gets the URL's host and port name.static String
Gets the URL's host name.static String
getHref()
Gets the entire URL.static String
getParameter
(String name) Gets the URL's parameter of the specified name.Returns an immutable Map of the URL query parameters for the host page at the time this method was called.static String
getPath()
Gets the path to the URL.static String
getPort()
Gets the URL's port.static String
Gets the URL's protocol.static String
Gets the URL's query string.static void
reload()
Reloads the current browser window.static void
Replaces the current URL with a new one.
-
Method Details
-
assign
Assigns the window to a new URL. All GWT state will be lost.- Parameters:
newURL
- the new URL
-
createUrlBuilder
Create aUrlBuilder
based on thisWindow.Location
.- Returns:
- the new builder
-
getHash
Gets the string to the right of the URL's hash.- Returns:
- the string to the right of the URL's hash.
-
getHost
Gets the URL's host and port name.- Returns:
- the host and port name
-
getHostName
Gets the URL's host name.- Returns:
- the host name
-
getHref
Gets the entire URL.- Returns:
- the URL
-
getParameter
Gets the URL's parameter of the specified name. Note that if multiple parameters have been specified with the same name, the last one will be returned.- Parameters:
name
- the name of the URL's parameter- Returns:
- the value of the URL's parameter, or null if missing
-
getParameterMap
Returns an immutable Map of the URL query parameters for the host page at the time this method was called. Any changes to the window's location will be reflected in the result of subsequent calls.- Returns:
- a map from URL query parameter names to a list of values
-
getPath
Gets the path to the URL.- Returns:
- the path to the URL.
-
getPort
Gets the URL's port.- Returns:
- the URL's port
-
getProtocol
Gets the URL's protocol.- Returns:
- the URL's protocol.
-
getQueryString
Gets the URL's query string.- Returns:
- the URL's query string
-
reload
public static void reload()Reloads the current browser window. All GWT state will be lost. -
replace
Replaces the current URL with a new one. All GWT state will be lost. In the browser's history, the current URL will be replaced by the new URL.- Parameters:
newURL
- the new URL
-
buildListParamMap
Builds the immutable map from String to Listthat we'll return in getParameterMap(). Package-protected for testing. - Returns:
- a map from the
-