neuray API Programmer's Manual

mi::http::ICGIRequest_handler Class Reference

[HTTP server]

Description

CGI request handlers are responsible for handling HTTP requests. CGI handlers are very similar to normal request handlers, but they will be called before any body data has been processed. They can then be used to consume the data by calling mi::http::IConnection::read_data() on the connection until all data is consumed.

For every request the handlers are asked if they are responsible for the request. They will be asked in the order they where added. If the handle() function of a handler returns true the subsequent handlers will not be asked anymore.

See also:

mi::http::IServer::install( ICGIRequest_handler*), mi::http::IServer::remove( ICGIRequest_handler*)

Public Member Functions

virtual bool  handle( IConnection* connection) =0
Handles a request coming in on a connection. More...

Member Functions

virtual bool mi::​http::​ICGIRequest_handler::handle( IConnection* connection) [pure virtual]

Handles a request coming in on a connection. Returns true, if the request was was completely handled, i.e., no more handlers should be called. Returns false, if the request was not completely handled, i.e., the subsequent handlers should be called. In the latter case no calls to mi::http::IConnection::print() or mi::http::IConnection::enqueue() must have been used on the connection.

Parameters

connection
The connection on which the request came in.

Returns

true , if the request was completely handled, or false otherwise.