PlaceManagerImpl (GWT-Platform 1.3-SNAPSHOT API)

java.lang.Object
- com.gwtplatform.mvp.client.proxy.PlaceManagerImpl

All Implemented Interfaces:

ValueChangeHandler<String>, EventHandler, HasHandlers, Window.ClosingHandler, PlaceManager

Direct Known Subclasses:

DefaultPlaceManager
```
public abstract class PlaceManagerImpl
extends Object
implements PlaceManager, ValueChangeHandler<String>, Window.ClosingHandler
```
Default implementation to be extended of the PlaceManager.

See Also:
DefaultPlaceManager

Constructor Summary

Constructors
Constructor and Description

PlaceManagerImpl(EventBus eventBus, TokenFormatter tokenFormatter)

Constructors
Constructor and Description
`PlaceManagerImpl(EventBus eventBus, TokenFormatter tokenFormatter)`

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`buildHistoryToken(PlaceRequest request)` Builds a string corresponding to the history token to reveal the specified `PlaceRequest`.
`String`	`buildRelativeHistoryToken(int level)` Builds a string corresponding to the history token to reveal the specified place from the current place hierarchy.
`String`	`buildRelativeHistoryToken(PlaceRequest request)` Builds a string corresponding to the history token to reveal the specified `PlaceRequest` as a child of the current place hierarchy.
`String`	`buildRelativeHistoryToken(PlaceRequest request, int level)` Builds a string corresponding to the history token to reveal the specified `PlaceRequest` relative to the other places in the current place hierarchy.
`protected void`	`doRevealPlace(PlaceRequest request, boolean updateBrowserUrl)` Fires the `PlaceRequestInternalEvent` for the given `PlaceRequest`.
`void`	`fireEvent(GwtEvent<?> event)`
`List<PlaceRequest>`	`getCurrentPlaceHierarchy()` Access the current place hierarchy, with the current `PlaceRequest` being the last element of this list.
`PlaceRequest`	`getCurrentPlaceRequest()` Access the current place request, that is, the tail of the place request hierarchy.
`void`	`getCurrentTitle(SetPlaceTitleHandler handler)` Retrieves the title of the currently displayed place, or `null` if it doesn't have a title.
`EventBus`	`getEventBus()` Makes it possible to access the `EventBus` object associated with that presenter.
`int`	`getHierarchyDepth()` Retrieves the number of elements in the place hierarchy.
`void`	`getTitle(int index, SetPlaceTitleHandler handler)` Retrieves the title of a specific place within the place hierarchy.
`boolean`	`hasPendingNavigation()` Checks if the `PlaceManager` has to perform any pending navigation that were not immediately executed because it was requested while the navigation was locked.
`void`	`navigateBack()` Calls `History#back()`.
`void`	`onValueChange(ValueChangeEvent<String> event)` Handles change events from `History`.
`void`	`onWindowClosing(Window.ClosingEvent event)`
`void`	`revealCurrentPlace()` Reveals the place corresponding to the current value of the history token in the URL bar.
`void`	`revealErrorPlace(String invalidHistoryToken)` Reveals the place to display when a user tries to access an invalid place.
`void`	`revealPlace(PlaceRequest request)` Programmatically reveals the specified place, updating the browser URL in the process.
`void`	`revealPlace(PlaceRequest request, boolean updateBrowserUrl)` Programmatically reveals the specified place.
`void`	`revealPlaceHierarchy(List<PlaceRequest> placeRequestHierarchy)` Programmatically reveals the specified hierarchy of places place, updating the browser URL in the process.
`void`	`revealRelativePlace(int level)` Programmatically reveals the specified place from the current place hierarchy.
`void`	`revealRelativePlace(PlaceRequest request)` Programmatically reveals the specified place as a child of the current place hierarchy.
`void`	`revealRelativePlace(PlaceRequest request, int level)` Programmatically reveals the specified place relative to the other places in the current place hierarchy.
`void`	`revealUnauthorizedPlace(String unauthorizedHistoryToken)` Reveals the place to display when a user has been refused the access to a specific place.
`void`	`setOnLeaveConfirmation(String question)` Sets the question that will be displayed whenever the user tries to navigate away from the current page.
`void`	`unlock()` Resets the navigation lock if it is currently set.
`void`	`updateHistory(PlaceRequest request, boolean updateBrowserUrl)` Updates History without firing a `ValueChangeEvent`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.gwtplatform.mvp.client.proxy.PlaceManager
revealDefaultPlace

