Log4j扩展使用--日志记录器Logger

OK，现在我们认真的研究下Logger的配置，进行相关配置扩展。

Log4j有三个主要的组件：Loggers(记录器)，Appenders(输出源)和Layouts(布局)。其中，Logger负责记录日志，Appender负责输出到什么地方，Layout负责以什么格式输出，输出哪些附加信息等。综合使用这三个组件可以轻松的记录信息的类型和级别，并可以在运行时控制日志输出的样式和位置。

• Log4J三个核心概念

公共类     Logger      负责处理日志记录的大部分操作。 
公共接口   Appender    负责控制日志记录的输出。 
公共抽象类   Layout     负责格式化Appender的输出


Logger日志记录器是日志处理的核心组件。现在我们来认真的整理下这个组件。Logger就是Java代码中的logger，例如：

public static Logger log = Logger.getLogger(Log4jTest.class);

Logger是有名字的，它的名字便是Logger.getLogger()方法的参数。如果参数为所在的类，Log4j会去类名作为logger的名称，比如org.linkinpark.commons.logtest.Log4jTest。

Loggers组件在此系统中被分为五个级别：TRACE→DEBUG→INFO→WARNING→ERROR→FATAL→OFF。等级高的level自动屏蔽等级低的level，这点一定要记住。

这里Log4j有一个规则：假设Loggers级别为P，如果在Loggers中发生了一个级别Q比P高，则可以启动，否则屏蔽掉。假设你定义的级别是info，那么error和warn的日志可以显示而比他低的debug信息就不显示了。

注意以下几点：

1，Logger为单态模式，相同名字的logger只会有一个实例。如果在构建一个同名的Logger，log4j会返回之前的Logger实例。

2，一般情况下都以类名作为Logger的名称。Logger的名字类似于Java中的Package，大小写敏感，用点分开且具有继承关系。log4j.properties中通过名称来配置Logger的属性。

3，在对Logger实例进行命名时，没有限制，可以取任意自己感兴趣的名字。一般情况下建议以类的所在位置来命名Logger实例，这是目前来讲比较有效的Logger命名方式。这样可以使得每个类建立自己的日志信息，便于管理。

4，Log4j中有一个根记录器rootLogger，它是所有Logger的父类。

• logger的配置

在log.properties配置log4j.properties中，log4j.logger后面配置的是Logger，log4j.appender后面配置一个Appender。

log4j.logger.org.linkinpark.commons.logtest.Log4jTest=INFO,console

如果某个Logger没有配置，则使用它的父亲配置，知道找到为止。一般情况下，只需要配置根记录器rootLogger即可，所有的logger都会沿用rootLogger的配置。

• rootLogger配置

根记录器rootLogger直接用log4j.rootLogger配置即可。rootLogger是所有记录器的父亲，任何记录器都可以继承rootLogger的配置，代码如下：

#log4j.rootLogger=DEBUG,console,file#log4j.logger.org.linkinpark.commons.logtest.Log4jTest=INFOlog4j.rootLogger=INFO,console  #输出到控制台   log4j.appender.console=org.apache.log4j.ConsoleAppender  #设置输出样式   log4j.appender.console.layout=org.apache.log4j.PatternLayout #日志输出信息格式为log4j.appender.console.layout.ConversionPattern=[%-d{yyyy-MM-dd HH:mm:ss}]-[%t-%5p]-[%C-%M(%L)]： %m%n 

注意：如果要对某个Logger进行特殊的输出，只需要再配置一下该Logger就OK，覆盖父亲的配置即可。覆盖时，可以只配置级别，输出地，也可以2者都配置。

OK，现在我们举一个例子好了。

比如我现在有如下需求，一般的日志打印我都按照某一种特定的配置就够了，但是有一个类比较特殊，我需要进行特殊的配置那么要如何做呢？

1，写好2个Java源码，输出日志

2，主要是写好这个log4j.properties文件。先定义rootLogger，然后子类重新配置覆盖rootLogger就够了。但是丫的有一个问题就是说如果子类重新定义了appender，仍然会继承rootLogger的配置，也就是说2份日志输出了，我晕。

所以以后建议控制子类重写覆盖rootLogger配置的时候，只重写日志级别好了，其他的别动。OK，现在贴出代码：

