1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
// Copyright (C) 2024 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

#ifndef CFG_HTTP_HEADER_H
#define CFG_HTTP_HEADER_H

#include <cc/cfg_to_element.h>
#include <cc/data.h>
#include <cc/user_context.h>
#include <http/request.h>
#include <http/response.h>

namespace isc {
namespace http {

/// @brief Config HTTP header.
///
/// Extra headers to include in a message are configured as a list of
/// objects of this class. At the difference of other HTTP header classes
/// there is no numeric value.
class CfgHttpHeader : public isc::data::UserContext, public isc::data::CfgToElement {
public:
    /// @brief Header name.
    std::string name_;

    /// @brief Header value.
    std::string value_;

    /// @brief Constructor.
    ///
    /// @param name Header name.
    /// @param value Header value.
    CfgHttpHeader(const std::string& name, const std::string& value)
        : name_(name), value_(value) {
    }

    /// @brief Unparses config HTTP header.
    ///
    /// @return A pointer to unparsed header configuration.
    virtual isc::data::ElementPtr toElement() const;<--- Function in derived class
};

/// @brief Collection of config HTTP headers.
typedef std::vector<CfgHttpHeader> CfgHttpHeaders;

/// @brief Copy config HTTP headers to message.
///
/// @tparam HTTP_MSG Either HttpRequest or HttpResponse.
/// @param headers Config HTTP headers.
/// @param message HTTP_MSG target object.
template<typename HTTP_MSG>
void copyHttpHeaders(const CfgHttpHeaders& headers, const HTTP_MSG& message) {
    for (auto const& header : headers) {
        message.context()->headers_.
            push_back(HttpHeaderContext(header.name_, header.value_));
    }
}

/// @brief Unparse config HTTP headers.
///
/// @param headers Config HTTP headers.
/// @return A pointer to unparsed headers configuration.
isc::data::ElementPtr CfgHttpHeaderstoElement(const CfgHttpHeaders& headers);

/// @brief Parse config HTTP headers.
///
/// @param config Element holding the HTTP headers configuration.
/// @return The HTTP headers.
/// @throw DhcpConfigError when the configuration is invalid.
CfgHttpHeaders parseCfgHttpHeaders(const isc::data::ConstElementPtr& config);

} // namespace http
} // namespace isc

#endif