© 2003 BEA Systems, Inc.

com.bea.netuix.servlets.controls.content.backing
Class AbstractJspBacking

java.lang.Object
  |
  +--com.bea.netuix.servlets.controls.content.backing.AbstractJspBacking
All Implemented Interfaces:
JspBacking, Serializable

public class AbstractJspBacking
extends Object
implements JspBacking

Abstract base class for all JSP backing files. This class provides default implementation for all the methods specified in the

JspBacking interface, and provides an additional method to determining if the request was initiated from within this portlet.

A backing file is a simple java class implementing this interface. Backing files work in conjunction with JSPs. The JSPs allow the developer to code the presentation logic, while the backing files allows the developer to code simple business logic. Backing files are always run before the JSPs. A backing file has a lifecycle with four methods (see below). These methods are run 'in order' on all controls. The developer may effect the underlying control from the BackingContext. The BackingContext should be used from the Backing file and the PresentationContext should be used from the JSPs.

Alternately the developer can implement the JspBacking file instead of extending this class.

See Also:
JspBacking, BackingContext, PortletBackingContext, BookBackingContext, PageBackingContext, Serialized Form

Field Summary
protected static Debug _debug
           
 
Constructor Summary
AbstractJspBacking()
           
 
Method Summary
 void dispose()
          This method is called at the end of serving the request (After the JSPs have rendered)
 boolean handlePostbackData(HttpServletRequest request, HttpServletResponse response)
          The purpose of this method is to let an implementation process request data.
 void init(HttpServletRequest request, HttpServletResponse response)
          This method is called once per request, and backing files can do request-scoped initialization by implementing this method.
protected  boolean isRequestTargeted(HttpServletRequest request)
          This method returns true if the current request is due an action within the window/portlet of this backing file.
 boolean preRender(HttpServletRequest request, HttpServletResponse response)
          This method is called before rendering the JSP that this backing file is associated with.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_debug

protected static Debug _debug
Constructor Detail

AbstractJspBacking

public AbstractJspBacking()
Method Detail

init

public void init(HttpServletRequest request,
                 HttpServletResponse response)
Description copied from interface: JspBacking

This method is called once per request, and backing files can do request-scoped initialization by implementing this method. This mathod is run on the window (book/page/portlet) even if the window is not currently on a selected page.

Specified by:
init in interface JspBacking
Parameters:
request - HTTP request
response - HTTP response

handlePostbackData

public boolean handlePostbackData(HttpServletRequest request,
                                  HttpServletResponse response)
Description copied from interface: JspBacking

The purpose of this method is to let an implementation process request data.

This method should return true if it changes the window mode //or window state or the current page.

Specified by:
handlePostbackData in interface JspBacking
Parameters:
request - HTTP request
response - HTTP response
Returns:
boolean

preRender

public boolean preRender(HttpServletRequest request,
                         HttpServletResponse response)
Description copied from interface: JspBacking

This method is called before rendering the JSP that this backing file is associated with. This method will not be run if the book/page/portlet is not being rendered (displayed). This is useful if heavy business logic only needs to be run if this portlet is on a selected page.

This method should return true to let the framework render the JSP. If this method returns false, the framework will not render the content JSP.

Not: if you don't want the Window (book, page or portlet) to render at all set setVisible(false) on the backing context.

Specified by:
preRender in interface JspBacking
Parameters:
request - HTTP request
response - HTTP response
Returns:
boolean
See Also:
BackingContext, PortletBackingContext, BookBackingContext, PageBackingContext

dispose

public void dispose()
Description copied from interface: JspBacking

This method is called at the end of serving the request (After the JSPs have rendered)

Specified by:
dispose in interface JspBacking

isRequestTargeted

protected boolean isRequestTargeted(HttpServletRequest request)

This method returns true if the current request is due an action within the window/portlet of this backing file. Returns false otherwise.

Parameters:
request -

© 2003 BEA Systems, Inc.

Copyright © 2003 BEA Systems, Inc. All Rights Reserved