log4cplus：C++日志系统详解与安装指南

log4cplus
使用说明
4星 · 超过85%的资源 需积分: 31 14 下载量 70 浏览量 更新于2024-09-16 收藏 159KB PDF 举报
“log4cplus使用说明” log4cplus是一个用C++编写的开源日志系统，源自Java的log4j。它提供线程安全、灵活性和多粒度控制的功能，使得开发者能够针对程序的不同阶段，如调试、运行、测试和维护，进行有针对性的日志记录。log4cplus支持将日志信息输出到多种目的地，包括控制台、文件、NT Event Log，甚至远程服务器。此外，它还具备日志文件的定期备份策略。 要获取log4cplus的最新版本，你可以访问"http://log4cplus.sourceforge.net"并下载对应版本的log4cplus-x.x.x。 在Linux环境下安装log4cplus，你需要按照以下步骤操作： 1. 解压缩下载的log4cplus-x.x.x.tar.gz文件到当前目录。 2. 进入解压后的log4cplus-x.x.x目录。 3. 在该目录下运行`./configure`脚本。 4. 执行`make`命令进行编译。 5. 使用`make install`命令进行安装。建议以root用户身份执行这些步骤。 在Windows系统下，log4cplus无需正式安装。你可以找到包含源码和示例项目的msvc6文件夹，其中包含适用于VC6的项目文件。你需要编译"log4cplus_dllclass"工程来生成DLL，或者编译"log4cplus_staticclass"工程来生成静态库LIB。 在使用log4cplus前，你需要进行相应的配置： 1. 对于Linux，确保Makefile中指定了静态库`/usr/local/lib/liblog4cplus.a`或链接器选项`-llog4cplus`（对于动态库）。头文件位于`/usr/local/include/log4cplus`目录。如果使用动态库，还需将库路径（如`/usr/local/lib`）添加到`LD_LIBRARY_PATH`环境变量，并运行`/sbin/ldconfig`以应用更改。 2. 在Windows系统中，你可以将"log4cplus_dllclass"或"log4cplus_staticclass"的DSP文件添加到你的项目中，或者直接将库文件及头文件所在的目录添加到工程的搜索路径。如果选择使用静态库，确保你的工程配置正确引用了相应的库文件。 log4cplus的配置通常涉及创建配置文件，该文件定义了日志记录的行为，如日志级别、输出目的地、格式等。通过这些配置，你可以精确控制哪些信息被记录以及如何处理这些信息。例如，你可以设置日志级别为ERROR，只记录错误信息，或者设置为DEBUG，记录所有调试信息。此外，你还可以定制日志格式，包括时间戳、线程ID、日志级别和日志消息本身。 log4cplus是一个强大的日志记录框架，它允许开发者在各种环境中方便地管理和控制日志输出，从而提高软件的可维护性和调试效率。通过合理的配置和使用，log4cplus能够帮助开发者更好地理解程序的运行状态，快速定位和解决问题。

log4cplus开发手册

2015-08-13 上传
log4cplus文档chm版本，我已经用doxygen编译完毕，这个使用手册对开发非常有帮助。

log4cplus 源码(C++编写的开源的日志系统)

