isc::http::HttpResponseCreator Class Reference

Specifies an interface for classes creating HTTP responses from HTTP requests. More...

#include <response_creator.h>

Inheritance diagram for isc::http::HttpResponseCreator:

Public Member Functions
virtual	~HttpResponseCreator ()
	Destructor.
virtual HttpResponsePtr	createHttpResponse (HttpRequestPtr request) final
	Create HTTP response from HTTP request received.
virtual HttpRequestPtr	createNewHttpRequest () const =0
	Create a new request.
virtual HttpResponsePtr	createStockHttpResponse (const HttpRequestPtr &request, const HttpStatusCode &status_code) const =0
	Creates implementation specific HTTP response.

Protected Member Functions
virtual HttpResponsePtr	createDynamicHttpResponse (HttpRequestPtr request)=0
	Creates implementation specific HTTP response.

Detailed Description

Specifies an interface for classes creating HTTP responses from HTTP requests.

HTTP is designed to carry various content types. Most commonly this is text/html. In Kea, the application/json content type is used to carry control commands in JSON format. The libkea-http library is meant to be generic and provide means for transferring different types of content, depending on the use case.

This abstract class specifies a common interface for generating HTTP responses from HTTP requests using specific content type and being used in some specific context. Kea modules providing HTTP services need to implement their specific derivations of the HttpResponseCreator class. These derivations use classes derived from HttpRequest as an input and classes derived from HttpResponse as an output of createHttpResponse method.

Definition at line 38 of file response_creator.h.

Constructor & Destructor Documentation

~HttpResponseCreator()

virtual isc::http::HttpResponseCreator::~HttpResponseCreator ( )

inlinevirtual

Destructor.

Classes with virtual functions need virtual destructors.

Definition at line 44 of file response_creator.h.

Member Function Documentation

createDynamicHttpResponse()

virtual HttpResponsePtr isc::http::HttpResponseCreator::createDynamicHttpResponse ( HttpRequestPtr  request )

protectedpure virtual

Creates implementation specific HTTP response.

Parameters

request

Pointer to an object representing HTTP request.

Returns

Pointer to an object representing HTTP response.

Referenced by createHttpResponse().

createHttpResponse()

HttpResponsePtr isc::http::HttpResponseCreator::createHttpResponse ( HttpRequestPtr  request )

finalvirtual

Create HTTP response from HTTP request received.

This class implements a generic logic for creating a HTTP response. Derived classes do not override this method. They merely implement the methods it calls.

The request processing may generally fail at one of the two stages: parsing or interpretation of the parsed request. During the former stage the request's syntax is checked, i.e. HTTP version, URI, headers etc. During the latter stage the HTTP server checks if the request is valid within the specific context, e.g. valid HTTP version used, expected content type etc.

In the HttpRequest terms, the request has gone through the first stage if it is "finalized" (see HttpRequest::finalize). This method accepts instances of both finalized and not finalized requests. If the request isn't finalized it indicates that the request parsing has failed. In such case, this method calls createStockBadRequest to generate a response with HTTP 400 status code. If the request is finalized, this method calls createDynamicHttpResponse to generate implementation specific response to the received request.

This method is marked virtual final to prevent derived classes from overriding this method. Instead, the derived classes must implement protected methods which this method calls.

Parameters

request

Pointer to an object representing HTTP request.

Returns

Pointer to the object encapsulating generated HTTP response.

Exceptions

HttpResponseError

if request is a NULL pointer.

Definition at line 15 of file response_creator.cc.

References isc::http::BAD_REQUEST, createDynamicHttpResponse(), createStockHttpResponse(), and isc_throw.

Here is the call graph for this function:

createNewHttpRequest()

virtual HttpRequestPtr isc::http::HttpResponseCreator::createNewHttpRequest ( ) const

pure virtual

Create a new request.

This method creates an instance of the HttpRequest or derived class. The type of the object is compatible with the instance of the HttpResponseCreator implementation which creates it, i.e. can be used as an argument in the call to createHttpResponse.

Returns

Pointer to the new instance of the HttpRequest.

Implemented in isc::agent::CtrlAgentResponseCreator, and isc::config::CmdResponseCreator.

createStockHttpResponse()

virtual HttpResponsePtr isc::http::HttpResponseCreator::createStockHttpResponse ( const HttpRequestPtr &  request, const HttpStatusCode &  status_code  ) const

pure virtual

Creates implementation specific HTTP response.

Parameters

request	Pointer to an object representing HTTP request.
status_code	Status code of the response.

Returns

Pointer to an object representing HTTP response.

Implemented in isc::agent::CtrlAgentResponseCreator, and isc::config::CmdResponseCreator.

Referenced by isc::http::BasicHttpAuthConfig::checkAuth(), and createHttpResponse().

---

The documentation for this class was generated from the following files:

• response_creator.h
• response_creator.cc