您现在的位置是:首页 >学无止境 >log4cplus: 一个好用的日志模块。编译以及使用网站首页学无止境

log4cplus: 一个好用的日志模块。编译以及使用

帅气转身而过 2024-06-17 11:26:28
简介log4cplus: 一个好用的日志模块。编译以及使用

log4cplus 日志

介绍

log4cplus 是一个 C++ 版本的日志库,它是 Apache 组织的 log4j 日志库的一个开源实现。log4cplus 提供了一个灵活的、高性能的日志系统,支持多线程、本地化和分层结构。

log4cplus 的主要特点如下:

  • 灵活性:log4cplus 提供了灵活的配置机制,可以在运行时动态地修改日志级别、追踪器、Appender 等配置信息。同时,log4cplus 通过继承结构、过滤器、日志记录器等机制,提供了更加高度自定义化的配置。
  • 高性能:log4cplus 使用多线程技术,可以高效地处理大量的日志记录请求,同时支持异步日志记录,减小了日志记录对应用程序性能的影响。
  • 多平台支持:log4cplus 可以跨平台运行,可以在 Windows、Linux、Unix 等平台上使用。
  • 多语言支持:log4cplus 支持本地化,它可以输出不同语言的日志信息。

使用 log4cplus,我们可以使用不同级别的日志记录来控制日志信息的输出,从而帮助我们快速定位和修复问题。此外,log4cplus 还支持多个日志记录器,可以让我们对不同模块的日志信息进行不同的控制和输出。

直接使用

您可以从 log4cplus 的官方网站上下载 log4cplus,网站地址为:http://log4cplus.sourceforge.net。

在网站上,您可以找到最新版本的 log4cplus 以及相关的文档和示例代码。下载 log4cplus 的方法如下:

  1. 打开 log4cplus 的官方网站:http://log4cplus.sourceforge.net。
  2. 在“Downloads”页面,选择适合您系统的版本下载。您可以下载源代码或者预编译的二进制文件。
  3. 解压下载的文件,按照文档说明进行安装和配置。
  4. 如果您需要使用 log4cplus 的扩展功能,您还需要下载相应的扩展库。

安装好 log4cplus 后,您就可以开始使用了。在代码中引用相关的头文件,并使用 log4cplus 提供的 API 进行日志记录

编译

  1. 准备工作
    国内的镜像:https://gitcode.net/mirrors/log4cplus/log4cplus
    github地址:https://github.com/log4cplus/log4cplus
    注意,需要更新子模块,catch,threadpool

  2. window下cmake
    在这里插入图片描述
    ps 需要注意的点,1.宏 WITH_UNIT_TESTS 取消打勾 2.填写自己的安装路径
    这边我用的是vs2019,x64

  3. sln 项目
    找到log4cplus.sln,建议给目前全部权限(碰到过由于权限不够,无法创建文件夹)。
    在这里插入图片描述
    对了,之前也有人说项目要Unicode字符集,cmake生成的项目都是符合要求的。
    直接编译 – lib目录在src/Release或者Debug,动态库在bin目录下

项目添加log4cplus

  1. 右键 vs项目INSTALL,就会生成在之前cmake上的配置的路径下
    在这里插入图片描述
    自己可以在这个基础上细分debug和release
  2. 添加lib以及include
	在VC目录下的库目录中加入logModulelib以及包含目录加入.logModuleinclude
	//加载库
	#ifdef _WIN64
	#ifdef _DEBUG
	#pragma comment(lib,"logModule/lib/log4cplusUD.lib")
	#else
	#pragma comment(lib,"logModule/lib/log4cplusU.lib")
项目:**ISO C++20 标准 (/std:c++20)**,c++语言标准:**ISO C++20 标准 (/std:c++20)**
  1. 具体用法
    其实网上有很多可以参考的,可以用配置文件或者直接在代码里面配置。

