Qt spdlog日志模块的使用详解

2025-04-13 04:50

本文主要是介绍Qt spdlog日志模块的使用详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Qtspdlog日志模块的使用详解》在Qt应用程序开发中,良好的日志系统至关重要,本文将介绍如何使用spdlog1.5.0创建满足以下要求的日志系统,感兴趣的朋友一起看看吧...

版本

spdlog版本:1.5.0

采用1.5.0版本主要基于以下考虑:兼容Qt5.9.X版本和兼容C++11。

spdlog 1.5.0下载地址:https://github.com/gabime/spdlog/releases/tag/v1.5.0

摘要

在Qt应用程序开发中,良好的日志系统至关重要。本文将介绍如何使用spdlog 1.5.0创建满足以下要求的日php志系统:

  • 自定义文件名格式:yyyyMMdd_hhmmss_毫秒.log,不使用spdlog提供的日志轮转功能

spdlog::sinks::rotating_file_sink_mt,采用自定义custom_rotating_file_sink;

  • 保留最近10个日志文件,每个日志文件大小限制为1MB。

例子

logmanager.h文件

#ifndef LOGMANAGER_H
#djsefine LOGMANAGER_H
#include <QObject>
#include <memory>
#include <spdlog/spdlog.h>
class LogManager : public QObject
{
    Q_OBJECT
public:
    static LogManager& instance();
    void initialize(const QString& logDir = "logs",
                    const QString& appName = "app",
                    size_t maxFileSize = 1024 * 1024, // 1MB
                    size_t maxFiles = 10);
    void shutdown();
    template<typename... Args>
    static void log(spdlog::level::level_enum level, const QString& message, Args... args)
    {
        if (instance().m_logger)
        {
            instance().m_logger->log(level, message.toStdString().c_str(), args...);
        }
    }
    // 便捷方法
    static void trace(const QString& message)
    {
        log(spdlog::level::trace, message);
    }
    static void debug(const QString& message)
    {
        log(spdlog::level::debug, message);
    }
    static void info(const QString& message)
    {
        log(spdlog::level::info, message);
    }
    static void warn(const QString& message)
    {
        log(spdlog::level::warn, message);
    }
    static void error(const QString& message)
    {
        log(spdlog::level::err, message);
    }
    static void critical(const QString& message)
    {
        log(spdlog::level::critical, message);
    }
private:
    LogManager(QObject* parent = nullptr);
    ~LogManager();
    std::shared_ptr<spdlog::logger> createCustomLogger(const std::string& base_filename,
            size_t max_size,
            size_t max_files);
    std::shared_ptr<spdlog::logger> m_logger;
    std::atomic<bool> m_shuttingDown{false};
signals:
    void aboutToShutdown();
private slots:
    void onAboutToQuit();
};
// 日志宏定义
#define LOG_TRACE(...)    LogManager::log(spdlog::level::trace, __VA_ARGS__)
#define LOG_DEBUG(...)    LogManager::log(spdlog::level::debug, __VA_ARGS__)
#define LOG_INFO(...)     LogManager::log(spdlog::level::info, __VA_ARGS__)
#define LOG_WARN(...)     LogManager::log(spdlog::level::warn, __VA_ARGS__)
#define LOG_ERROR(...)    LogManager::log(spdlog::level::err, __VA_ARGS__)
#define LOG_CRITICAL(...) LogManager::log(spdlog::level::critical, __VA_ARGS__)
#endif // LOGMANAGER_H

logmanager.cpp文件

