org.apache.tapestry.engine
Interface IEngineServiceView

All Superinterfaces:

IEngine

All Known Implementing Classes:

AbstractEngine, BaseEngine, WMLEngine

public interface IEngineServiceView
extends IEngine

Additional methods implemented by the engine that are exposed to engine services.

Since:

1.0.9

Version:

$Id: IEngineServiceView.java 243791 2004-02-19 17:38:13Z hlship $

Author:

Howard Lewis Ship

Field Summary

Fields inherited from interface org.apache.tapestry.IEngine

EXCEPTION_PAGE, HOME_PAGE, STALE_LINK_PAGE, STALE_SESSION_PAGE

Method Summary

void	clearCachedData() Invoked (typically by the reset service) to clear all cached data known to the engine.
void	renderResponse(IRequestCycle cycle, ResponseOutputStream output) Invoked by a service to force the page selected by the IRequestCycle to be renderred.
void	reportException(String reportTitle, Throwable ex) Writes a detailed report of the exception to System.err.
void	restart(IRequestCycle cycle) Invoked to restart the application from start; this most frequently follows some kind of catastrophic failure.

Methods inherited from interface org.apache.tapestry.IEngine

createPageRecorder, forgetPage, getComponentClassEnhancer, getComponentMessagesSource, getContextPath, getDataSqueezer, getGlobal, getLocale, getOutputEncoding, getPageRecorder, getPageSource, getPool, getPropertySource, getResourceChecksumSource, getResourceResolver, getScriptSource, getService, getServletPath, getSpecification, getSpecificationSource, getTemplateSource, getVisit, getVisit, isResetServiceEnabled, isStateful, service, setLocale, setVisit

Method Detail

renderResponse

void renderResponse(IRequestCycle cycle,
                    ResponseOutputStream output)
                    throws ServletException,
                           IOException

Invoked by a service to force the page selected by the IRequestCycle to be renderred. This takes care of a number of bookkeeping issues, such as committing changes in page recorders.

Throws:

ServletException

IOException

restart

void restart(IRequestCycle cycle)
             throws IOException

Invoked to restart the application from start; this most frequently follows some kind of catastrophic failure. This will invalidate any HttpSession and force a redirect to the application servlet (i.e., invoking the home service in a subsequent request cycle).

Throws:

IOException

clearCachedData

void clearCachedData()

Invoked (typically by the reset service) to clear all cached data known to the engine. This includes pages, templates, helper beans, specifications, localized strings, etc., and is used during debugging.

reportException

void reportException(String reportTitle,
                     Throwable ex)

Writes a detailed report of the exception to System.err. This is invoked by services that can't write an HTML description of the error because they don't provide text/html content (such as an asset that creates an image).

Since:

1.0.10