2011-07-18 上传
log4cplus是C++编写的开源的日志系统，功能非常全面，用到自己开发的工程中会比较专业的，：），本文介绍了log4cplus基本概念，以及如何安装，配置。 ### 简介 ### log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周 期； 你可以选择将信息输出到屏幕、文件、 NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。 ### 下载 ### 最新的log4cplus可以从以下网址下载 http://log4cplus.sourceforge.net本文使用的版本为：1.0.2 ### 安装 ### 1. linux下安装 tar xvzf log4cplus-x.x.x.tar.gz cd log4cplus-x.x.x ./configure --prefix=/where/to/install make make install 这里我采用缺省安装路径：/usr/local，下文如无特别说明，均以此路径为准。 2. windows下安装 不需要安装，有一个msvc6存放包括源代码和用例在内的开发工程（for VC6 only），使用之前请先编译 "log4cplus_dll class"工程生成dll，或者编译"log4cplus_static class"工程生成lib. ### 使用前的配置 ### 1. linux下的配置 确保你的Makefile中包含 /usr/local/lib/liblog4cplus.a（静态库）或 -llog4cplus（动态库）即可， 头文件在/usr/local/include/log4cplus目录下。对于动态库，要想正常使用，还得将库安装路径加入到 LD_LIBRARY_PATH 中，我一般是这样做的：以管理员身份登录，在/etc/ld.so.conf中加入安装路径，这里 是/usr/local/lib，然后执行ldconfig使设置生效即可。 2. windows下的配置 将"log4cplus_dll class"工程或"log4cplus_static class"工程的dsp 文件插入到你的工程中，或者直接 把两个工程编译生成的库以及头文件所在目录放到你的工程的搜索路径中，如果你使用静态库，请在你的工程中 "project/setting/C++"的preprocessor definitions中加入LOG4CPLUS_STATIC。 ### 构成要素介绍 ### 虽然功能强大，应该说log4cplus用起来还是比较复杂的，为了更好地使用它，先介绍一下它的基本要素。 Layouts ：布局器，控制输出消息的格式. Appenders ：挂接器，与布局器紧密配合，将特定格式的消息输出到所挂接的设备终端 （如屏幕，文件等等)。 Logger ：记录器，保存并跟踪对象日志信息变更的实体，当你需要对一个对象进行 记录时，就需要生成一个logger。 Categories ：分类器，层次化（hierarchy）的结构，用于对被记录信息的分类，层次中 每一个节点维护一个logger的所有信息。 Priorities ：优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。 本文介绍了log4cplus基本概念，以及如何安装，配置，下一篇将通过例子介绍如何使用log4cplus。 （二） 本文介绍了使用log4cplus有六个步骤，并提供了一些例子引导你了解log4cplus的基本使用。 ### 基本使用 ### 使用log4cplus有六个基本步骤： 1. 实例化一个appender对象 2. 实例化一个layout对象 3. 将layout对象绑定(attach)到appender对象 4. 实例化一个logger对象,调用静态函数：log4cplus::Logger::getInstance("logger_name") 5. 将appender对象绑定(attach)到logger对象，如省略此步骤，标准输出（屏幕）appender对象会绑定到logger 6. 设置logger的优先级，如省略此步骤，各种有限级的消息都将被记录 下面通过一些例子来了解log4cplus的基本使用。 〖例1〗 cpp 代码 /* 严格实现步骤1-6，appender输出到屏幕, 其中的布局格式和LogLevel后面会详细解释。*/ #include #include #include using namespace log4cplus; using namespace log4cplus::helpers; int main(){ /* step 1: Instantiate an appender object */ SharedObjectPtr _append (new ConsoleAppender()); _append->setName("append for test"); /* step 2: Instantiate a layout object */ std::string pattern = "%d{%m/%d/%y %H:%M:%S} - %m [%l]%n"; std::auto_ptr _layout(new PatternLayout(pattern)); /* step 3: Attach the layout object to the appender */ _append->setLayout( _layout ); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* step 6: Set a priority for the logger */ _logger.setLogLevel(ALL_LOG_LEVEL); /* log activity */ LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...") sleep(1); LOG4CPLUS_WARN(_logger, "This is the SECOND log message...") return 0; } 输出结果： 10/14/04 09:06:24 - This is the FIRST log message... [main.cpp:31] 10/14/04 09:06:25 - This is the SECOND log message... [main.cpp:33] 〖例2〗 /* 简洁使用模式，appender输出到屏幕。 */ #include #include using namespace log4cplus; using namespace log4cplus::helpers; int main() { /* step 1: Instantiate an appender object */ SharedAppenderPtr _append(new ConsoleAppender()); _append->setName("append test"); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* log activity */ LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...") sleep(1); LOG4CPLUS_WARN(_logger, "This is the SECOND log message...") return 0; } 输出结果： DEBUG - This is the FIRST log message... WARN - This is the SECOND log message... 〖例3〗 /* iostream模式，appender输出到屏幕。 */ #include #include #include /* 其实这个东东还是放到log4cplus头文件中比较合适些，个人意见：） */using namespace log4cplus; int main() { /* step 1: Instantiate an appender object */ SharedAppenderPtr _append(new ConsoleAppender()); _append->setName("append test"); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* log activity */ LOG4CPLUS_TRACE(_logger, "This is" << " just a t" << "est." << std::endl) LOG4CPLUS_DEBUG(_logger, "This is a bool: " << true) LOG4CPLUS_INFO(_logger, "This is a char: " << 'x') LOG4CPLUS_WARN(_logger, "This is a int: " << 1000) LOG4CPLUS_ERROR(_logger, "This is a long(hex): " << std::hex << 100000000) LOG4CPLUS_FATAL(_logger, "This is a double: " << std::setprecision(15) << 1.2345234234) return 0; } 输出结果： DEBUG - This is a bool: 1 INFO - This is a char: x WARN - This is a int: 1000 ERROR - This is a long(hex): 5f5e100 FATAL - This is a double: 1.2345234234 〖例4〗 /* 调试模式，通过loglog来控制输出调试、警告或错误信息，appender输出到屏幕。 */ #include #include using namespace log4cplus::helpers; void printMsgs(void) { std::cout << "Entering printMsgs()..." << std::endl; LogLog::getLogLog()->debug("This is a Debug statement..."); LogLog::getLogLog()->warn("This is a Warning..."); LogLog::getLogLog()->error("This is a Error..."); std::cout << "Exiting printMsgs()..." << std::endl << std::endl; } int main() { /* LogLog类实现了debug, warn, error 函数用于输出调试、警告或错误信息， 同时提供了两个方法来进一步控制所输出的信息，其中： setInternalDebugging方法用来控制是否屏蔽输出信息中的调试信息，当输入 参数为false则屏蔽，缺省设置为false。 setQuietMode方法用来控制是否屏蔽所有输出信息，当输入参数为true则屏蔽， 缺省设置为false。 LogLog::getLogLog()->setInternalDebugging(false); */ printMsgs(); std::cout << "Turning on debug..." << std::endl; LogLog::getLogLog()->setInternalDebugging(true); printMsgs(); std::cout << "Turning on quiet mode..." << std::endl; LogLog::getLogLog()->setQuietMode(true); printMsgs(); return 0; } 输出结果： Entering printMsgs()... log4cplus:WARN This is a Warning... log4cplus:ERROR This is a Error... Exiting printMsgs()... Turning on debug... Entering printMsgs()... log4cplus: This is a Debug statement... log4cplus:WARN This is a Warning... log4cplus:ERROR This is a Error... Exiting printMsgs()... Turning on quiet mode... Entering printMsgs()... Exiting printMsgs()... 需要指出的是，输出信息中总是包含"log4cplus:"前缀，有时候会感觉不爽，这是因为LogLog在实现时候死定了要这么写： LogLog::LogLog() : mutex(LOG4CPLUS_MUTEX_CREATE), debugEnabled(false), quietMode(false), PREFIX( LOG4CPLUS_TEXT("log4cplus: ") ), WARN_PREFIX( LOG4CPLUS_TEXT("log4cplus:WARN ") ), ERR_PREFIX( LOG4CPLUS_TEXT("log4cplus:ERROR ") ) { } 你可以把这些前缀换成自己看着爽的提示符号，然后重新编译，hihi。除非万不得已或者实在郁闷的不行，否则还是不要这样干。