log4cplus 的基本使用步骤如下:

  • 引入头文件:包含 log4cplus/logger.h 和 log4cplus/configurator.h 头文件。
  • 初始化配置:在程序初始化时调用 log4cplus 的配置器进行配置。如下所示:
	#include <log4cplus/logger.h>    
	#include <log4cplus/configurator.h>
    log4cplus::initialize();   
    log4cplus::BasicConfigurator::doConfigure();  

这里使用了 BasicConfigurator 进行基本配置,您也可以使用 XMLConfigurator 或者PropertyConfigurator 进行更加灵活的配置。

  • 创建日志记录器:使用 getLogger() 方法创建一个日志记录器。如下所示:
	#include <log4cplus/logger.h>    
	log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT("main"));
  • 记录日志:调用日志记录器的方法,如 DEBUG、INFO、WARN、ERROR 和 FATAL 等级别的记录方法。如下所示:
	LOG4CPLUS_DEBUG(logger, "This is a debug message.");   
    LOG4CPLUS_INFO(logger, "This is an info message.");   
    LOG4CPLUS_WARN(logger, "This is a warning message.");   
    LOG4CPLUS_ERROR(logger, "This is an error message.");   
    LOG4CPLUS_FATAL(logger, "This is a fatal message.");
  • 也可以在记录日志的时候,使用 printf-style 的格式化方式加入参数,例如:
	LOG4CPLUS_DEBUG_FMT(logger, "This is a debug message with number:%d.", 123);
  • 关闭日志系统:在程序结束时调用 log4cplus 的 shutdown() 方法关闭日志系统。
	log4cplus::Logger::shutdown();
  • 自定义配置:如果您需要自定义配置,例如输出到文件或者使用其他 Appender,则可以使用 PropertyConfigurator 或者 XMLConfigurator 进行配置。例如:
	log4cplus::PropertyConfigurator config("log4cplus.properties");
	config.configure();

log4cplus.properties

	# ALL TRACE  DEBUG  INFO  WARN  ERROR  FATAL  OFF
	log4cplus.rootLogger = TRACE,SA
	log4cplus.logger.logConsole = TRACE,LC
	
	#For database stuff, I don't need to logging everything, it's enough printing only errors!
	#log4cplus.logger.DatabaseOperations=ERROR
	#log4cplus.additivity.file=false
	
	log4cplus.appender.LC=log4cplus::ConsoleAppender
	log4cplus.appender.LC.EnCoding=utf-8
	log4cplus.appender.LC.layout=log4cplus::PatternLayout
	log4cplus.appender.LC.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %m [%l]%n
	 
	#设置日志追加到文件尾
	log4cplus.appender.SA=log4cplus::TimeBasedRollingFileAppender 
	//log4cplus.appender.SA.File = Mylogger.log
	# 必须要先手动创建好log目录;否则无法创建文件
	log4cplus.appender.SA.FilenamePattern= ./log/%d{yyyy-MM-dd_HH-mm}.log
	log4cplus.appender.SA.Schedule = MINUTELY
	log4cplus.appender.SA.CreateDirs = true
	log4cplus.appender.SA.MaxHistory = 9999
	log4cplus.appender.SA.RollOnClose = false
	#设置日志文件大小
	log4cplus.appender.SA.MaxFileSize = 100MB
	#设置生成日志最大个数
	log4cplus.appender.SA.MaxBackupIndex = 100
	log4cplus.appender.SA.Append = true
	log4cplus.appender.SA.layout=log4cplus::PatternLayout
	log4cplus.appender.SA.layout.ConversionPattern=[%-5p][%D{%m/%d/%y %H:%M:%S:%Q}] [%t] %c - %m [%l]%n
	 
	#设置日志级别范围
	log4cplus.appender.SA.filters.1=log4cplus::spi::LogLevelRangeFilter
	log4cplus.appender.SA.filters.1.LogLevelMin=DEBUG
	log4cplus.appender.SA.filters.1.LogLevelMax=FATAL
	log4cplus.appender.SA.filters.1.AcceptOnMatch=true
	log4cplus.appender.SA.filters.2=log4cplus::spi::DenyAllFilter
风语者!平时喜欢研究各种技术,目前在从事后端开发工作,热爱生活、热爱工作。