package org.linkinpark.commons.logtest;import org.apache.log4j.Logger;/** * @创建作者： LinkinPark * @创建时间： 2016年2月23日 * @功能描述： 这个类用log4j的rootLogger默认输出 */public class Log4jTest{public static Logger log = Logger.getLogger(Log4jTest.class);/** * @创建时间： 2016年2月22日 * @相关参数： * @功能描述： 定义一个输出日志的方法 * <p> * trace→debug→info→warn→error→fatal→off * 级别依次升高，级别高的level会屏蔽级别低的level。 * </p> */public static void logTest(){System.out.println("=======这里是rootLogger类的日志输出======");if (log.isDebugEnabled()){log.debug("debug级别的日志输出");}log.trace("trace级别的日志输出");log.info("info级别的日志输出");log.warn("warn级别的日志输出");log.error("error级别的日志输出");log.fatal("fatal级别的日志输出");try{System.out.println(9 / 0);}catch (RuntimeException e){log.error(e.getMessage());}}public static void main(String[] args){logTest();}}

package org.linkinpark.commons.logtest;import org.apache.log4j.Logger;/** * @创建作者： LinkinPark * @创建时间： 2016年2月23日 * @功能描述： 这个类重新配置，来重写rootLogger的日志级别 */public class Log4jTest1{public static Logger log = Logger.getLogger(Log4jTest1.class);/** * @创建时间： 2016年2月22日 * @相关参数： * @功能描述： 定义一个输出日志的方法 * <p> * trace→debug→info→warn→error→fatal→off * 级别依次升高，级别高的level会屏蔽级别低的level。 * </p> */public static void logTest(){System.out.println("=======这里是特定类的日志输出======");log.info("info级别的日志输出");log.warn("warn级别的日志输出");log.error("error级别的日志输出");log.fatal("fatal级别的日志输出");try{throw new NullPointerException("人工抛出一个异常");}catch (RuntimeException e){log.error(e.getMessage());}}public static void main(String[] args){logTest();Log4jTest.logTest();}}

#可设置级别：TRACE→DEBUG→INFO→WARNING→ERROR→FATAL→OFF#高级别level会屏蔽低级别level。#debug：显示debug、info、error   #info：显示info、error   #log4j.rootLogger=DEBUG,console,filelog4j.logger.org.linkinpark.commons.logtest.Log4jTest1=ERRORlog4j.rootLogger=INFO,console# 一下是rootLogger的配置，子类默认继承，但是子类重写下面配置=rootLogger+自己配置，我晕#输出到控制台   log4j.appender.console=org.apache.log4j.ConsoleAppender  #设置输出样式   log4j.appender.console.layout=org.apache.log4j.PatternLayout #日志输出信息格式为log4j.appender.console.layout.ConversionPattern=[%-d{yyyy-MM-dd HH:mm:ss}]-[%t-%5p]-[%C-%M(%L)]： %m%n #输出到文件(这里默认为追加方式)   #log4j.appender.file=org.apache.log4j.FileAppender #log4j.appender.file.File=F:/LinkinPark/logs/Log4J.log #样式为TTCCLayout   #log4j.appender.file.layout=org.apache.log4j.TTCCLayout  #自定义样式   #%c输出所属的类目，通常就是所在类的全名 #%C输出Logger所在类的名称，通常就是所在类的全名 #%d输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，%d{ABSOLUTE}，%d{DATE}#%F输出所在类的类名称，只有类名。#%l输出语句所在的行数，包括类名+方法名+文件名+行数#%L输出语句所在的行数，只输出数字#%m输出代码中指定的讯息，如log(message)中的message#%M输出方法名#%p输出日志级别，即DEBUG，INFO，WARN，ERROR，FATAL#%r输出自应用启动到输出该log信息耗费的毫秒数#%t输出产生该日志事件的线程名#%n输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”#%%用来输出百分号“%”#log4j.appender.Linkin.layout.ConversionPattern=%n[%l%d{yy/MM/dd HH:mm:ss:SSS}][%C-%M] %m  #log4j.appender.Linkin.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}[%C]-[%p] %m%n   #log4j.appender.Linkin.layout.ConversionPattern = %d{ABSOLUTE} %5p %t %c{2}:%L - %m%n

OK，现在我们来看下控制台输出，没问题。

=======这里是特定类的日志输出======[2016-02-23 00:23:54]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest1-logTest(24)]： error级别的日志输出 [2016-02-23 00:23:54]-[main-FATAL]-[org.linkinpark.commons.logtest.Log4jTest1-logTest(25)]： fatal级别的日志输出 [2016-02-23 00:23:54]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest1-logTest(32)]： 人工抛出一个异常 =======这里是rootLogger类的日志输出======[2016-02-23 00:23:54]-[main- INFO]-[org.linkinpark.commons.logtest.Log4jTest-logTest(27)]： info级别的日志输出 [2016-02-23 00:23:54]-[main- WARN]-[org.linkinpark.commons.logtest.Log4jTest-logTest(28)]： warn级别的日志输出 [2016-02-23 00:23:54]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest-logTest(29)]： error级别的日志输出 [2016-02-23 00:23:54]-[main-FATAL]-[org.linkinpark.commons.logtest.Log4jTest-logTest(30)]： fatal级别的日志输出 [2016-02-23 00:23:54]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest-logTest(37)]： / by zero 

