Log4J学习【十二】Properties文件中能够定义的配置项的格式和示例一

今天我们来看看在properties文件中能够定义的配置项的格式和示例。请注意，在看这些格式的时候，不要去死记硬背这些格式，而一定要想清楚，这些格式对应的配置代码；并且要明白，很多格式都是对应着某种对象中的一个属性，所以要看能够做什么样的配置，只需要找到那个类，并查看有哪些属性能够配置即可。
    1，设置整个Logger体系的门槛：log4j.threshold=[LEVEL]。比如在配置文件中，设置log4j.threshold=OFF，就相当于代码:
Logger.getRootLogger().getLoggerRepository().setThreshold(Level.OFF);
    2，配置Appender：首先，Appender在配置文件中是必须要定义名称的。意思是，如果要为某个Logger添加Appender，就必须先定义这个Appender，起一个名字，再将这个appender指定给某个Logger，靠名称来引用。
    要申明Appender，得首先定义这个Appender的类型，然后再使用额外的配置来完成这个Appender内置的属性的配置，比如Level。定义Appender的样式为：
log4j.appender.appenderName=appender的类的全限定名
    注意这个格式中，appenderName是程序员定义的appender的名字，可以随意起名，只是名字中间不能有空格，比如之前的A。两个例子：
log4j.appender.CA=org.apache.log4j.ConsoleAppender
log4j.appender.FA=org.apache.log4j.FileAppender
    在这个配置文件中，我声明了两个Appender，名称分别为CA和FA，并且对应的类型分别是ConsoleAppender和FileAppender。其他地方，不管是我要对CA和FA进行额外的配置，还是要在Logger中引用，都需要使用CA或FA这两个名字。
    当定义好Appender的类型之后，就可以配置appender的属性值了，其配置格式为：
log4j.appender.appenderName.option1=value1
log4j.appender.appenderName.option2=value2
    其中的option1...optionN指代的就是对应appender中的属性，即我们之前介绍的JAVABEAN规范中的属性定义。所以，在这里的配置，就没法有一个具体的格式存在了，每种appender里面能够配置些什么属性，都是直接使用.propertyName去引用即可。注意，各种属性配置对应的值，Log4j怎么处理呢？遵循两个规则，1，Log4J能够直接处理简单类型值，比如Integer、Long、String等。
    2，Log4j能够直接处理org.apache.log4j.Level类型的参数值。另外，如果要配置Layout属性，这个待会讨论。
    下面举几个例子：
log4j.appender.CA.target=System.err
log4j.appender.CA.follow=true
log4j.appender.FA.file=log1.log
log4j.appender.FA.append=true
    在这几段配置中，我们为之前定义的名字为CA的consoleAppender添加了两个配置项，target和follow，查看ConsoleAppender的源代码，可以找到对应的额setTarget和setFollow两个属性的写方法，并且其参数类型是String和Boolean，所以在这里，Log4j会自动的把follow=true中的true转型为Boolean，并分别调用两个setter方法完成属性的配置。同理，FA.file和FA.append分别定义了文件Appender的file属性和append属性，完成相应的转型操作并调用FileAppender中的setFile和setAppend方法进行属性配置。关于这些属性具体的意思，我们在后面详细介绍常用的Appender的时候再看。
    使用这种格式能够设置普通类型的属性，而如果要单独的配置每个appender中的layout，使用下面的格式：
log4j.appender.appenderName.layout=layout的全限定名
    并且使用
log4j.appender.appenderName.layout.propertyName=value
    来设置layout的属性。还记得之前讲到的，layout一般都属于某一个appender，换句话说，一般不会在不同的appender之间共享相同的Layout对象。所以大家可以看到，在设计layout的配置的时候，log4j并没有为我们提供重复使用layout的方式（即命名），而是必须单独为每个appender配置对应的layout。下面是几个layout的配置示例：
log4j.appender.CA.layout=org.apache.log4j.SimpleLayout
log4j.appender.FA.layout=org.apache.log4j.PatternLayout
log4j.appender.FA.layout.conversionPattern=%r [%t] %p %c %x - %m%n
    在这段配置中，我们分别为ConsoleAppender配置了一个SimpleLayout。因为SimpleLayout不需要额外配置的属性，所以就没有再对这个layout进行更多的配置。这里就只是相当于调用了ca.setLayout(new org.apache.log4j.SimpleLayout())；而对于FA，我们配置了一个类型为PatternLayout的layout，在这个layout中，需要我们设置日志的样式模板的格式，而这个格式在PatterLayout中对应的属性名称为conversionPattern，所以，在最后一条配置中，我们通过使用log4j.appender.FA.layout来指定要配置的layout是哪一个，接着后面使用conversionPattern来确定要设置的属性名称，value上是对应的格式。这条配置相当于fa.getLayout().setConversionPatter(“%r [%t] %p %c %x - %m%n”)。