Errai 3.0.1-SNAPSHOT

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


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

Indicates that the target method should be called when the @Page widget it is a member of was 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 @PageShown 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:
Daniel Sachse , Jonathan Fuerth
See Also:
Page, PageState, Navigation, PageShowing


Errai 3.0.1-SNAPSHOT

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