http_server_message.hpp

浏览该文件的文档.

#ifndef NEFORCE_NETWORK_HTTP_HTTP_SERVER_MESSAGE_HPP__
#define NEFORCE_NETWORK_HTTP_HTTP_SERVER_MESSAGE_HPP__

 
#include "NeForce/core/container/buffer_chain.hpp"
#include "NeForce/core/utility/any.hpp"
#include "NeForce/network/http/http_session.hpp"
NEFORCE_BEGIN_NAMESPACE__

using http_context = unordered_map<string, any>;
 
NEFORCE_BEGIN_HTTP__


struct NEFORCE_API http_server_request : iobject<http_server_request> {
    http_method method{http_method::GET()}; 
    string path{"/"};                       
    string version{"HTTP/1.1"};             
    string query;                           
    string body;                            
 
    unordered_map<string, string> headers;    
    unordered_map<string, string> cookies;    
    unordered_map<string, string> parameters; 
    unordered_map<string, string> form_data;  
    unordered_map<string, string> trailers;   
 
    http_session* session = nullptr; 
    http_context context;            

    NEFORCE_NODISCARD string_view parameter(const string& name) const {
        const auto it = parameters.find(name);
        return it != parameters.end() ? it->second.view() : "";
    }

    void set_parameter(const string& name, string value) { parameters[name] = move(value); }

    NEFORCE_NODISCARD bool has_parameter(const string& name) const { return parameters.find(name) != parameters.end(); }

    NEFORCE_NODISCARD string_view cookie(const string& name) const {
        const auto it = cookies.find(name);
        return it != cookies.end() ? it->second.view() : "";
    }

    void set_cookie(const string& name, string value) { cookies[name] = move(value); }

    NEFORCE_NODISCARD bool has_cookie(const string& name) const { return cookies.find(name) != cookies.end(); }

    NEFORCE_NODISCARD string_view header(const string& name) const {
        const auto it = headers.find(name);
        return it != headers.end() ? it->second.view() : "";
    }

    void set_header(const string& name, string value) { headers[name] = move(value); }

    NEFORCE_NODISCARD bool has_header(const string& name) const { return headers.find(name) != headers.end(); }

    NEFORCE_NODISCARD bool has_session() const noexcept { return session != nullptr && session->is_valid(); }

    NEFORCE_NODISCARD string_view content_type() const { return header(http_key::Content_Type()); }

    NEFORCE_NODISCARD bool is_keep_alive() const {
        const auto conn = header(http_key::Connection());
        const string conn_lower = string(conn).lowercase();
        if (conn_lower == "close") {
            return false;
        }
        // HTTP/1.1+ defaults to keep-alive; HTTP/1.0 requires explicit keep-alive
        if (!version.starts_with("HTTP/1.0")) {
            return true;
        }
        return conn_lower.starts_with("keep-alive");
    }

    NEFORCE_NODISCARD string_view client_ip() const;

    NEFORCE_NODISCARD string_view user_agent() const { return header("User-Agent"); }

    NEFORCE_NODISCARD string_view referer() const { return header("Referer"); }

    NEFORCE_NODISCARD bool is_ajax() const { return header("X-Requested-With") == "XMLHttpRequest"; }

    void clear();

    NEFORCE_NODISCARD static http_server_request parse(string_view str);

    NEFORCE_NODISCARD string to_string() const;
};
 

struct NEFORCE_API http_server_response : istringify<http_server_response> {
    string version{"HTTP/1.1"};                    
    http_status status{http_status::S4_NOT_FOUND}; 
    string status_message;                         
    unordered_map<string, string> headers;         
    vector<http_cookie> cookies;                   
    string body;                                   
    string redirect_url;                           
    string forward_path;                           
    unordered_map<string, string> trailers;        
    bool chunked_encoding{false};                  

    http_server_response() {
        headers[http_key::Content_Type()] = http_content::PLAIN_TEXT().to_string() + "; charset=utf-8";
    }

    NEFORCE_NODISCARD string_view header(const string& name) const {
        const auto it = headers.find(name);
        return it != headers.end() ? it->second.view() : "";
    }

    void set_header(const string& name, string value) { headers[name] = move(value); }

    NEFORCE_NODISCARD bool has_header(const string& name) const { return headers.find(name) != headers.end(); }

    void set_content_type(http_content value) { headers[http_key::Content_Type()] = move(value).content(); }

    void set_content_type(string value) { headers[http_key::Content_Type()] = move(value); }

    NEFORCE_NODISCARD string to_string() const;

    NEFORCE_NODISCARD string build_header_string() const;
 
    // TODO: Problem Details (RFC 9457) — add set_problem_detail(type, title, detail, instance) for standardized error
    // responses
};

using http_request = http_server_request;

using http_response = http_server_response;
 // HTTP
 
NEFORCE_END_HTTP__
NEFORCE_END_NAMESPACE__
#endif // NEFORCE_NETWORK_HTTP_HTTP_SERVER_MESSAGE_HPP__