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,v 1.5 2004/02/19 17:38:00 hlship Exp $
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

public 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

public 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

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


getResourceResolver

public IResourceResolver getResourceResolver()
Since:
3.0