#include "logmanager.h"
#include <spdlog/sinks/base_sink.h>
#include <spdlog/details/file_helper.h>
#include <mutex>
#include <chrono>
#include <iomanip>
#include <sstream>
#include <vector>
#include <algorithm>
#include <QDir>
#include <QFileInfo>
#include <QDateTime>
#include <QCoreApplication>
#include <csignal>
#include <QDebug>
// 替换 std::filesystem 的 C++11 兼容实现
namespace spdlog
{
    class custom_rotating_file_sink : public spdlog::sinks::base_sink<std::mutex>
    {
    public:
        custom_rotating_file_sink(const std::string& base_filename,
                                  std::size_t max_size,
                                  std::size_t max_files)
            : base_filename_(base_filename),
              max_size_(max_size),
              max_files_(max_files)
        {
            file_helper_.open(gen_filename());
        }
    prowww.chinasem.cntected:
        void sink_it_(const spdlog::details::log_msg& msg) override
        {
            spdlog::memory_buf_t formatted;
            formatter_->format(msg, formatted);
            if (file_helper_.size() + formatted.size() > max_size_)
            {
                rotate_();
            }
            file_helper_.write(formatted);
        }
        void flush_() override
        {
            file_helper_.flush();
        }
    private:
        std::string gen_filename()
        {
            QDateTime now = QDateTime::currentDateTime();
            QString timeStr = now.toString("yyyyMMddhhmmss");
            // 添加毫秒部分(3位)
            int ms = now.time().msec();
            timeStr += QString("_%1").arg(ms, 3, 10, QLatin1Char('0'));
            return base_filename_ + "_" + timeStr.toStdString() + ".log";
        }
        void rotate_()
        {
            file_helper_.close();
            cleanup_old_files();
            file_helper_.open(gen_filename());
        }
        void cleanup_old_files()
        {
            if (max_files_ == 0) return;
            QFileInfo base_info(QString::fromStdString(base_filename_));
            QDir dir = base_info.absoluteDir();
            QString base_name = base_info.fileName();
            QFileInfoList files = dir.entryInfoList(QStringList() << (base_name + "_*.log"),
                                                    QDir::Files, QDir::Time);
            // 删除最旧的文件
            while (files.size() >= static_cast<int>(max_files_))
            {
                QFile::remove(files.last().absoluteFilePath());
                files.removeLast();
            }
        }
        std::string base_filename_;
        std::size_t max_size_;
        std::size_t max_files_;
        spdlog::details::file_helper file_helper_;
    };
} // namespace
LogManager::LogManager(QObject* parent) : QObject(parent)
{
    // 连接Qt退出信号
    connect(qApp, &QCoreApplication::aboutToQuit, this, &LogManager::onAboutToQuit);
    // 处理异常信号
    static auto handleSignal = [](int)
    {
        LogManager::instance().shutdown();
        std::_Exit(1);
    };
    std::signal(SIGTERM, handleSignal);
    std::signal(SIGSEGV, handleSignal);
    std::signal(SIGINT, handleSignal);
    std::sjavascriptignal(SIGABRT, handleSignal);
}
LogManager::~LogManager()
{
    shutdown();
}
LogManager& LogManager::instance()
{
    static LogManager instance;
    return instance;
}
void LogManager::initialize(const QString& logDir, const QString& appName, size_t maxFileSize, size_t maxFiles)
{
    if (m_logger)
    {
        return;
    }
    // 确保日志目录存在
    QDir().mkpath(logDir);
    std::string base_filename = QDir(logDir).absoluteFilePath(appName).toStdString();
    m_logger = createCustomLogger(base_filename, maxFileSize, maxFiles);
    // 设置默认日志格式
    m_logger->set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%l] [thread %t] %v");
    m_logger->set_level(spdlog::level::trace);
    spdlog::register_logger(m_logger);
    spdlog::set_default_logger(m_logger);
}
void LogManager::shutdown()
{
    /*
    if (m_logger)
    {
        spdlog::drop(m_logger->name());
        m_logger.reset();
    }
    spdlog::shutdown();
    */
    if (m_shuttingDown) return;
    m_shuttingDown = true;
    emit aboutToShutdown();
    try
    {
 javascript       if (m_logger)
        {
            m_logger->flush();
            spdlog::drop(m_logger->name());
        }
        spdlog::shutdown();
        m_logger.reset();
    }
    catch (const spdlog::spdlog_ex& ex)
    {
        qCritical() << "Log shutdown error:" << ex.what();
    }
}
void LogManager::onAboutToQuit()
{
    shutdown();
}
std::shared_ptr<spdlog::logger> LogManager::createCustomLogger(const std::string& base_filename,
        size_t max_size,
        size_t max_files)
{
    auto sink = std::make_shared<spdlog::custom_rotating_file_sink>(base_filename, max_size, max_files);
    auto logger = std::make_shared<spdlog::logger>("qt_logger", sink);
    return logger;
}

main.cpp文件

