server::handlers::HttpHandlerStatic Class Reference

#include <userver/server/handlers/http_handler_static.hpp>

Detailed Description

Handler that returns HTTP 200 if file exist and returns file data with mapped content/type.

Dynamic config

• USERVER_FILES_CONTENT_TYPE_MAP

Userver HTTP Handlers.

Static options:

Inherits all the options from server::handlers::HttpHandlerBase and adds the following ones:

Name	Description	Default value
fs-cache-component	Name of the FsCache component	fs-cache-component

Example usage:

int main(int argc, char* argv[]) {
  const auto component_list =
      components::MinimalServerComponentList()
          .Append<components::FsCache>("fs-cache-main")
          .Append<server::handlers::HttpHandlerStatic>();
  return utils::DaemonMain(argc, argv, component_list);
}

Definition at line 41 of file http_handler_static.hpp.

Inheritance diagram for server::handlers::HttpHandlerStatic:

Collaboration diagram for server::handlers::HttpHandlerStatic:

Public Member Functions
	HttpHandlerStatic (const components::ComponentConfig &config, const components::ComponentContext &context)
std::string	HandleRequestThrow (const http::HttpRequest &request, request::RequestContext &) const override
	HttpHandlerBase (const components::ComponentConfig &config, const components::ComponentContext &component_context, bool is_monitor=false)
Public Member Functions inherited from server::handlers::HttpHandlerBase
	HttpHandlerBase (const components::ComponentConfig &config, const components::ComponentContext &component_context, bool is_monitor=false)
void	HandleRequest (request::RequestBase &request, request::RequestContext &context) const override
void	ReportMalformedRequest (request::RequestBase &request) const final
virtual const std::string &	HandlerName () const
const std::vector< http::HttpMethod > &	GetAllowedMethods () const
virtual logging::Level	GetLogLevelForResponseStatus (http::HttpStatus status) const
virtual FormattedErrorData	GetFormattedExternalErrorBody (const CustomHandlerException &exc) const
std::string	GetResponseDataForLoggingChecked (const http::HttpRequest &request, request::RequestContext &context, const std::string &response_data) const
void	HandleCustomHandlerException (const http::HttpRequest &request, const CustomHandlerException &ex) const
void	HandleUnknownException (const http::HttpRequest &request, const std::exception &ex) const
void	LogUnknownException (const std::exception &ex) const
	Helper function to log an unknown exception.
const std::optional< logging::Level >	GetLogLevel () const
	Returns the default log level for the handler.
Public Member Functions inherited from server::handlers::HandlerBase
	HandlerBase (const components::ComponentConfig &config, const components::ComponentContext &component_context, bool is_monitor=false)
bool	IsMonitor () const
	Returns whether this is a monitoring handler.
const HandlerConfig &	GetConfig () const
	Returns handler config.
Public Member Functions inherited from components::LoggableComponentBase
	LoggableComponentBase (const ComponentConfig &, const ComponentContext &)
	LoggableComponentBase (LoggableComponentBase &&)=delete
	LoggableComponentBase (const LoggableComponentBase &)=delete
	~LoggableComponentBase () override=default
ComponentHealth	GetComponentHealth () const override
void	OnLoadingCancelled () override
void	OnAllComponentsLoaded () override
void	OnAllComponentsAreStopping () override

Static Public Member Functions
static yaml_config::Schema	GetStaticConfigSchema ()
Static Public Member Functions inherited from server::handlers::HttpHandlerBase
static yaml_config::Schema	GetStaticConfigSchema ()
Static Public Member Functions inherited from server::handlers::HandlerBase
static yaml_config::Schema	GetStaticConfigSchema ()
Static Public Member Functions inherited from components::LoggableComponentBase
static yaml_config::Schema	GetStaticConfigSchema ()

Static Public Attributes
static constexpr std::string_view	kName = "handler-static"
	The default name of server::handlers::HttpHandlerStatic.

Additional Inherited Members
Protected Types inherited from server::handlers::HandlerBase
using	HandlerErrorCode = handlers::HandlerErrorCode
using	InternalMessage = handlers::InternalMessage
using	ExternalBody = handlers::ExternalBody
using	ClientError = handlers::ClientError
using	InternalServerError = handlers::InternalServerError
Protected Member Functions inherited from server::handlers::HttpHandlerBase
void	ThrowUnsupportedHttpMethod (const http::HttpRequest &request) const
virtual void	OnRequestCompleteThrow (const http::HttpRequest &, request::RequestContext &) const
virtual void	HandleStreamRequest (const server::http::HttpRequest &, server::request::RequestContext &, server::http::ResponseBodyStream &) const
virtual bool	IsStreamed () const
virtual bool	IsMethodStatisticIncluded () const
virtual bool	NeedCheckAuth () const
virtual std::string	GetRequestBodyForLogging (const http::HttpRequest &request, request::RequestContext &context, const std::string &request_body) const
	Override it if you need a custom request body logging.
virtual std::string	GetResponseDataForLogging (const http::HttpRequest &request, request::RequestContext &context, const std::string &response_data) const
	Override it if you need a custom response data logging.
virtual void	ParseRequestData (const http::HttpRequest &, request::RequestContext &) const
virtual std::string	GetMetaType (const http::HttpRequest &) const

Member Function Documentation

HandleRequestThrow()

std::string server::handlers::HttpHandlerStatic::HandleRequestThrow ( const http::HttpRequest & request, request::RequestContext & context ) const

overridevirtual

The core method for HTTP request handling. request arg contains HTTP headers, full body, etc. The method should return response body.

Note

It is used only if IsStreamed() returned false.

Reimplemented from server::handlers::HttpHandlerBase.

---

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

• userver/server/handlers/http_handler_static.hpp