TWebHandler class

In unit CustWeb

Base class for handling HTTP requests in web applications

Declaration

pascal

TWebHandler = class(TComponent)

Inheritance

Description

TWebHandler is the core component that handles HTTP requests in web applications. It provides the framework for routing requests to appropriate HTTP modules, handling errors, and managing the request-response cycle. This class serves as the foundation for all HTTP hosting implementations including CGI, FastCGI, HTTP server and Apache modules.

The handler supports both legacy routing and new HTTP routing systems, module lifecycle management, error handling with custom exception display, and event logging.

Errors

May raise HTTP-related exceptions during request processing.

Properties

`Terminated`	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 for requests without explicit module names
`ModuleVariable`	public	Query parameter name for specifying HTTP module names
`Email`	public	Administrator email address for error notifications
`Title`	public	Application title displayed in error pages
`Administrator`	public	Administrator name for error pages
`PreferModuleName`	public	Controls whether module name extraction is preferred over path info parsing
`LegacyRouting`	public	Controls whether to use legacy request routing instead of HTTP router
`IncludeStackTraceInErrorPage`	public

Methods

`DoError`	protected
`Terminate`	protected
`GetModuleName`	protected
`WaitForRequest`	protected
`EndRequest`	protected
`FindModule`	protected
`SetBaseURL`	protected
`GetApplicationURL`	protected
`ShowRequestException`	protected
`InitRequest`	protected
`InitResponse`	protected
`GetEmail`	protected
`GetAdministrator`	protected
`Create`	public	Creates a new web handler instance
`Destroy`	public	Destroys the web handler instance
`Run`	public	Main request processing loop for the web handler
`Log`	public	Logs an event message using the configured log handler
`DoHandleRequest`	public	Handles a complete HTTP request with error handling and cleanup
`HandleRequest`	public	Routes and processes an HTTP request to the appropriate handler

Events

`OnGetModule`	public	Event for custom module selection logic
`OnShowRequestException`	public	Event for custom exception handling during request processing
`OnIdle`	public	Event triggered when the handler is idle between requests
`OnLog`	public	Event for logging web application events and errors
`OnUnknownRequestEncoding`	public	Event for handling unknown request content encodings
`OnInitModule`	public	Event for initializing HTTP modules before request processing