io.crysknife.ui.navigation.client.local

Annotation Type PageUpdate

@Target(value=METHOD)
 @Retention(value=RUNTIME)
 @Documented
public @interface PageUpdate

Indicates that the target method should be called when the Page state has been updated from Navigation.updateState(Multimap). This will not be invoked when a full page navigation cycle is invoked. Instead PageShown is more appropriate for full navigation requests.

When the client-side application is bootstrapping (the page is loading in the browser), the Navigation system waits until all Errai modules are fully initialized before displaying the initial page. Hence, it is safe to make RPC requests and to fire portable CDI events from within a PageUpdate method.

The target method is permitted an optional parameter of type HistoryToken. If the parameter is present, the framework will pass in the history token that caused the page to show. This is useful in cases where not all history token key names are known at compile time, so @PageState fields can't be declared to accept their values.

The target method's return type must be void.

The target method can have any access type: public, protected, default, or private.

If the target method throws an exception when called, behaviour is undefined.

Author:

Ben Dol

See Also:

Page, PageState, Navigation, PageShown