#include <QCoreApplication>
#include "logmanager.h"
#include <QTimer>
#include <QDebug>
int main(int argc, char* argv[])
{
    QCoreApplication a(argc, argv);
    // 初始化日志系统
    LogManager::instance().initialize("logs", "MyAppTest");
    // 连接关闭信号进行额外清理
    QObject::connect(&LogManager::instance(), &LogManager::aboutToShutdown, []()
    {
        LOG_INFO("Performing final cleanup before shutdown...");
    });
    for (int i = 0; i < 5000; ++i)
    {
        LOG_INFO("This is a test message to fill up the log file. Iteration: {}", i);
    }
    return a.exec();
}

到此这篇关于Qt spdlog日志模块的使用的文章就介绍到这了,更多相关Qt spdlog日志模块内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于Qt spdlog日志模块的使用详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1154200

相关文章

使用jenv工具管理多个JDK版本的方法步骤

《使用jenv工具管理多个JDK版本的方法步骤》jenv是一个开源的Java环境管理工具,旨在帮助开发者在同一台机器上轻松管理和切换多个Java版本,:本文主要介绍使用jenv工具管理多个JD... 目录一、jenv到底是干啥的?二、jenv的核心功能(一)管理多个Java版本(二)支持插件扩展(三)环境隔

SQL中JOIN操作的条件使用总结与实践

《SQL中JOIN操作的条件使用总结与实践》在SQL查询中,JOIN操作是多表关联的核心工具,本文将从原理,场景和最佳实践三个方面总结JOIN条件的使用规则,希望可以帮助开发者精准控制查询逻辑... 目录一、ON与WHERE的本质区别二、场景化条件使用规则三、最佳实践建议1.优先使用ON条件2.WHERE用

MySQL存储过程之循环遍历查询的结果集详解

《MySQL存储过程之循环遍历查询的结果集详解》:本文主要介绍MySQL存储过程之循环遍历查询的结果集,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录前言1. 表结构2. 存储过程3. 关于存储过程的SQL补充总结前言近来碰到这样一个问题:在生产上导入的数据发现

Java中Map.Entry()含义及方法使用代码

《Java中Map.Entry()含义及方法使用代码》:本文主要介绍Java中Map.Entry()含义及方法使用的相关资料,Map.Entry是Java中Map的静态内部接口,用于表示键值对,其... 目录前言 Map.Entry作用核心方法常见使用场景1. 遍历 Map 的所有键值对2. 直接修改 Ma

MySQL 衍生表(Derived Tables)的使用

《MySQL衍生表(DerivedTables)的使用》本文主要介绍了MySQL衍生表(DerivedTables)的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学... 目录一、衍生表简介1.1 衍生表基本用法1.2 自定义列名1.3 衍生表的局限在SQL的查询语句select

MyBatis ResultMap 的基本用法示例详解

《MyBatisResultMap的基本用法示例详解》在MyBatis中,resultMap用于定义数据库查询结果到Java对象属性的映射关系,本文给大家介绍MyBatisResultMap的基本... 目录MyBATis 中的 resultMap1. resultMap 的基本语法2. 简单的 resul

从基础到进阶详解Pandas时间数据处理指南

《从基础到进阶详解Pandas时间数据处理指南》Pandas构建了完整的时间数据处理生态,核心由四个基础类构成,Timestamp,DatetimeIndex,Period和Timedelta,下面我... 目录1. 时间数据类型与基础操作1.1 核心时间对象体系1.2 时间数据生成技巧2. 时间索引与数据

Mybatis Plus Join使用方法示例详解

《MybatisPlusJoin使用方法示例详解》:本文主要介绍MybatisPlusJoin使用方法示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,... 目录1、pom文件2、yaml配置文件3、分页插件4、示例代码:5、测试代码6、和PageHelper结合6

一文全面详解Python变量作用域

《一文全面详解Python变量作用域》变量作用域是Python中非常重要的概念,它决定了在哪里可以访问变量,下面我将用通俗易懂的方式,结合代码示例和图表,带你全面了解Python变量作用域,需要的朋友... 目录一、什么是变量作用域?二、python的四种作用域作用域查找顺序图示三、各作用域详解1. 局部作

MySQL分区表的具体使用

《MySQL分区表的具体使用》MySQL分区表通过规则将数据分至不同物理存储,提升管理与查询效率,本文主要介绍了MySQL分区表的具体使用,具有一定的参考价值,感兴趣的可以了解一下... 目录一、分区的类型1. Range partition(范围分区)2. List partition(列表分区)3. H