Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2003 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.bea.netuix.servlets.controls.content.backing
Interface JspBacking

All Superinterfaces:
  Serializable

All Known Implementing Classes:
  AbstractJspBacking

public interface JspBacking
extends Serializable

This interface specifies a backing file. 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 extend the `AbstractJspBacking` file instead of implementing this interface.

Typically a new instance of this class (backing file) is created per request and is not shared across books/pages/portlets. If, however, `'threadsafe'` is marked as `true` on the `JspContent` control a shared instance will be used. This instance is shared even across multiple request. I slight performance boost can be gained by setting the 'threadsafe' attribute to true as a new instance need not be created per each request. However, any instance variables will need to be synchronized if not threadsafe. It is also recommended to use this setting with caution when your backing file is registered to receive portlet events./p>

See Also:
  `AbstractJspBacking`, `BackingContext`, `PortletBackingContext`, `BookBackingContext`, `PageBackingContext`

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.
`boolean` | `preRender(HttpServletRequest request, HttpServletResponse response)` This method is called before rendering the JSP that this backing file is associated with.

Method Detail

### init

    public 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. This mathod is run on the window (book/page/portlet) even if the window is not currently on a selected page.

  Parameters:
    `request` - HTTP request
    `response` - HTTP response

### handlePostbackData

    public boolean handlePostbackData(HttpServletRequest request,
                                      HttpServletResponse response)

  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.

  Parameters:
    `request` - HTTP request
    `response` - HTTP response
  Returns:
    boolean

### preRender

    public boolean preRender(HttpServletRequest request,
                             HttpServletResponse response)

  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.

  Parameters:
    `request` - HTTP request
    `response` - HTTP response
  Returns:
    boolean
  See Also:
    `BackingContext`, `PortletBackingContext`, `BookBackingContext`, `PageBackingContext`

### dispose

    public void dispose()

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

Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2003 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2003 BEA Systems, Inc. All Rights Reserved