Log4cxx配置文件介绍

Log4cxx配置由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。
   
1.日志信息的优先级

Logger的语法：              
log4j.rootLogger = [ level ] , appenderName, appenderName, …         
其中，level 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别，可以控制到应用程序中相应级别的日志信息的开关。比如这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName名字任意，用来标示日志信息输出到哪里，可以同时指定多个。
日志信息的输出目的地             
Appender的语法：              
log4j.appender.appenderName = fully.qualified.name.of.appender.class        
log4j.appender.appenderName.option1 = value1           
…               
log4j.appender.appenderName.option = valueN           
其中，Log4j提供的appender有以下几种：           
               
org.apache.log4j.ConsoleAppender 控制台           
org.apache.log4j.FileAppender 文件            
org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件         
org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸的时候产生一个新的文件       
org.apache.log4j.WriterAppender 将日志信息以流格式发送到任意指定的地方        

2.日志信息的输出格式             

Layout的语法：              
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class       
log4j.appender.appenderName.layout.option1 = value1          
…               
log4j.appender.appenderName.layout.option = valueN          

3.Log4j提供的Layout有以下几种：            

org.apache.log4j.HTMLLayout 以HTML表格形式布局          
org.apache.log4j.PatternLayout 可以灵活地指定布局模式          
org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串         
org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息         
Log4j采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：       
               
%m 输出代码中指定的消息             
%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL          
%r 输出自应用启动到输出该log信息耗费的毫秒数           
%c 输出所属的类目，通常就是所在类的全名           
%t 输出产生该日志事件的线程名            
%n 输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”         
%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出2008年11月14日 15:16:17,890
%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。

log4cxx调试日志选择性输出的配置方法

（转载请注明来源于金庆的专栏）

一般是每个类都有自己的日志, 可建立一个静态成员logger如下:

class A
{
private:
    static log4cxx::LoggerPtr logger;
};

需要在cpp文件中静态初始化:

log4cxx::LoggerPtr A::logger = log4cxx::Logger::getLogger("A");

日志类别名"A"就是类名, 也可以是模块名.类名, 如"DB.A".

log4cxx的惯例是使用这样一个静态成员.
但也可以是静态成员logger(), 这样不必静态初始化.

class A
{
private:
    static log4cxx::LoggerPtr logger()
    {
        return log4cxx::Logger::getLogger("A");
    }
};

但从效率考虑, 每次调用日志都要getLogger()不如静态初始化.

类代码中调用日志只需:

    LOG4CXX_DEBUG(logger, "test log...");

日志配置log4j.properties如下:

log4j.rootLogger=WARN, R

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=log.txt
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d %5p %c %x: %m%n

# log4j.logger.DB.A=DEBUG

默认所有日志等级为WARN, 不会输出DEBUG日志,
只需显式设定某一类日志的级别, 就可以选择性地输出该类日志.
如调试A类时, 取消配置文件中的注释就行了.