[原创] log4cxx在Linux下的安装、使用

简单地说,log4cxx就是一个记录日志的C++库(程序运行的时候要保存一些日志到文件,以供将来查看),它是从著名的Java日志库log4j移植而来的,并且它是Apache的一个项目,质量有保证,不用犹豫了,就用它吧!

补一句:Apache声称log4cxx的速度快、灵活性好,但是,速度快是第一位的,灵活性是第二位的("Log4cxx claims to be fast and flexible: speed first, flexibility second."),所以,担心日志记录性能的同学更可以选择log4cxx啦。

但是,这玩意的安装、编译稍微有点麻烦,如果遇到了问题,没耐心的人可能就没兴趣折腾了,我在这里把自己遇到的问题记一下。

系统环境:RHEL 5.3,64位

 

首先去log4cxx的官方网站下载源码安装包:http://logging.apache.org/log4cxx/,点击左边的“Download”进入下载页面,当前(2011年8月9日)的最新版本是0.10.0,你可以下载 .tar.gz 压缩包,解压出来即可。

然后就可以直接configure,make,make install了吗?不行,因为log4cxx官方提供的源码安装包不是一个all-in-one的包,它还依赖于Apache的另外两个库:Apache Portable Runtime(APR)和Apache Portable Runtime Utility(APR-Util),你可以在这个链接找到它们:http://apr.apache.org/

(1)安装

安装顺序不能变。首先要安装APR,下载到源码安装包后,解压出来,然后:

./configure --prefix=/usr/local/apr
make
make install

这里把APR安装到了 /usr/local/apr 目录下,注意,千万不要直接./configure,因为那样会把APR的文件安装到若干目录下,非常不利于维护。

文章来源:http://www.codelast.com/

再安装APR-Util,和上面一样,解压出来源码安装包,然后:

./configure --prefix=/usr/local/apr-util --with-apr=/usr/local/apr
make
make install

这里,通过 --with-apr 参数指定了前一步安装的APR的目录,同时也将APR-Util的安装目录设置在了/usr/local/apr-util 目录下。

最后,就是安装log4cxx了,但是在安装之前,还要再注意一点:configure的时候要指定APR和APR-Util的安装路径:

./configure --prefix=/usr/local/log4cxx --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr-util
mv libtool libtool.bak
ln -s /usr/bin/libtool libtool
make 
make install

注意,中间有两条匪夷所思的命令(mv 和 ln -s),如果不执行的话,会报错(我不太记得是在configure的时候还是make的时候报的错了):

/usr/lib/libexpat.so: could not read symbols: File in wrong format

这些问题的解决办法是从网上搜来的,官方的指南做得不给力啊。

文章来源:http://www.codelast.com/

这样就把log4cxx安装上了,然后你需要将log4cxx整合进你的程序中,我是把 log4cxx、APR、APR-Util 的三个静态库文件全部放置到我的工程目录下的某个子目录下,然后在Makefile中指定从这个目录下去寻找库文件。三个静态库名如下:liblog4cxx.a,libapr-1.a,libaprutil-1.a。

此外,我还将 log4cxx、APR、APR-Util 的所有头文件(.h)放置到了工程目录下。并在自己的程序中include工程目录下的这些文件。

然后就是在Makefile中添加上与log4cxx相关的一切东西,包括头文件路径,库文件路径等。如果你编译的时候看到与log4cxx相关的“undefined reference ...”的错误,那么肯定是没有找到相关的库文件或头文件,这里需要提醒你的是要添加的几个库文件参数:-llog4cxx,-lapr-1,-laprutil-1。

你把上面的步骤都做好了,这个时候,你再编译你的程序,可能又会遇到以下错误(好吧,的确有点折磨人):

./lib/log4cxx/libaprutil-1.a(apr_xml.o): In function `apr_xml_parser_geterror':

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:478: undefined reference to `XML_ErrorString'