- Constructor Detail
  - PlaceManagerImpl
```
public PlaceManagerImpl(EventBus eventBus,
                TokenFormatter tokenFormatter)
```
- Method Detail
  - buildHistoryToken
```
public String buildHistoryToken(PlaceRequest request)
```
    Description copied from interface: PlaceManager
    
    Builds a string corresponding to the history token to reveal the specified PlaceRequest. This can be used with a Hyperlink.
    Invoking this history token will discard all the place hierarchy, effectively revealing the request as a top-level place. To keep the place hierarchy, see PlaceManager.buildRelativeHistoryToken(com.gwtplatform.mvp.shared.proxy.PlaceRequest), PlaceManager.buildRelativeHistoryToken(com.gwtplatform.mvp.shared.proxy.PlaceRequest, int) or PlaceManager.buildRelativeHistoryToken(int).
    
    Specified by:
    
    buildHistoryToken in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place for which to build a history token.
    
    Returns:
    The history token.
    See Also:
    PlaceManager.revealPlace(com.gwtplatform.mvp.shared.proxy.PlaceRequest)
  - buildRelativeHistoryToken
```
public String buildRelativeHistoryToken(int level)
```
    Description copied from interface: PlaceManager
    Builds a string corresponding to the history token to reveal the specified place from the current place hierarchy.
    Examples, suppose the current hierarchy is requestA > requestB > requestC
    - Calling revealRelativePlace(-1) will make a link to requestA > requestB
    - Calling revealRelativePlace(1) will make a link to requestA
    - Calling revealRelativePlace(0) will make a link to requestA > requestB > requestC
    - Calling revealRelativePlace(-3) or less will make a link to ""
    - Calling revealRelativePlace(3) or more will make a link to requestA > requestB > requestC
    Specified by:
    
    buildRelativeHistoryToken in interface PlaceManager
    
    Parameters:
    level - If negative, take back that many elements from the tail of the hierarchy. If positive, keep only that many elements from the head of the hierarchy. Passing 0 makes a link to the current place.
    See Also:
    PlaceManager.revealRelativePlace(int)
  - buildRelativeHistoryToken
```
public String buildRelativeHistoryToken(PlaceRequest request)
```
    Description copied from interface: PlaceManager
    
    Builds a string corresponding to the history token to reveal the specified PlaceRequest as a child of the current place hierarchy. Identical to calling PlaceManager.buildRelativeHistoryToken(PlaceRequest, int) with a level of 0.
    To get the history token for revealing as a top-level place, see PlaceManager.buildHistoryToken(com.gwtplatform.mvp.shared.proxy.PlaceRequest). To navigate back to a specific place in the hierarchy, see PlaceManager.buildRelativeHistoryToken(int).
    
    Specified by:
    
    buildRelativeHistoryToken in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place for which to build a history token.
    
    Returns:
    The history token.
    See Also:
    PlaceManager.revealRelativePlace(PlaceRequest)
  - buildRelativeHistoryToken
```
public String buildRelativeHistoryToken(PlaceRequest request,
                               int level)
```
    Description copied from interface: PlaceManager
    Builds a string corresponding to the history token to reveal the specified PlaceRequest relative to the other places in the current place hierarchy.
    To get the history token for revealing as a top-level place, see PlaceManager.buildHistoryToken(com.gwtplatform.mvp.shared.proxy.PlaceRequest). To navigate back to a specific place in the hierarchy, see PlaceManager.buildRelativeHistoryToken(int).
    Examples, suppose the current hierarchy is requestA > requestB > requestC
    - Calling buildRelativeHistoryToken(requestD, 0) will make a link to requestA > requestB > requestC > requestD
    - Calling buildRelativeHistoryToken(requestD, -1) will make a link to requestA > requestB > requestD
    - Calling buildRelativeHistoryToken(requestD, 1) will make a link to requestA > requestD
    - Calling buildRelativeHistoryToken(requestD, -3) will make a link to requestD
    - Calling buildRelativeHistoryToken(requestD, 3) will make a link to requestA > requestB > requestC > requestD
    Specified by:
    
    buildRelativeHistoryToken in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place for which to build a history token.
    level - If 0, then simply appends the request to the current page hierarchy. If negative, take back that many elements from the tail of the hierarchy before appending the request. If positive, keep only that many elements from the head of the hierarchy before appending the request.
    
    Returns:
    The history token.
    See Also:
    PlaceManager.revealRelativePlace(PlaceRequest, int)
  - doRevealPlace
