Poco::Net

class AbstractHTTPRequestHandler

Library: Net
Package: HTTPServer
Header: Poco/Net/AbstractHTTPRequestHandler.h

Description

The abstract base class for AbstractHTTPRequestHandlers created by HTTPServer.

Derived classes must override the run() method. Contrary to a HTTPRequestHandler, an AbstractHTTPRequestHandler stores request and response as member variables to avoid having to pass them around as method parameters. Additionally, a HTMLForm object is created for use by subclasses.

The run() method must perform the complete handling of the HTTP request connection. As soon as the run() method returns, the request handler object is destroyed.

A new AbstractHTTPRequestHandler object will be created for each new HTTP request that is received by the HTTPServer.

Inheritance

Direct Base Classes: HTTPRequestHandler

All Base Classes: HTTPRequestHandler

Member Summary

Member Functions: authenticate, form, handleRequest, request, response, run, sendErrorResponse

Inherited Functions: handleRequest

Constructors

AbstractHTTPRequestHandler

AbstractHTTPRequestHandler();

Destructor

~AbstractHTTPRequestHandler virtual

virtual ~AbstractHTTPRequestHandler();

Member Functions

form

HTMLForm & form();

Returns a HTMLForm for the given request. The HTMLForm object is created when this member function is executed the first time.

handleRequest virtual

void handleRequest(
    HTTPServerRequest & request,
    HTTPServerResponse & response
);

This class implements some common behavior, before calling run() to actually handle the request:

  • save request and response objects;
  • call authorize();
  • if authorize() returns true call run(), else send 401 (Unauthorized) response.

If run() throws an exception and the response has not been sent yet, sends a 500 (Internal Server Error) response with the exception's display text.

request inline

HTTPServerRequest & request();

Returns the request.

response inline

HTTPServerResponse & response();

Returns the response.

sendErrorResponse

void sendErrorResponse(
    HTTPResponse::HTTPStatus status,
    const std::string & message
);

Sends a HTML error page for the given status code. The given message is added to the page:

<HTML>
    <HEAD>
        <TITLE>status - reason</TITLE>
    </HEAD>
    <BODY>
       <H1>status - reason</H1>
       <P>message</P>
    </BODY>
</HTML>

authenticate protected virtual

virtual bool authenticate();

Check authentication; returns true if okay, false if failed to authenticate. The default implementation always returns true.

Subclasses can override this member function to perform some form of client or request authentication before the request is actually handled.

run protected virtual

virtual void run() = 0;

Must be overridden by subclasses.

Handles the given request.