2024年10月log4cpp（Log4cpp的布局）

　　⑴logcpp（Logcpp的布局

　　⑵首先回顾一下HelloWorld的日志格式，它使用了最简单的BasicLayout：ERROR:HellologcppinaErrorMessage!WARN:HellologcppinaWarningMessage!上面的日志格式还可以，但显然不是许多程序员心中理想的格式，许多人理想的格式应该是这样的：--::,:INFOinfoCategory:systemisrunning--::,:WARNinfoCategory:systemhasawarning--::,:ERRORinfoCategory:systemhasaerror,cantfindafile--::,:FATALinfoCategory:systemhasafatalerror,mustbeshutdown--::,:INFOinfoCategory:systemshutdown,youcanfindsomeinformationinsystemlog要获得上面的格式，必须使用比BasicLayout复杂的PatternLayout，而且要花一个小时来熟悉一下PatternLayout的格式定义方式，如果你认为值得的话。.PatternLayout在介绍PatternLayout以前，首先来看看logcpp中所有的Layout子类(Layout本身是个虚类)，一共三个：BasicLayout、PatternLayout和SimpleLayout，其中SimapleLayout并不建议使用，而BaiscLayout过于简单，因此如果程序员不自己扩展Layout的话，就只能使用PatternLayout了，值得庆幸的是，PatternLayout还是比较好用的。PatternLayout使用setConversionPattern函数来设置日志的输出格式。该函数的声明如下：voidlogcpp::PatternLayout::setConversionPattern(conststd::string&conversionPattern)throw(ConfigureFailure)[virtual]其中参数类型为std::string，类似于C语言中的printf，使用格式化字符串来描述输出格式，其具体含义如下：%ategory；%d日期；日期可以进一步的设置格式，用花括号包围，例如%d{%H:%M:%S,%l}或者%d{%d%m%Y%H:%M:%S,%l}。如果不设置具体日期格式，则如下默认格式被使用“WedJan::”。日期的格式符号与ANSIC函数strftime中的一致。但增加了一个格式符号%l，表示毫秒，占三个十进制位。%m消息；%n换行符，会根据平台的不同而不同，但对于用户透明；%p优先级；%r自从layout被创建后的毫秒数；%R从年月日时开始到目前为止的秒数；〉始到目前为止的时钟周期数；%xNDC。因此，要得到上述的理想格式，可以将setConversionPattern的参数设置为“%d:%p%c%x:%m%n”，其具体含义是“时间:优先级CategoryNDC:消息换行”。

　　⑶vs怎么搭建logcpp

　　⑷vs、vs下std::ifstream中不支持中文，是因为在vs、vs下，默认传入的unicode字符集，而一般开发的时候大多数使用的多字节字符集，所以会导致出错。、使用C语言的函数设置为中文运行环境setlocale(LC_ALL,“Chinese-simplified“);、使用STL函数设置为系统语言环境std::locale::global(std::locale(““));.或者直接修改logcpp的参数，直接传入的是宽字节。

　　⑸Logcpp的编译方法

　　⑹让我们从一个简单的例子开始，该例子将两条日志信息写入字符串流，该流会在标准控制台cout上输出，项目的名称是HelloLogCpp：#include《iostream》#includelogcpp/Category.hh#includelogcpp/OstreamAppender.hh#includelogcpp/BasicLayout.hh#includelogcpp/Priority.hhusingnamespacestd;intmain(intargc,char*argv){logcpp::OstreamAppender*osAppender=newlogcpp::OstreamAppender(osAppender,&cout);osAppender-》setLayout(newlogcpp::BasicLayout());logcpp::Category&root=logcpp::Category::getRoot();root.addAppender(osAppender);root.setPriority(logcpp::Priority::DEBUG);root.error(Hello·logcppinaErrorMessage!);root.warn(Hello·logcppinaWarningMessage!);logcpp::Category::shutdown();return;}要顺利编译运行还有两个地方需要设置，其一是引入的库中加上logcppD.lib(debug版dll库的引入文件)，即在头文件处加上#pragmament(lib,logcppD.lib);其二是将C/C++的CodeGeneration中的UseRuntimelibrary设置为“DebugMultithreadedDLL”。设置完成后编译运行结果如下：ERROR:Hello·logcppinaErrorMessage!WARN:Hello·logcppinaWarningMessage!以上两条日志格式很简陋，要设置合乎心意的日志格式，请参考后续的PatternLayout章节。

　　⑺logcpp，logcplus，logcxx这几个包之间是什么关系

　　⑻Logcxx需要依赖于APR。Logcpp较logc移植性稍差些。Logc基本上都是一些纯c的东西，移植性比其他二者都要好logcplus:简洁,下载的包编译顺利,测试例子也能顺利运行。logcxx:臃肿,需要引用apr(ApachePortableRuntime),最痛苦的是老是编译不了。logcpp:落后,最后更新于年,而且下载的包不完整。

　　⑼logcpp：logger有什么函数

