log4j

log4j

Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件，甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。
log4j官方地址：http://logging.apache.org/log4j/2.x/ 点击左侧download进行加载 再将jar包导入到相应的项目下就可以使用了。

---

log4j的优先级

ALL< DEBUG < INFO < WARN < ERROR < FATAL< OFF
若当前配置的优先级为INFO，则会输出INFO以及比INFO优先级高的信息。

---

log4j的配置文件

• 配置文件的路径：/项目名/src/
• 配置文件内容
  （1）、配置根Logger：log4j.rootLogger = [ level ] , appenderName1, appenderName2, …‘
  level：设定日志记录的最低级别appenderName：就是指定日志信息要输出到哪里。可以同时指定多个输出目的地，用逗号隔开。
  （2）、配置日志信息输出目的地（appender）：log4j.appender.appenderName
  appenderName：自定义，随便取就可以了。
  className：即类名，是log4j提供的。一般常用的类有

className	描述	可选项
org.apache.log4j.ConsoleAppender	输出在控制台	Threshold=WARN:指定日志信息的最低输出级别，默认为DEBUG。 ImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认值是true。 Target=System.err：默认值
org.apache.log4j.FileAppender	输出到指定文件	Threshold=WARN：指定日志信息的最低输出级别，默认为DEBUG。 ImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认值是true。 Append=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认值是true。 File=mylog.txt：指定消息输出的文件
org.apache.log4j.DailyRollingFileAppender	每天产生一个日志文件	Threshold=WARN：指定日志信息的最低输出级别，默认为DEBUG。 ImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认值是true。 Append=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认值是true。 File=mylog.txt：指定当前消息输出到mylog.txt文件中。 DatePattern=’.’yyyy-MM：每月产生一个新的日志文件。当前月的日志文件名为logging.log4j也可以指定按周、天、时、分等来滚动日志文件，对应的格式如下：’.’yyyy-MM：每月、’.’yyyy-ww：每周、’.’yyyy-MM-dd：每天、’.’yyyy-MM-dd-a：每天两次、 ‘.’yyyy-MM-dd-HH：每小时、’.’yyyy-MM-dd-HH-mm：每分钟
org.apache.log4j.RollingFileAppender	文件大小到达指定尺寸的时候产生一个新的文件	Threshold=WARN：指定日志信息的最低输出级别，默认为DEBUG。ImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认值是true。 Append=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认值是true。 File=mylog.txt：指定消息输出到mylog.txt文件中。 MaxFileSize=xx KB/MB/GB。在日志文件到达该大小时，将会自动移到logging.log4j.1文件中。 MaxBackupIndex=xx 天
org.apache.log4j.WriterAppender	将日志信息以流格式发送到任意指定的地方

（3）、配置日志信息的输出格式（Layout）：log4j.appender.appenderName.layout=className

className	描述	可选项
org.apache.log4j.HTMLLayout	以HTML表格形式布局	LocationInfo=true：输出java文件名称和行号，默认值是false。 Title=My Logging：默认值是Log4J Log Messages。
org.apache.log4j.PatternLayout	可以灵活地指定布局模式	ConversionPattern=%m%n：设定以怎样的格式显示消息。
org.apache.log4j.SimpleLayout	包含日志信息的级别和信息字符串
org.apache.log4j.TTCCLayout	包含日志产生的时间、线程、类别等等信息

（4）、格式化符号说明

• %p：输出日志信息的优先级，即DEBUG，INFO，WARN，ERROR，FATAL。
• %d：输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，如：%d{yyyy/MM/dd HH:mm:ss,SSS}。
• %r：输出自应用程序启动到输出该log信息耗费的毫秒数。
• %t：输出产生该日志事件的线程名。
• %l：输出日志事件的发生位置，相当于%c.%M(%F:%L)的组合，包括类全名、方法、文件名以及在代码中的行数。例如：est.TestLog4j.main(TestLog4j.java:10)。
• %c: 输出日志信息所属的类目，通常就是所在类的全名
• %t: 输出产生该日志事件的线程名。
• %x: 输出和当前线程相关联的NDC(嵌套诊断环境)，尤其用到像java servlets这样的多客户多线程的应用中。
• %%: 输出一个"%"字符。
• %F: 输出日志消息产生时所在的文件名称。
• %m: 输出代码中指定的消息,产生的日志具体信息。
• %n: 输出一个回车换行符，Windows平台为"\r\n"，Unix平台为"\n"输出日志信息换行。
• %20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。
• %-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，"-"号指定左对齐。
• %.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。
• %20.30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边交远销出的字符截掉。

---

例子

将日志输入到指定文件中的log4j配置文件：

log4j.rootLogger = info,appender1
log4j.appender.appender1.File =logs/log.log 
log4j.appender.appender1 = org.apache.log4j.FileAppender
log4j.appender.appender1.layout = org.apache.log4j.PatternLayout
log4j.appender.appender1.layout.ConversionPattern = %p %c %d{yyyy-MM-dd HH\:mm\:ss SSS} %m%n

相应的JAVA代码：

    public static void main(String[] args) {
        logger.debug("你好");
        logger.info("cdc");
    }

文件log.log的后缀可以为其他，如log.html、log.txt等。