```
protected void doRevealPlace(PlaceRequest request,
                 boolean updateBrowserUrl)
```
    Fires the PlaceRequestInternalEvent for the given PlaceRequest. Do not call this method directly, instead call revealPlace(PlaceRequest) or a related method.
    
    Parameters:
    request - The PlaceRequest to fire.
    updateBrowserUrl - true If the browser URL should be updated, false otherwise.
  - fireEvent
```
public void fireEvent(GwtEvent<?> event)
```
    Specified by:
    
    fireEvent in interface HasHandlers
  - getCurrentPlaceHierarchy
```
public List<PlaceRequest> getCurrentPlaceHierarchy()
```
    Description copied from interface: PlaceManager
    
    Access the current place hierarchy, with the current PlaceRequest being the last element of this list.
    
    Specified by:
    
    getCurrentPlaceHierarchy in interface PlaceManager
    
    Returns:
    The current PlaceRequest.
    See Also:
    PlaceManager.getCurrentPlaceRequest()
  - getCurrentPlaceRequest
```
public PlaceRequest getCurrentPlaceRequest()
```
    Description copied from interface: PlaceManager
    
    Access the current place request, that is, the tail of the place request hierarchy. If the hierarchy is empty this returns an empty PlaceRequest.
    
    Specified by:
    
    getCurrentPlaceRequest in interface PlaceManager
    
    Returns:
    The current PlaceRequest, or an empty one if the hierarchy is empty.
    See Also:
    PlaceManager.getCurrentPlaceHierarchy()
  - getCurrentTitle
```
public void getCurrentTitle(SetPlaceTitleHandler handler)
```
    Description copied from interface: PlaceManager
    
    Retrieves the title of the currently displayed place, or null if it doesn't have a title. Same as calling PlaceManager.getTitle(int, SetPlaceTitleHandler) with a level of PlaceManager.getHierarchyDepth()-1.
    Instead of returning the title directly, this method accepts a callback and will call SetPlaceTitleHandler.onSetPlaceTitle(java.lang.String) as soon as the title is available. This makes it possible for the user to query the title from the server based on the PlaceRequest parameters, for example.
    
    Specified by:
    
    getCurrentTitle in interface PlaceManager
    
    Parameters:
    handler - The SetPlaceTitleHandler to invoke when the place title is available. This will be invoked with null if the place doesn't have a title.
  - getEventBus
```
public EventBus getEventBus()
```
    Description copied from interface: PlaceManager
    
    Makes it possible to access the EventBus object associated with that presenter.
    
    Specified by:
    
    getEventBus in interface PlaceManager
    
    Returns:
    The EventBus associated with that presenter.
  - getHierarchyDepth
```
public int getHierarchyDepth()
```
    Description copied from interface: PlaceManager
    
    Retrieves the number of elements in the place hierarchy. The title of each of these elements can be obtained through PlaceManager.getTitle(int, SetPlaceTitleHandler).
    
    Specified by:
    
    getHierarchyDepth in interface PlaceManager
    
    Returns:
    The depth of the place hierarchy.
  - getTitle
