http_handler_static.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/server/handlers/http_handler_static.hpp
/// @brief @copybrief server::handlers::HttpHandlerStatic
 
#include <userver/components/fs_cache.hpp>
#include <userver/dynamic_config/source.hpp>
#include <userver/engine/task/task_processor_fwd.hpp>
#include <userver/fs/fs_cache_client.hpp>
#include <userver/server/handlers/http_handler_base.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace server::handlers {
 
/// @ingroup userver_components userver_http_handlers
///
/// @brief Handler that returns HTTP 200 if file exist and returns file data with mapped content/type.
///
/// Path arguments of this handle are passed to `fs-cache-component` to get the file. In other words, for the following
/// `fs-cache-main`:
/// @code{.yaml}
/// fs-cache-main:
///     dir: /fs-cache-main-path/          # Path to the directory with files
/// @endcode
/// the `handler-static` with `path: /handler-static-path/*` on request to `/handler-static-path/some/file.html`
/// would return file at path `/fs-cache-main-path/some/file.html`.
///
/// Files larger than @ref components::FsCache `max-size-to-cache` are streamed from disk.
///
/// ## HttpHandlerStatic Dynamic config
/// * @ref USERVER_FILES_CONTENT_TYPE_MAP
///
/// \ref userver_http_handlers "Userver HTTP Handlers".
///
/// ## Static options of server::handlers::HttpHandlerStatic :
/// @include{doc} scripts/docs/en/components_schema/core/src/server/handlers/http_handler_static.md
///
/// Options inherited from @ref server::handlers::HttpHandlerBase :
/// @include{doc} scripts/docs/en/components_schema/core/src/server/handlers/http_handler_base.md
///
/// Options inherited from @ref server::handlers::HandlerBase :
/// @include{doc} scripts/docs/en/components_schema/core/src/server/handlers/handler_base.md
///
/// Options inherited from @ref components::ComponentBase :
/// @include{doc} scripts/docs/en/components_schema/core/src/components/impl/component_base.md
///
/// ## Example usage:
///
/// @snippet samples/static_service/main.cpp Static service sample - main
class HttpHandlerStatic final : public HttpHandlerBase {
public:
    /// @ingroup userver_component_names
    /// @brief The default name of server::handlers::HttpHandlerStatic
    static constexpr std::string_view kName = "handler-static";
 
    using HttpHandlerBase::HttpHandlerBase;
 
    HttpHandlerStatic(const components::ComponentConfig& config, const components::ComponentContext& context);
 
    void HandleMaybeStreamRequest(http::HttpRequest& request, request::RequestContext& context) const override;
 
    static yaml_config::Schema GetStaticConfigSchema();
 
private:
    struct ResolvedFile {
        fs::FileInfoWithDataConstPtr file;
        bool is_not_found{false};
    };
 
    ResolvedFile ResolveFile(const http::HttpRequest& request) const;
 
    dynamic_config::Source config_;
    const fs::FsCacheClient& storage_;
    const std::chrono::seconds cache_age_;
    const std::string directory_file_;
    const std::string not_found_file_;
    engine::TaskProcessor& fs_task_processor_;
};
 
}  // namespace server::handlers
 
USERVER_NAMESPACE_END