Timer.h

浏览该文件的文档.

// Copyright 2024 libsese
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#pragma once
 
#include "sese/Config.h"
#include "sese/thread/Thread.h"
 
#include <atomic>
#include <functional>
#include <list>
#include <mutex>
 
namespace sese {
 
class  Timer;
class  TimerTask final : public std::enable_shared_from_this<TimerTask> {
public:
    friend class Timer;
    using Ptr = std::shared_ptr<TimerTask>;
 
    void cancel() noexcept;
 
private:
    // 私有构造函数
    TimerTask() = default;
    // 对应定时长度
    int64_t sleepTimestamp = 0;
    // 对应定时器的时间
    int64_t targetTimestamp = 0;
    // 是否重复执行
    bool isRepeat = false;
    // 定时回调函数
    std::function<void()> callback;
    // 取消回调函数
    std::function<void()> cancelCallback;
};
 
class  Timer final : public std::enable_shared_from_this<Timer> {
public:
    using Ptr = std::shared_ptr<Timer>;
 
    static Timer::Ptr create(size_t number = TIMER_WHEEL_NUMBER) noexcept;
    ~Timer() noexcept;
 
    TimerTask::Ptr delay(const std::function<void()> &callback, int64_t relative_timestamp, bool is_repeat = false) noexcept;
    void shutdown() noexcept;
 
public:
    Timer() = default;
    void loop() noexcept;
    static void cancelCallback(const std::weak_ptr<Timer> &weak_timer, const std::weak_ptr<TimerTask> &weak_task) noexcept;
 
    size_t number = 0;
    std::mutex mutex{};
    Thread::Ptr thread = nullptr;
    std::atomic_bool isShutdown = false;
    std::atomic<int64_t> currentTimestamp = 0;
    std::list<TimerTask::Ptr> *timerTasks = nullptr;
};
} // namespace sese