log4cplus 一个开源的c++日志库

2015-03-31 上传
一个非常好用的开源c++的日志库。写的非常好。是和log4jxxx是一个系列。我用它主要是可以和linux下的syslog的对接。有兴趣的可以去 源码库http://sourceforge.net/projects/log4cplus/files/log4cplus-stable/下载。

log4cplus 使用文档说明

2015-05-04 上传
"log4cplus 使用文档说明" log4cplus 是一个 C++ 编写的开源日志系统，前身是 Java 编写的 log4j 日志系统。log4cplus 具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分优先级使其可以面向程序调试、运行...

Log4cplus使用指南

2015-08-20 上传
### Log4cplus使用指南 #### 1. Log4cplus简介 Log4cplus是一款专为C++设计的开源日志系统，其前身是基于Java的log4j系统。这款工具由Tad E. Smith开发，并受到Apache Software License的保护。Log4cplus提供了...

log4cplus-1.2.1库使用说明

2018-11-23 上传
《log4cplus-1.2.1库使用详解》 在软件开发中，日志记录扮演着至关重要的角色，它能帮助开发者追踪程序运行状态，定位错误和异常。log4cplus是一款针对C++应用的开源日志框架，其设计理念源自Java的log4j，旨在提供...

Log4cplus使用指南.doc

2020-08-28 上传
Log4cplus 使用指南 Log4cplus 是一个功能强大且灵活的日志记录库，提供了广泛的日志记录功能，旨在帮助开发者快速高效地记录日志。本文档旨在提供一个详细的 Log4cplus 使用指南，旨在帮助开发者快速上手 Log4c...

Log4cplus_src C++ 日志模块 源代码和使用说明

2012-01-06 上传
Log4cplus_src C++ 日志模块 源代码和使用说明

log4cplus-1.0.4 vs2005可用 附带编译说明。

2011-05-24 上传
**正文** ...以上内容涵盖了log4cplus-1.0.4在VS2005环境下的编译和应用关键点，希望对你在实际开发中使用log4cplus有所帮助。在实践中不断探索，你会发现log4cplus是一个功能强大且易于使用的日志库。

log4cplus.dll下载资源

348 浏览量
对于`log4cplus.dll`的下载资源，`readme.txt`可能会提供编译和配置`log4cplus`的指南，以及如何正确使用`dll`和`lib`文件的提示。 **总结** `log4cplus`是一个强大的C++日志框架，其Unicode版本的`dll`和`lib`...
forlove89
  • 粉丝: 2
  • 资源: 30
上传资源 快速赚钱

最新资源