使用 QSettings 配置 Log4Qt-轻识

在 Log4Qt 的初始化过程中，除了会使用环境变量之外，它还会通过 QSettings 读取配置。也就是说，在使用 Logger 之前，需要针对 QSettings 做一些基本设置：

组织名和应用名：通过 QCoreApplication::setOrganizationName() 和 QCoreApplication::setApplicationName() 指定，并且这些名称需要能被 QSettings 找到。
分组：需要有一个名为 Log4Qt 的分组，在这个组下面还要有一个子组 Properties。
配置内容：需要符合 Log4Qt 配置语法规则。

在 Windows 中，可以在注册表中添加相应的配置。例如，路径：计算机\HKEY_CURRENT_USER\SOFTWARE\MyOrganisation\MyApplication\Log4Qt\Properties：

当然，手动添加比较麻烦。有一个简单的办法，就是下面所说的用程序设置 - setupLog4Qt()。

使用 QSettings 配置

为了实现这个功能，可以自定义 QCoreApplication：

#ifndef MY_APPLICATION_H
#define MY_APPLICATION_H

#include <QCoreApplication>

class MyApplication : public QCoreApplication
{
    Q_OBJECT

public:
    MyApplication(int &argc, char **argv);
    ~MyApplication();

    void setupLog4Qt();
};

#endif // MY_APPLICATION_H

在构造函数中，为应用程序设置一些基本信息 - OrganizationName、ApplicationName 以及 OrganizationDomain，以允许 QSettings 能正确的进行读写。

在 setupLog4Qt() 中，我们创建了一个组“Log4Qt/Properties”，并且对 rootLogger 进行了一些简单的配置：

#include "my_application.h"
#include <log4qt/logger.h>
#include <QSettings>

MyApplication::MyApplication(int &argc, char **argv)
    : QCoreApplication(argc, argv)
{
    // 设置应用程序数据，以允许 Log4Qt 初始化读取正确的值
    setOrganizationName("MyOrganisation");
    setApplicationName("MyApplication");
    setOrganizationDomain("https://github.com/Waleon");
}

MyApplication::~MyApplication()
{
}

void MyApplication::setupLog4Qt()
{
    QSettings s;

    QStringList groups = s.childGroups();
    if (!groups.contains("Log4Qt")) {
        // 将 Log4Qt 的日志级别设置为 INFO
        s.beginGroup("Log4Qt");
        s.setValue("Debug", "INFO");

        // 配置日志输出至文件 logger.log，使用级别 INFO
        s.beginGroup("Properties");
        s.setValue("log4j.rootLogger", "INFO, logFile");
        s.setValue("log4j.appender.logFile", "org.apache.log4j.FileAppender");
        s.setValue("log4j.appender.logFile.file", "logger.log");
        s.setValue("log4j.appender.logFile.layout", "org.apache.log4j.TTCCLayout");
        s.setValue("log4j.appender.logFile.layout.dateFormat", "ISO8601");
    }
}

这样一来，通过调用 setupLog4Qt() 就能够设置 Log4Qt 的配置信息了：

#include <QCoreApplication>
#include <log4qt/logger.h>
#include "my_application.h"

int main(int argc, char *argv[])
{
    MyApplication app(argc, argv);

    // 设置配置信息
    app.setupLog4Qt();

    // 现在，可以使用 logger 了。
    Log4Qt::Logger* logger = Log4Qt::Logger::rootLogger();

    logger->trace("This is a trace message.");
    logger->debug("This is a debug message.");
    logger->info("This is a info message.");
    logger->warn("This is a warn message.");
    logger->error("This is a error message.");
    logger->fatal("This is a fatal message.");

    return 0;
}