org.apache.tapestry.engine
Interface IPageSource

All Known Implementing Classes:
PageSource

public interface IPageSource

Abstracts the process of loading pages from thier specifications as well as pooling of pages once loaded.

If the required page is not available, a page source may use an instance of IPageLoader to actually load the page (and all of its nested components).

Version:
$Id: IPageSource.java 243791 2004-02-19 17:38:13Z hlship $
Author:
Howard Lewis Ship

Method Summary
 IPage getPage(IRequestCycle cycle, String pageName, IMonitor monitor)
          Gets a given page for the engine.
 IResourceResolver getResourceResolver()
           
 void releasePage(IPage page)
          Invoked after the engine is done with the page (typically, after the response to the client has been sent).
 void reset()
          Invoked to have the source clear any internal cache.
 

Method Detail

getPage

IPage getPage(IRequestCycle cycle,
              String pageName,
              IMonitor monitor)
Gets a given page for the engine. This may involve using a previously loaded page from a pool of available pages, or the page may be loaded as needed.

Parameters:
cycle - the current request cycle
pageName - the name of the page. May be qualified with a library id prefix, which may even be nested. Unqualified names are searched for extensively in the application namespace, and then in the framework namespace.
monitor - informed of any page loading activity

releasePage

void releasePage(IPage page)
Invoked after the engine is done with the page (typically, after the response to the client has been sent). The page is returned to the pool for later reuse.


reset

void reset()
Invoked to have the source clear any internal cache. This is most often used when debugging an application.


getResourceResolver

IResourceResolver getResourceResolver()
Since:
3.0