　　⑽C++日志库，logcplus,logcpp使用资料手册下载logcpp并解压。打开logcpp-..bmsvcmsvc.dsw编译logcpp工程Release版。将编译后的logcpp.lib复制到VC的Lib目录中。将头文件的目录logcpp-..bincludelogcpp复制到VC的Include目录.(或者添加logcpp-..binclude到VC的Include环境变量)目标工程包含库logcpp.libws_.lib复制到VC的Lib目录.（要选择库连接方式相同的库包含头文件日志记录#include《logcplus/logger.h》日志配置读取#include《logcplus/consoleappender.h》NDC#include《logcplus/loglevel.h》日志代码每个类可以有自己的类别(logcpp::Category)，可以在配置文件中添加该类别并设置日志级别。所有的logcpp::Category都使用同一个Appender，不同的Category配置为不同的日志级别，就可以控制日志输出的范围。一般只使用四个记录日志级：DEBUG，INFO，WARN，ERROR如：logcpp::Category::getRoot().info(“Nowrunline%d“,__LINE__);或使用非根类别logcpp::Category::getInstance(“MyCat“).info(“Nowrunline%d“,__LINE__);使用流：logcpp::Category::getInstance(“main_cat“).infoStream()《《“Thiswillshowupas“《《《《“emergencymessage“《《logcpp::CategoryStream::ENDLINE;具体的函数说明见api文档.读取配置代码读取log配置文件，应在logcpp静态成员初始化之后。如在CXXXApp::InitInstance()中try{logcpp::PropertyConfigurator::configure(“log.ini“);}catch(logcpp::ConfigureFailuree){logcpp::Category::getRoot().warn(e.what());}

　　⑾Logcpp是个基于LGPL的开源项目，移植自Java的日志处理跟踪项目logj，并保持了API上的一致。其类似的支持库还包括Java(logj)，C++(logcpp、logcplus)，C(logc)，python(logp)等。Logcpp有如下优点：.提供了可扩展的多种日志记录方式；.提供了NDC(嵌套诊断上下文)，可用于多线程、多场景的跟踪调试；.提供了完整的日志动态优先级控制，可随时调整需要记录的日志优先级；.可通过配置文件完成所有配置并动态加载；.性能优秀，内存占用小，经过编译后的logcpp.dll大小仅有kb；.代码级的平台无关性，Logcpp源代码经过编译后，适用于大多数主流的操作系统和开发工具；.概念清晰，学习和使用方便，熟练程序员一天之内即可很好地应用logcpp进行开发

　　⑿使用logcpp，可以很便利地将日志或者跟踪调试信息写入字符流、内存字符串队列、文件、回滚文件、调试器、Windows日志、syslog和远程syslog服务器中。

　　⒀Logcpp中的概念继承自logj，最重要的是Category(种类)、Appender(附加目的地)和Layout(布局)三个概念，此外还有Priority(优先级)和NDC(嵌套的诊断上下文)等。简言之，Category负责向日志中写入信息，Appender负责指定日志的目的地，Layout负责设定日志的格式，Priority被用来指定Category的优先级和日志的优先级，NDC则是一种用来区分不同场景中交替出现的日志的手段。Logcpp记录日志的原理如下：每个Category都有一个优先级，该优先级可以由setPriority方法设置，或者从其父Category中继承而来。每条日志也有一个优先级，当Category记录该条日志时，若日志优先级高于Category的优先级时，该日志被记录，否则被忽略。系统中默认的优先级等级如下：typedefenum...{EMERG=,FATAL=,ALERT=,CRIT=,ERROR=,WARN=,NOTICE=,INFO=,DEBUG=,NOTSET=}PriorityLevel;注意：取值越小，优先级越高。例如一个Category的优先级为，则所有EMERG、FATAL、ALERT日志都可以记录下来，而其他则不能。Category、Appender和Layout三者的关系如下：系统中可以有多个Category，它们都是继承自同一个根，每个Category负责记录自己的日志;每个Category可以添加多个Appender，每个Appender指定了一个日志的目的地，例如文件、字符流或者Windows日志，当Category记录一条日志时，该日志被写入所有附加到此Category的Appender;每个Append都包含一个Layout，该Layout定义了这个Appender上日志的格式。重温前面的HelloWorld程序，可以发现其流程如下：.创建一个Appender，并指定其包含的Layout；.从系统中得到Category的根，将Appender添加到该Category中；.设置Category的优先级；.记录日志；.关闭Category。下面，我们按照Layout、Appender、Category、NDC的顺序来依次介绍这些概念并给出例子。

　　⒁Logcpp的下载安装

　　⒂下载下载版本..rc，这个版本目前是最稳定的，版本.在VC中表现不稳定。下载后的包名字为：logcpp-..rc.tar.gz(源代码包)和logcpp-docs-..rc.tar.gz(文档压缩包)。将它们解压后放入D盘。.在VC中编译Logcpp进入D:logcpp-..rcmsvc目录，打开VC的工作区msvc.dsw，将其中的工程都删除，只保留logcpp和logcppDLL两个工程。分别编译它们的Debug和Release版本。在VC中编译Logcpp会报错，其实只有一个错误，即不能在头文件中定义变量，同时给变量赋默认值。修改方法如下：将头文件Priority.hh中的这一行：stationstintMESSAGE_SIZE=;改为：stationstintMESSAGE_SIZE;并在Priority.cpp中的所有include语句后加上：constintlogcpp::Priority::MESSAGE_SIZE=;编译链接成功后会得到logcppD.dll、logcppD.lib(Debug版的dll和lib文件)和logcpp.dll、logcpp.lib(Release版的dll和lib文件)。新建目录D:logcpp-..rclib，将以上四个文件拷贝到该目录下。在VC中添加设置lib和include路径。将D:logcpp-..rclib加入系统的Path路径中。