TCustomWebApplication class

In unit CustWeb

Base class for web applications with integrated request handling

Declaration

pascal

TCustomWebApplication = class(TCustomApplication)

Inheritance

Description

TCustomWebApplication extends TCustomApplication to provide web-specific functionality. It integrates a TWebHandler instance for processing HTTP requests and provides properties for configuring web application behavior.

This class serves as the foundation for all web application implementations including CGI, FastCGI, and other HTTP hosting environments. It handles application lifecycle, event logging, and web handler management.

Errors

May raise exceptions during web handler initialization or request processing.

Properties

`WebHandler`	protected
`HandleGetOnPost`	public	Controls whether GET requests are handled by POST handlers
`RedirectOnError`	public	Controls whether errors trigger HTTP redirects
`RedirectOnErrorURL`	public	URL template for error redirects
`ApplicationURL`	public	Base URL for the web application
`AllowDefaultModule`	public	Controls whether requests without module names use default modules
`DefaultModuleName`	public	Name of the default HTTP module
`ModuleVariable`	public	Query parameter name for specifying HTTP module names
`Email`	public	Administrator email address for error notifications
`Administrator`	public	Administrator name for error pages
`EventLog`	public	Event log instance for logging web application events
`PreferModuleName`	public	Controls module name extraction preference
`LegacyRouting`	public	Controls whether to use legacy request routing
`IncludeStackTraceInErrorPage`	public

Methods

`DoRun`	protected
`CreateEventLog`	protected
`FreeEventLog`	protected
`InitializeWebHandler`	protected
`DoLog`	protected
`SetTitle`	protected
`Create`	public	Creates and initializes a new web application instance
`Destroy`	public	Destroys the web application and cleans up resources
`CreateForm`	public	Creates a component instance with the web handler as owner
`Initialize`	public	Initializes the web application with error handling enabled
`Terminate`	public	Terminates the web application and web handler

Events

`OnGetModule`	public	Event for custom module selection logic
`OnShowRequestException`	public	Event for custom exception handling during request processing
`OnUnknownRequestEncoding`	public	Event for handling unknown request content encodings