```
public void getTitle(int index,
            SetPlaceTitleHandler handler)
              throws IndexOutOfBoundsException
```
    Description copied from interface: PlaceManager
    
    Retrieves the title of a specific place within the place hierarchy.
    Instead of returning the title directly, this method accepts a callback and will call SetPlaceTitleHandler.onSetPlaceTitle(java.lang.String) as soon as the title is available. This makes it possible for the user to query the title from the server based on the PlaceRequest parameters, for example.
    
    Specified by:
    
    getTitle in interface PlaceManager
    
    Parameters:
    index - The index of the place for which to get a title, 0 is the top-level class, PlaceManager.getHierarchyDepth()-1 is the current place.
    handler - The SetPlaceTitleHandler to invoke when the place title is available. This will be invoked with null if the place doesn't have a title.
    
    Throws:
    
    IndexOutOfBoundsException - If the index is less than 0 or greater or equal to PlaceManager.getHierarchyDepth().
    See Also:
    PlaceManager.getCurrentTitle(SetPlaceTitleHandler)
  - hasPendingNavigation
```
public boolean hasPendingNavigation()
```
    Description copied from interface: PlaceManager
    
    Checks if the PlaceManager has to perform any pending navigation that were not immediately executed because it was requested while the navigation was locked.
    
    Specified by:
    
    hasPendingNavigation in interface PlaceManager
    
    Returns:
    true if there are any pending navigation requests, false otherwise.
  - navigateBack
```
public void navigateBack()
```
    Description copied from interface: PlaceManager
    
    Calls History#back(). This may cause the user's browser to leave your application, if case you call this method from the first page visited.
    
    Specified by:
    
    navigateBack in interface PlaceManager
  - onValueChange
```
public void onValueChange(ValueChangeEvent<String> event)
```
    Handles change events from History.
    
    Specified by:
    
    onValueChange in interface ValueChangeHandler<String>
  - onWindowClosing
```
public void onWindowClosing(Window.ClosingEvent event)
```
    Specified by:
    
    onWindowClosing in interface Window.ClosingHandler
  - revealCurrentPlace
```
public void revealCurrentPlace()
```
    Description copied from interface: PlaceManager
    
    Reveals the place corresponding to the current value of the history token in the URL bar. This will result in a PlaceRequestInternalEvent being fired.
    
    Specified by:
    
    revealCurrentPlace in interface PlaceManager
  - revealErrorPlace
```
public void revealErrorPlace(String invalidHistoryToken)
```
    Description copied from interface: PlaceManager
    
    Reveals the place to display when a user tries to access an invalid place. This is invoked when the history token was not handled by any place within the application. Application-specific place managers should build a PlaceRequest corresponding to the desired presenter and call PlaceManager.revealPlace(PlaceRequest, boolean) with it. Consider passing false as the second parameter of revealPlace, otherwise a new token will be inserted in the browser's history and hitting the browser's back button will take the user back to the invalid page he initially tried to access.
    The default implementation is simply to call PlaceManager.revealDefaultPlace().
    Important! Make sure you build a valid PlaceRequest and that the user has access to it, otherwise you might create an infinite loop.
    
    Specified by:
    
    revealErrorPlace in interface PlaceManager
    
    Parameters:
    invalidHistoryToken - The history token that was not recognised.
  - revealPlace
```
public void revealPlace(PlaceRequest request)
```
    Description copied from interface: PlaceManager
    
    Programmatically reveals the specified place, updating the browser URL in the process. If you don't want the browser's URL to be updated see PlaceManager.revealPlace(PlaceRequest, boolean).
    This discards the current place hierarchy, effectively revealing the request as a top-level place. To keep the current place hierarchy, see PlaceManager.revealRelativePlace(PlaceRequest), PlaceManager.revealRelativePlace(PlaceRequest, int) or PlaceManager.revealRelativePlace(int). To reveal an entire place hierarchy, see PlaceManager.revealPlaceHierarchy(java.util.List<com.gwtplatform.mvp.shared.proxy.PlaceRequest>).
    
    Specified by:
    
    revealPlace in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place to reveal.
    See Also:
    PlaceManager.buildHistoryToken(PlaceRequest)
  - revealPlace