./lib/log4cxx/libaprutil-1.a(apr_xml.o): In function `do_parse':

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:418: undefined reference to `XML_Parse'

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:422: undefined reference to `XML_GetErrorCode'

./lib/log4cxx/libaprutil-1.a(apr_xml.o): In function `cleanup_parser':

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:344: undefined reference to `XML_ParserFree'

./lib/log4cxx/libaprutil-1.a(apr_xml.o): In function `apr_xml_parser_create':

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:381: undefined reference to `XML_ParserCreate'

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:390: undefined reference to `XML_SetUserData'

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:391: undefined reference to `XML_SetElementHandler'

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:392: undefined reference to `XML_SetCharacterDataHandler'

/home/log4cxx/apr-util-1.3.12/xml/apr_xml.c:404: undefined reference to `XML_SetDefaultHandler'

collect2: ld returned 1 exit status

make: *** [cpsAPI] Error 1

文章来源:http://www.codelast.com/

这些乱七八糟的东西是怎么回事?据网上的一些文章说,这是 libaprutil 的一个bug,它不会自动链接到它的依赖项,从而导致了那些错误。要解决这个问题,你在编译的时候添加 -lexpat 参数即可——无论你是在Makefile中,还是在命令行直接用g++命令编译程序,都必须要带上这个参数,否则就会得到上面的那一堆错误(真让人恼火啊)。

这样,总算全部搞定了,程序可以编译通过了,下面,就是如何使用log4cxx来写日志的问题了,简单地说一下。在你需要写日志的类的文件中(例如MyClass.cpp),include两个log4cxx头文件:log4cxx.hpropertyconfigurator.h,然后在类的外部添加:

static log4cxx::LoggerPtr logger(log4cxx::Logger::getLogger("MyClass.cpp"));

然后在需要写日志之前,先加载log4cxx的配置文件(其实也可以不使用配置文件的,这里假设你要使用自定义的配置文件):

log4cxx::PropertyConfigurator::configure("./log4cxx.properties");

这里指定了log4cxx.properties文件作为log4cxx的配置文件(文件名不一定是要叫log4cxx.properties),

在这个文件中定义了各种参数,例如日志文件会写到哪里去,日志的格式等等。具体的格式可以很复杂、功能很强大,这里无法给出一个详细的说明,后面会给出一个简单的文件示例。

然后就可以写日志了,例如:

LOG4CXX_INFO(logger, "Test info message.");
LOG4CXX_ERROR(logger, "Test error message.");

文章来源:http://www.codelast.com/

运行程序,看看日志是否写进去了?写进去的话就说明成功了。

上面所说的log4cxx.properties文件,给一个例子如下:

log4j.rootLogger=debug, R
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
# Pattern to output the caller's file name and line number.
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %p (%F:%L) %c - %m%n
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=./app.log
log4j.appender.R.MaxFileSize=200KB
# Keep one backup file
log4j.appender.R.MaxBackupIndex=10
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %p (%F:%L) %c - %m%n

更多log4cxx的详细用法,可以参考log4cxx的一些官方例子:http://logging.apache.org/log4cxx/index.html
文章来源:http://www.codelast.com/
附:【使用log4cxx遇到的一些问题记录】
(1)IO Exception : status code =28
这个错误可能是由于磁盘空间满了造成的,log4cxx无法将日志写入磁盘上,请看这个链接

文章来源:https://www.codelast.com/
➤➤ 版权声明 ➤➤ 
转载需注明出处:codelast.com 
感谢关注我的微信公众号(微信扫一扫):

wechat qrcode of codelast

《[原创] log4cxx在Linux下的安装、使用》有6条评论

  1. 编译时出现
    inputstreamreader.cpp: In member function 'virtual log4cxx::LogString log4cxx::helpers::InputStreamReader::read(log4cxx::helpers::Pool&)':
    inputstreamreader.cpp:66: error: 'memmove' was not declared in this scope
    能解决么?

    回复

回复 learnhard 取消回复