• 类别category配置

logger还有一个类别（category）的概念，荣国设置类别来设置类别下所有的logger。category类似于Java的package，效果和Logger的名字等价。这里也举一个例子好了：

OK，我们复制前面的log4jTest到一个新的包logtest1下，2份Java代码不变，然后设置配置文件控制不同的日志级别，来看看效果。

  

#可设置级别：TRACE→DEBUG→INFO→WARNING→ERROR→FATAL→OFF#高级别level会屏蔽低级别level。#debug：显示debug、info、error   #info：显示info、error   #log4j.rootLogger=DEBUG,console,file#子类重新定义日志级别，logger的名字是日志类的权限类名#log4j.logger.org.linkinpark.commons.logtest.Log4jTest1=ERROR#子类重新定义日志级别，category的名字是日志类的包名，可以将category理解为Java的package。log4j.category.org.linkinpark.commons.logtest1=ERRORlog4j.rootLogger=DEBUG,console# 以下是rootLogger的配置，子类默认继承，但是子类重写下面配置=rootLogger+自己配置，我晕#输出到控制台   log4j.appender.console=org.apache.log4j.ConsoleAppender  #设置输出样式   log4j.appender.console.layout=org.apache.log4j.PatternLayout #日志输出信息格式为log4j.appender.console.layout.ConversionPattern=[%-d{yyyy-MM-dd HH:mm:ss}]-[%t-%5p]-[%C-%M(%L)]： %m%n #输出到文件(这里默认为追加方式)   #log4j.appender.file=org.apache.log4j.FileAppender #log4j.appender.file.File=F:/LinkinPark/logs/Log4J.log #样式为TTCCLayout   #log4j.appender.file.layout=org.apache.log4j.TTCCLayout  #自定义样式   #%c输出所属的类目，通常就是所在类的全名 #%C输出Logger所在类的名称，通常就是所在类的全名 #%d输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，%d{ABSOLUTE}，%d{DATE}#%F输出所在类的类名称，只有类名。#%l输出语句所在的行数，包括类名+方法名+文件名+行数#%L输出语句所在的行数，只输出数字#%m输出代码中指定的讯息，如log(message)中的message#%M输出方法名#%p输出日志级别，即DEBUG，INFO，WARN，ERROR，FATAL#%r输出自应用启动到输出该log信息耗费的毫秒数#%t输出产生该日志事件的线程名#%n输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”#%%用来输出百分号“%”#log4j.appender.Linkin.layout.ConversionPattern=%n[%l%d{yy/MM/dd HH:mm:ss:SSS}][%C-%M] %m  #log4j.appender.Linkin.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}[%C]-[%p] %m%n   #log4j.appender.Linkin.layout.ConversionPattern = %d{ABSOLUTE} %5p %t %c{2}:%L - %m%n

OK，我们现在看下控制台输出：没问题，成功输出我们自己定义的特定的包下面的日志，并且按照我们自己配置的日志级别。

=======这里是特定包下面类的日志输出======[2016-02-23 00:39:56]-[main-ERROR]-[org.linkinpark.commons.logtest1.Log4jTest1-logTest(30)]： error级别的日志输出 [2016-02-23 00:39:56]-[main-FATAL]-[org.linkinpark.commons.logtest1.Log4jTest1-logTest(31)]： fatal级别的日志输出 [2016-02-23 00:39:56]-[main-ERROR]-[org.linkinpark.commons.logtest1.Log4jTest1-logTest(38)]： 人工抛出一个异常 =======这里是rootLogger类的日志输出======[2016-02-23 00:39:56]-[main-DEBUG]-[org.linkinpark.commons.logtest.Log4jTest-logTest(29)]： debug级别的日志输出 [2016-02-23 00:39:56]-[main- INFO]-[org.linkinpark.commons.logtest.Log4jTest-logTest(32)]： info级别的日志输出 [2016-02-23 00:39:56]-[main- WARN]-[org.linkinpark.commons.logtest.Log4jTest-logTest(33)]： warn级别的日志输出 [2016-02-23 00:39:56]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest-logTest(34)]： error级别的日志输出 [2016-02-23 00:39:56]-[main-FATAL]-[org.linkinpark.commons.logtest.Log4jTest-logTest(35)]： fatal级别的日志输出 [2016-02-23 00:39:56]-[main-ERROR]-[org.linkinpark.commons.logtest.Log4jTest-logTest(42)]： / by zero 

OK，下一篇我会整理到日志的输出组件Appender。