Log4D是delphi下的一个日志类库,据称是仿照Log4J进行开发,官网没有相应的文档介绍,google了一下只搜出了一个简单的说明,按照说明使用了一下,感觉还是比较实用的。
首先,Log4D包含Logger,Layout,ErrorHandler,Filter,Render ,Appender等基本概念。
Logger是日志类,用于提供记录日志的方法。
Layout是指日志打印的格式
Renderer是指对象渲染器,用于对特定的类进行渲染。
ErrorHandler是错误处理器,
Filter是过滤器,决定特定的日志事件是否会被记录下来。
Appender,附加器,用于将日志内容附加到特定的地方,比如控制台、文件、数据库、网络等等。
接下来讲一下Log4D的基本配置,通过查看其源代码中的注释,对各配置项解释如下:
log4d.threshold=level level代表日志级别, 可能的值为 all|fatal|error|warn|info|debug|off|<custom level name>
log4d.configDebug=true 是否启用内部的debug事件,暂时不明如何使用
log4d.loggerFactory=TLogDefaultLoggerFactory 顾名思义,logger的工厂,用于产生logger对象的
log4d.rootLogger=warn,ODS,配置根logger,值为[level],appenderName[,appenderName]…
除去基础logger之外,还可以自定义logger,其配置方式类似于根Logger ,配置形式如下
log4d.logger.myapp=info,Fil1,其中逗号之前的是日志最低级别,逗号之后的是appender
说到appender,appender的定义示例如下
log4d.appender.Fil1=TLogFileAppender,Fil1是appender的名字,值是appender的类
log4d.appender.Fil1.append=true
log4d.appender.Fil1.fileName=info.log
log4d.appender.Fil1.errorHandler=TLogOnlyOnceErrorHandler
log4d.appender.Fil1.layout=TLogPatternLayout
log4d.appender.Fil1.layout.dateFormat=yyyy.mm.dd hh:nn:ss.zzz
log4d.appender.Fil1.layout.pattern=%d – %m%n
可以看到appender具有很多属性 ,在这里就不一一赘述。
配置完成后就是创建Logger对象了:
比如在类的私有属性里,创建一个Logger对象如下:
SampleLogger:TLogLogger
日志类的初始化的语句为:
TLogPropertyConfigurator.Configure(‘log4d.ini’);//通过读取配置文件进行初始化配置
DBLog := DefaultHierarchy.GetLogger(‘myapp’);//通过工厂获取Logger
这样就能使用日志类进行日志记录了。
今天先对Log4D进行一些简要说明,在下一篇文章中会尝试对其设计进行一些理解。
转载请注明:Delphi学习者 » Delphi日志工具Log4D-入门使用篇