1.介绍
Log4cxx是开放源代码项目Apache Logging Service的子项目之一,是Java社区著名的log4j的c++移植版,用于为C++程序提供日志功能,以便开发者对目标程序进行调试和审计。有关log4cxx的更多信息可以从Apache Loggin Service的网站http://logging.apache.org获得。当前的最新版本为0.10.0,本文内容及示例代码都是基于此版本。
2.获取软件包
可以从官方网站(http://logging.apache.org/log4cxx/index.html)获取源代码,下载版本为apache-log4cxx-0.10.0,下载完成后解压缩到合适目录。
3.编译
下载的原始文件包中没有包含编译后的开发库,需要自己编译生成,本文使用vc.net2003编译该源文件,编译时需要如下文件包:
apr-1.2.11-win32-src.zip和apr-util-1.2.10-win32-src.zip
这两个压缩包的下载地址分别如下:
http://archive.apache.org/dist/apr/apr-1.2.11-win32-src.zip
http://archive.apache.org/dist/apr/apr-util-1.2.10-win32-src.zip
第2个网址好像下下来的文件不是apr-util-1.2.10-win32-src.zip,直接进到http://archive.apache.org/dist/apr/下去下这两个文件
下载完成后将这两个文件分别解压缩到和上面源代码相同的目录下。然后按照如下步骤进行编译:
a. 将apr-1.2.11-win32-src.zip解压后的文件名修改为:apr
b. 将apr-util-1.2.10-win32-src.zip解压后的文件名修改为:apr-util
c. 通过vc.net2003的DOS工具进入DOS窗口,此处直接在运行命令栏中输入cmd也可,不过为安全起见最后从.net2003的工具栏进入DOS界面
d. 使用cd 命令进入apache-log4cxx-0.10.0目录
e. 输入configure命令,执行configure.bat批处理文件
f. 输入configure-aprutil命令,执行configure-aprutil.bat批处理文件。
注意:由于在configure-aprutil.bat文件中使用了linux下的sed命令,所以该步可能会出现类似找不到sed命令的错误,这是由于在windows环境下编译的缘故。可以使用如下两种方法解决:1.下载一个sed for windows的工具;2.使用Cygwin;不过本人强烈推荐使用第二种方法,因为有些sed for windows的工具存在bug。关于如何在windows环境下安装Cygwin请看文章后名说明。
g. 使用vc.net2003打开Projects文件夹下的log4cxx.dsw项目,将log4cxx工程设为启动项目,然后编译即可
h. 编译成功后,就可以在projects的Debuge或者Release文件夹下看到lib和dll文件
4.项目环境设置
有两种方法可以设置环境:通过.net2003的工具栏或者使用工程属性栏配置,这里只介绍第二种,本文将通过下面的实例程序介绍如何使用第二种方法设置环境。
5.实例代码
a.打开.net2003,新建一个空白的win32控制台工程,假设工程名为Test
b.添加一个cpp文件,文件名随便命名
c.右键点击Test工程,选择”属性”,然后在C++选项卡中添加附加库目录,注意该目录为../ apache-log4cxx-0.10.0/src/main/include
d.在属性的链接器输入选项卡的”附加依赖项”中添加” log4cxx.lib”
或者在using namespace log4cxx;后面加上一句
#pragma comment(lib, "cryptlib.lib")
e.在cpp文件中输入如下测试代码:
#include <log4cxx/logger.h>
#include <log4cxx/PropertyConfigurator.h>
using namespace std;
using namespace log4cxx;
int main(int argc, char* argv[])
{
string trace = "fa";
string Property = "./log.properties";
log4cxx::PropertyConfigurator::configure(Property);
LoggerPtr logger = Logger::getLogger(trace);
logger->info(("How to use?"));
LOG4CXX_INFO(logger, ("你说hello"));
for(int i = 0; i < 2; i++)
{
LOG4CXX_DEBUG(logger, "DEBUG");
LOG4CXX_INFO(logger, "INFO");
LOG4CXX_WARN(logger, "WARN");
LOG4CXX_ERROR(logger, "ERROR");
}
return 0;
}
f.新建一个文本文件,命名为log.properties,并键入如下内容:
# 设置root logger为DEBUG级别,使用了ca和fa两个Appender
log4j.rootLogger=DEBUG, ca, fa
#对Appender fa进行设置:
# 这是一个文件类型的Appender,
# 其输出文件(File)为./output.log,
# 输出方式(Append)为覆盖方式,
# 输出格式(layout)为PatternLayout
log4j.appender.fa=org.apache.log4j.FileAppender
log4j.appender.fa.File=./output.log
log4j.appender.fa.Append=false
log4j.appender.fa.layout=org.apache.log4j.PatternLayout
log4j.appender.fa.layout.ConversionPattern=%d [%t] %-5p %.16c - %m%n
#对Appender ca进行设置
# 这是一个控制台类型的Appender
# 输出格式(layout)为PatternLayout
log4j.appender.ca=org.apache.log4j.ConsoleAppender
log4j.appender.ca.layout=org.apache.log4j.PatternLayout
log4j.appender.ca.layout.ConversionPattern=%d [%t] %-5p %.16c - %m%n
g. 将编译好的log4cxx.lib和log4cxx.dll及上面的log.properties文件拷贝之Test工程目录
h.编译运行该文件,可以看到控制台输出相关日志,并且在工程目录下会得到一个output.log的日志文件
6.补充说明
上面的log4cxx.properties文件为log4xxx的配置文件,该文件主要用来设置该如何生成日志文件及日志文件的格式等信息,关于配置文件的说明可以参考如下文档。
7.Cygwin的安装
关于Cygwin的安装可以参考如下说明:
http://www.programarts.com/cfree_ch/doc/help/UsingCF/CompilerSupport/Cygwin/Cygwin1.htm
假设安装目录为D:/cygwin,安装成功后需要设置一下环境变量,可按如下步骤设置环境变量:
a. 右键点击我的电脑->属性->高级->环境变量
b. 在下面的系统变量中选择Path变量,在最后面添加D:/cygwin/bin即可
改了环境变量要重新开一个CMD命令行
文章出处:http://www.diybl.com/course/3_program/c++/cppsl/200887/134903.html