Errai 3.0.1-SNAPSHOT

org.jboss.errai.ui.nav.client.local
Annotation Type PageShowing


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

Indicates that the target method should be called when the @Page widget it is a member of is about to be displayed in the navigation content panel: after the widget's @PageState fields have been updated and before it is displayed in the navigation content panel.

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 @PageShowing 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:
Jonathan Fuerth
See Also:
Page, PageState, Navigation, PageShown


Errai 3.0.1-SNAPSHOT

Copyright © 2013-2014 JBoss, a division of Red Hat. All Rights Reserved.