IHTTPRequestHandler Class Reference

Called by the server for each unrecognized request.

If the application would to handle such request then it should return a valid IHTTPRequestHandlerContext object pointer on which the server will call methods. These method calls will inform the application of which headers were sent in the request and then obtain the response data to be sent back to the HTTP client. Returning a NULL pointer indicates that the server should fail this bad request with an appropriate error.

Parameters:

pRequest

is a pointer to the request being made by the HTTP client. This is a short lived object that will only be valid during this call.

Returns:

NULL if the CHTTPServer object should fail this request. Otherwise return an IHTTPRequestHandlerContext object pointer so that the application can be notified of additional request information and provide the response data.

Called by the server for each GET request.

If the application would like to handle the GET request rather than using the default server code then the application should return a valid IHTTPRequestHandlerContext object pointer on which the server will call methods. These method calls will inform the application of which headers were sent in the request and then obtain the response data to be sent back to the HTTP client. Returning a NULL pointer indicates that the server should search in its pRootPathname directory for the requested file.

Parameters:

pURI	is a pointer to the URI being requested by the HTTP client. This is a short lived object that will only be valid during this call.

Returns:

NULL if the CHTTPServer object should process the GET request on its own. Otherwise return an IHTTPRequestHandlerContext object pointer so that the application can be notified of additional request information and provide the response data.

Called by the server for each HEAD request.

If the application would like to handle the HEAD request rather than using the default server code then the application should return a valid IHTTPRequestHandlerContext object pointer on which the server will call methods. These method calls will inform the application of which headers were sent in the request and then obtain the response data to be sent back to the HTTP client. Returning a NULL pointer indicates that the server should search in its pRootPathname directory for the requested file.

Parameters:

pURI	is a pointer to the URI being requested by the HTTP client. This is a short lived object that will only be valid during this call.

Returns:

NULL if the CHTTPServer object should process the HEAD request on its own. Otherwise return an IHTTPRequestHandlerContext object pointer so that the application can be notified of additional request information.

Called by the server for each POST request.

If the application would like to handle the POST request then it should return a valid IHTTPRequestHandlerContext object pointer on which the server will call methods. These method calls will inform the application of which headers were sent in the request and then obtain the response data to be sent back to the HTTP client. Returning a NULL pointer indicates that the server should fail this POST request with a not implemented error.

Parameters:

pURI	is a pointer to the URI being requested by the HTTP client. This is a short lived object that will only be valid during this call.

Returns:

NULL if the CHTTPServer object should fail the POST request. Otherwise return an IHTTPRequestHandlerContext object pointer so that the application can be notified of additional request information and provide the response data.