```
public void revealPlace(PlaceRequest request,
               boolean updateBrowserUrl)
```
    Description copied from interface: PlaceManager
    
    Programmatically reveals the specified place.
    This discards the current place hierarchy, effectively revealing the request as a top-level place. To keep the current place hierarchy, see PlaceManager.revealRelativePlace(PlaceRequest), PlaceManager.revealRelativePlace(PlaceRequest, int) or PlaceManager.revealRelativePlace(int). To reveal an entire place hierarchy, see PlaceManager.revealPlaceHierarchy(java.util.List<com.gwtplatform.mvp.shared.proxy.PlaceRequest>).
    
    Specified by:
    
    revealPlace in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place to reveal.
    updateBrowserUrl - true If the browser URL should be updated, false otherwise.
    See Also:
    PlaceManager.buildHistoryToken(PlaceRequest)
  - revealPlaceHierarchy
```
public void revealPlaceHierarchy(List<PlaceRequest> placeRequestHierarchy)
```
    Description copied from interface: PlaceManager
    
    Programmatically reveals the specified hierarchy of places place, updating the browser URL in the process.
    This discards the current place hierarchy, replacing it with the specified place hierarchy. To keep the current place hierarchy, see PlaceManager.revealRelativePlace(PlaceRequest), PlaceManager.revealRelativePlace(PlaceRequest, int) or PlaceManager.revealRelativePlace(int). To reveal a single Place instead of a hierarchy, see PlaceManager.revealPlace(com.gwtplatform.mvp.shared.proxy.PlaceRequest).
    
    Specified by:
    
    revealPlaceHierarchy in interface PlaceManager
  - revealRelativePlace
```
public void revealRelativePlace(int level)
```
    Description copied from interface: PlaceManager
    Programmatically reveals the specified place from the current place hierarchy.
    Examples. Suppose the current hierarchy is requestA > requestB > requestC:
    - Calling revealRelativePlace(-1) makes it requestA > requestB
    - Calling revealRelativePlace(1) makes it requestA
    - Calling revealRelativePlace(0) makes it requestA > requestB > requestC
    - Calling revealRelativePlace(-3) or less calls PlaceManager.revealDefaultPlace()
    - Calling revealRelativePlace(3) or more makes it requestA > requestB > requestC
    Specified by:
    
    revealRelativePlace in interface PlaceManager
    
    Parameters:
    level - If negative, take back that many elements from the tail of the hierarchy. If positive, keep only that many elements from the head of the hierarchy. Passing 0 reveals the current place.
    See Also:
    PlaceManager.buildRelativeHistoryToken(int)
  - revealRelativePlace
```
public void revealRelativePlace(PlaceRequest request)
```
    Description copied from interface: PlaceManager
    
    Programmatically reveals the specified place as a child of the current place hierarchy. Identical to calling PlaceManager.revealRelativePlace(PlaceRequest, int) with a level of 0. This will result in a PlaceRequestInternalEvent being fired.
    To reveal as a top-level place, see PlaceManager.revealPlace(com.gwtplatform.mvp.shared.proxy.PlaceRequest). To navigate back to a specific place in the hierarchy, see PlaceManager.revealRelativePlace(int).
    
    Specified by:
    
    revealRelativePlace in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place to reveal.
    See Also:
    PlaceManager.buildRelativeHistoryToken(PlaceRequest)
  - revealRelativePlace
```
public void revealRelativePlace(PlaceRequest request,
                       int level)
```
    Description copied from interface: PlaceManager
    Programmatically reveals the specified place relative to the other places in the current place hierarchy. This will result in a PlaceRequestInternalEvent being fired.
    To reveal as a top-level place, see PlaceManager.revealPlace(com.gwtplatform.mvp.shared.proxy.PlaceRequest). To navigate back to a specific place in the hierarchy, see PlaceManager.revealRelativePlace(int).
    Examples. Suppose the current hierarchy is requestA > requestB > requestC:
    - Calling revealRelativePlace(requestD, 0) makes it requestA > requestB > requestC > requestD
    - Calling revealRelativePlace(requestD, -1) makes it requestA > requestB > requestD
    - Calling revealRelativePlace(requestD, 1) makes it requestA > requestD
    - Calling revealRelativePlace(requestD, -3) or less makes it requestD
    - Calling revealRelativePlace(requestD, 3) or more makes it requestA > requestB > requestC > requestD
    Specified by:
    
    revealRelativePlace in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest corresponding to the place to reveal.
    level - If 0, then simply appends the request to the current page hierarchy. If negative, take back that many elements from the tail of the hierarchy before appending the request. If positive, keep only that many elements from the head of the hierarchy before appending the request.
    See Also:
    PlaceManager.buildRelativeHistoryToken(PlaceRequest, int)
  - revealUnauthorizedPlace
