首页 > 代码库 > Log4Qt 使用

Log4Qt 使用

一、下载

  http://sourceforge.net/projects/log4qt/develop

二、Log4Qt介绍

  Log4Qt 是Apache Log4J 的Qt移植版,所以看Log4J的资料应该是最直接有效的(因为Log4Qt的直接资料太少了)。

  Log4Qt主要是用来记录日志(有助于程序调试)。有3个主要的组件:

  Logger
提供日志记录服务,可以有多个Logger存在,每个有它们自己的名字。Logger间存在隶属关系,有一个Logger称为根Logger。
  Appender
用来指明将日志记录到什么地方:比如,控制台、文件、数据库,等等
  Layout
控制日志的输出格式,可以类比一下C中的printf哈。

三、使用Log4Qt

  由于程序中包含很多动态库,而几乎每个动态库都需要使用log功能,此时直接包含Log4Qt的源码或者使用静态库都不是太好的注意。所以:使用动态库

  其实只要写好工程文件,使用动态库也很简单:

  3.1 创建Qt工程,命名为libLog4Qt

  3.2 在项目根目录下新建文件夹3rdparty,并把下载的源代码中的放置在里面。

  3.3 编辑libLog4Qt.pro内容如下:

  目的:构建一个动态库

TEMPLATE = lib
CONFIG += log4qt-buildlib
QT += core xml network

include(liblog4qt.pri)
TARGET = $$LIBLOG4QT_NAME
DESTDIR = $$PROJECT_LIBDIR
win32{
    DLLDESTDIR = $$PROJECT_BINDIR
    QMAKE_DISTCLEAN += $$PROJECT_BINDIR/$${LIBLOG4QT_NAME}.dll
}
CONFIG += debug_and_release build_all

LOG4QT_VERSION_MAJOR = 1
LOG4QT_VERSION_MINOR = 0
LOG4QT_VERSION_RELEASE = 0

LOG4QT_VERSION = \\"$${LOG4QT_VERSION_MAJOR}.$${LOG4QT_VERSION_MINOR}.$${LOG4QT_VERSION_RELEASE}\\"
DEFINES += LOG4QT_VERSION_STR=\"$${LOG4QT_VERSION}\"
DEFINES += LOG4QT_VERSION=$${LOG4QT_VERSION}

VERSION = 1.0.0

DEPENDPATH += src src/helpers src/spisrc/ varia
INCLUDEPATH += src src/helpers src/spi src/varia

 

  3.4 在以上创建的工程根目录下创建文档 libLog4Qt.pri

  编辑 libLog4Qt.pri如下:

  一开始定义几个变量:

  • 我们下载的 log4qt 所放置的目录
  • 我们的库文件准备放置到的路径(所有的动态库都需要这个,放置到单独一个common.pri中更好)
  • 库文件的名字(使用了qtLibraryTarget,这样在windows下debug和release自动拥有不同的名字,而且对我们是透明的,因为我们只在这一个文件内指定库文件的名字。)
LOG4QTSRCPATH = $$PWD/3rdparty/log4qt/src/log4qt
PROJECT_LIBDIR = $$PWD/lib
PROJECT_BINDIR = $$PWD/bin

TEMPLATE += fakelib
LIBLOG4QT_NAME = $$qtLibraryTarget(hlog4qt)
TEMPLATE -= fakelib

INCLUDEPATH += $$LOG4QTSRCPATH
DEPENDPATH += $$LOG4QTSRCPATH

!log4qt-buildlib{
    DEFINES += LOG4QT_IMPORTS
    LIBS +=  -L$$PROJECT_LIBDIR  -l$$LIBLOG4QT_NAME
}else{
    DEFINES += LOG4QT_EXPORTS
    INCLUDEPATH += -L$$PROJECT_LIBDIR $$LOG4QTSRCPATH/helpers                    $$LOG4QTSRCPATH/spi                    $$LOG4QTSRCPATH/varia
    DEPENDPATH += $$LOG4QTSRCPATH/helpers                    $$LOG4QTSRCPATH/spi                    $$LOG4QTSRCPATH/varia
    include($$LOG4QTSRCPATH/Log4Qt.pri)
}

 

创建libLog4Qt.pro

用来构建动态库

可以单独存在,也可以被上级的pro文件所包含(通过subdir)

创建libLog4Qt.pri

用来构建和使用动态库

任何需要使用log工程的pro文件,只需要include该文件即可

 

  3.5 编译项目,我们可以在lib目录下看到四个文件:

  libhlog4qt.so   libhlog4qt.so.1     libhlog4qt.so.1.0      libhlog4qt.so.1.0.0

  这表明我们已经成功构建来关于Log4Qt的动态库了。

  下面,我们就可以使用上面生成的动态库。

  3.6 我们在新项目中使用以上动态库需要做的事情:

  在.pro中加入:

LIBS += -L$$PWD/3rdParty/lib/ -lhlog4qt

INCLUDEPATH += $$PWD/3rdParty
DEPENDPATH += $$PWD/3rdParty

  并在使用前包含头文件和使用log:

  

#include "logger.h"
#include "basicconfigurator.h"





int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    Log4Qt::BasicConfigurator::configure();
    Log4Qt::Logger * log = Log4Qt::Logger::rootLogger();
    log->debug("Hello DbZhang800!");
    log->info("Hello Qt!");
    log->warn("Hello 1+1=2");
    return 0;
}

至此,我们已可以成功使用Log4Qt了。