summaryrefslogtreecommitdiffstats
path: root/src/lib/cc/base_stamped_element.h
blob: beb3090e22f2cfdba5f82d9d755fa6d33d28035e (plain)
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
79
80
// Copyright (C) 2019,2021 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 BASE_STAMPED_ELEMENT_H
#define BASE_STAMPED_ELEMENT_H

#include <cc/data.h>
#include <boost/date_time/posix_time/posix_time.hpp>
#include <cstdint>

namespace isc {
namespace data {

/// @brief This class represents configuration element which is
/// associated with database identifier and the modification
/// timestamp.
///
/// The @c StampedElement class derives from this class to extend
/// it with the capability to associate the configuration elements
/// with server tags. The @c db::Server class derives from it to
/// store a single server tag identifying a server it describes.
///
/// @note This class is not derived from @c Element and should not
/// be confused with the classes being derived from @c Element class.
/// Those classes are used to represent JSON structures, whereas this
/// class represents data fetched from the database.
class BaseStampedElement {
public:

    /// @brief Constructor.
    ///
    /// Sets timestamp to the current time.
    BaseStampedElement();

    /// @brief Sets element's database identifier.
    ///
    /// @param id New id.
    void setId(const uint64_t id) {
        id_ = id;
    }

    /// @brief Returns element's database identifier.
    uint64_t getId() const {
        return (id_);
    }

    /// @brief Sets timestamp to the explicitly provided value.
    ///
    /// @param timestamp New timestamp value.
    void setModificationTime(const boost::posix_time::ptime& timestamp) {
        timestamp_ = timestamp;
    }

    /// @brief Sets timestamp to the current time.
    void updateModificationTime();

    /// @brief Returns timestamp.
    boost::posix_time::ptime getModificationTime() const {
        return (timestamp_);
    }

protected:

    /// @brief Database identifier of the configuration element.
    ///
    /// The default value of 0 indicates that the identifier is
    /// not set.
    uint64_t id_;

    /// @brief Holds timestamp value.
    boost::posix_time::ptime timestamp_;
};

} // end of namespace isc::data
} // end of namespace isc

#endif