```
public void revealUnauthorizedPlace(String unauthorizedHistoryToken)
```
    Description copied from interface: PlaceManager
    
    Reveals the place to display when a user has been refused the access to a specific place. This is invoked when the history token is valid but the corresponding place's Place.canReveal() returned false. Application-specific place managers should build a PlaceRequest corresponding to the desired presenter and call PlaceManager.revealPlace(PlaceRequest, boolean) with it. Consider passing true as the second parameter of revealPlace if you navigate, say, to a login page and want the user to be able to navigate back to the unauthorized page after login. If you are displaying a page that simply mentions the error you may want to pass false, otherwise a new token will be inserted in the browser's history and hitting the browser's back button will take the user back to the unauthorized page he initially tried to access.
    The default implementation is simply to call PlaceManager.revealErrorPlace(String).
    Important! Make sure you build a valid PlaceRequest and that the user has access to it, otherwise you might create an infinite loop.
    
    Specified by:
    
    revealUnauthorizedPlace in interface PlaceManager
    
    Parameters:
    unauthorizedHistoryToken - The history token that was not authorized.
  - setOnLeaveConfirmation
```
public void setOnLeaveConfirmation(String question)
```
    Description copied from interface: PlaceManager
    
    Sets the question that will be displayed whenever the user tries to navigate away from the current page. Navigating away can happen either occur by changing the program state (the history token), by entering an external URL or by closing the window. All cases will be handled.
    If the user indicates that he doesn't accept the navigation, then the navigation will be cancelled, NavigationRefusedEvent will be triggered and the current page will remain.
    
    Specified by:
    
    setOnLeaveConfirmation in interface PlaceManager
    
    Parameters:
    question - The question to display. Pass null to accept navigation directly, without asking a question.
  - unlock
```
public void unlock()
```
    Description copied from interface: PlaceManager
    
    Resets the navigation lock if it is currently set. You should usually not call this directly, instead it is meant to be used with presenters that use manual reveal via ProxyPlace.manualReveal(com.gwtplatform.mvp.client.Presenter) and ProxyPlace.manualRevealFailed().
    
    Specified by:
    
    unlock in interface PlaceManager
    
    See Also:
    Presenter.useManualReveal(), ProxyPlace.manualReveal(com.gwtplatform.mvp.client.Presenter), ProxyPlace.manualRevealFailed()
  - updateHistory
```
public void updateHistory(PlaceRequest request,
                 boolean updateBrowserUrl)
```
    Description copied from interface: PlaceManager
    
    Updates History without firing a ValueChangeEvent. Only the last PlaceRequest of the place request hierarchy is modified.
    This method will only work if the passed PlaceRequest has the same name token as the current place request (see PlaceManager.getCurrentPlaceRequest().
    If true is passed as a second parameter, then this method causes a new token to be added to the browser history, affecting the behavior of the browser's back button.
    
    Specified by:
    
    updateHistory in interface PlaceManager
    
    Parameters:
    request - The PlaceRequest to display in the updated history.
    updateBrowserUrl - true If the browser URL should be updated, false otherwise.

Class PlaceManagerImpl

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.gwtplatform.mvp.client.proxy.PlaceManager

Constructor Detail

PlaceManagerImpl

Method Detail

buildHistoryToken

buildRelativeHistoryToken

buildRelativeHistoryToken

buildRelativeHistoryToken

doRevealPlace

fireEvent

getCurrentPlaceHierarchy

getCurrentPlaceRequest

getCurrentTitle

getEventBus

getHierarchyDepth

getTitle

hasPendingNavigation

navigateBack

onValueChange

onWindowClosing

revealCurrentPlace

revealErrorPlace

revealPlace

revealPlace

revealPlaceHierarchy

revealRelativePlace

revealRelativePlace

revealRelativePlace

revealUnauthorizedPlace

setOnLeaveConfirmation

unlock

updateHistory