Java Doc for AbstractPageBean.java in  » IDE-Netbeans » visualweb.api.designer » com » sun » rave » web » ui » appbase » Java Source Code / Java DocumentationJava Source Code and Java Documentation

AbstractPageBean is the abstract base class for every page bean associated with a JSP page containing JavaServer Faces components. It extends FacesBean , so it inherits all of the default integration behavior found there.

In addition to event handler methods that you create while building your application, the runtime environment will also call the following lifecycle related methods at appropriate points during the execution of your application:

• init() - Called whenever you navigate to the corresponding JSP page, either directly (via a URL) or indirectly via page navigation from a different page. You can override this method to acquire any resources that will always be needed by this page.
• preprocess() - If this request is a postback (i.e. your page is about to process an incoming form submit, this method will be called after the original component tree has been restored, but before any standard JavaServer Faces event processing is done (i.e. this is called before Apply Request Values phase of the request processing lifecycle). Override this method to acquire any resources that will be needed by event handlers (such as action methods, validator methods, or value change listener methods) that will be executed while executing the request processing lifecycle.
• prerender() - If this page is the one that will be rendering the response, this method is called after any event processing, but before the actual rendering. Override this method to acquire resources that are only needed when a page is being rendered.
• destroy() - Called unconditionally if init() was called, after completion of rendering by whichever page was actually rendered. Override this method to release any resources allocated in the init(), preprocess(), or prerender() methods (or in an event handler).

For advanced users, and as a carry forward from previous versions of Sun Java Studio Creator, page bean instances are also registered automatically as a JavaServer Faces PhaseListener. For each lifecycle phase, there is an appropriate "before" and "after" event method, which you can override to provide phase-specific behavior. For example, if you wanted to provide some special logic that happened before or after the Update Model Values phase, you would override one of the methods:

 public void beforeUpdateModelValues();
 public void afterUpdateModelValues();
 

Callback method that is called after rendering is completed for this request, if init() was called, regardless of whether or not this was the page that was actually rendered.

Callback method that is called whenever a page is navigated to, either directly via a URL, or indirectly via page navigation.

Return true if the current request was a post back for an existing view, rather than the creation of a new view.

Callback method that is called after the component tree has been restored, but before any event processing takes place.

Callback method that is called just before rendering takes place. This method will only be called for the page that will actually be rendered (and not, for example, on a page that handled a post back and then navigated to a different page).

Skip any remaining request processing lifecycle phases for the current request, and go immediately to Render Response phase.

Skip any remaining request processing lifecycle phases for the current request, including Render Response phase.

Construct a new instance of this bean.

Call through to the appropriate "after event" method, depending upon the PhaseId in this event.

Call through to the appropriate "before event" method, depending upon the PhaseId in this event.

Callback method that is called after rendering is completed for this request, if init() was called, regardless of whether or not this was the page that was actually rendered. Override this method to release resources acquired in the init(), preprocess(), or prerender() methods (or acquired during execution of an event handler).

The default implementation does nothing.

Callback method that is called whenever a page is navigated to, either directly via a URL, or indirectly via page navigation. Override this method to acquire resources that will be needed for event handlers and lifecycle methods, whether or not this page is performing post back processing.

The default implementation does nothing.

Return true if the current request was a post back for an existing view, rather than the creation of a new view. The result of this method may be used to conditionally execute one time setup that is only required when a page is first displayed.

Callback method that is called after the component tree has been restored, but before any event processing takes place. This method will only be called on a "post back" request that is processing a form submit. Override this method to allocate resources that will be required in your event handlers.

The default implementation does nothing.

Callback method that is called just before rendering takes place. This method will only be called for the page that will actually be rendered (and not, for example, on a page that handled a post back and then navigated to a different page). Override this method to allocate resources that will be required for rendering this page.

The default implementation does nothing.

Skip any remaining request processing lifecycle phases for the current request, and go immediately to Render Response phase. This method is typically invoked when you want to throw away input values provided by the user, instead of processing them.

Skip any remaining request processing lifecycle phases for the current request, including Render Response phase. This is appropriate if you have completed the response through some means other than JavaServer Faces rendering.