log4j分析

.首先要有jar包：

log4j-1.2.13.jar

2.写测试文件：
import org.apache.log4j.Logger;


public class HelloLog4j {


        private static Logger logger = Logger.getLogger(HelloLog4j.class);
        public static void main(String[] args) {
                logger.debug("debug-----");
                logger.info("info-----");
                logger.error("error-----");
        }
}

3.创建log4j.properties文件
log4j.rootLogger = debug,appender1
log4j.appender.appender1 = org.apache.log4j.ConsoleAppender
log4j.appender.appender1.layout = org.apache.log4j.TTCCLayout
（每一行的意思：1.根目录：级别和目的地；2.目的地：控制台、文件等等；3.输出样式），其中下划线的名字为自定义的。

4.控制台输出为：
[main] DEBUG com.log4j.test.HelloLog4j - debug-----
[main] INFO com.log4j.test.HelloLog4j - info-----
[main] ERROR com.log4j.test.HelloLog4j - error-----
（log4j.rootLogger = info,appender1时，输出后两条，为error时，输出最后一条。）

5.log4j的类图：

Logger - 日志写出器，供程序员输出日志信息
Appender - 日志目的地，把格式化好的日志信息输出到指定的地方去
ConsoleAppender - 目的地为控制台的Appender
FileAppender - 目的地为文件的Appender
RollingFileAppender - 目的地为大小受限的文件的Appender
Layout - 日志格式化器，用来把程序员的loggin request格式化成字符串
PatternLayout - 用指定的pattern格式化loggin request 的Layout

6.三个重要组件：
a.日志信息的优先级------从高到低是 ERROR WARN INFO DEBUG
b.日志信息的输出目的地-------指定了日志将打印到控制台还是文件中
c.日志信息的输出格式--------控制了日志信息的显示内容

7.文件配置格式
        xml格式的文件，和propertise(key = value)文件

8.配置根Logger
        语法为：
                log4j.rootLogger = level,appdnderName1,appenderName2,.....

A.level是日志记录的优先级，分为OFF  FATAL  ERROR  WARN  INFO  DEBUG  ALL 或自定义的级别
log4j建议只使用四个级别，优先级从高到低分别是ERROR  WARN  INFO  DEBUG ，比如定义了INFO级别，则应用程序中所有DEBUG级别的日志信息不被打印出来。
优先级为：ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF


B.日志信息输出目的地Appender，语法为：
        log4j.appender.appenderName = log4j提供的appender类
        log4j.appender.appenderName.属性名 = 属性值
        。。。
        log4j.appender.appenderName.属性名 = 属性值


其中log4j提供的appender有：
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)


 B.1 ConsoleAppender 选项
        Threshold = WARN :指定日志消息的输出最低层次
        ImmediateFlush = true:默认值是true，意味着所有的消息都会被立即输出
        Target = System.err:默认情况下是：System.out,指定输出控制台
 B.2 FileAppender 选项
        Threshold = WARN :指定日志消息的输出最低层次
        ImmediateFlush=true:默认值是 true,意谓着所有的消息都会被立即输出
        File = mylog.txt: 指定消息输出到mylog.txt文件
        Append = false : 默认值是true，即将消息增加到指定文件中，false指将消息覆盖指定的文件内容
 B.3 DailyRollingFileAppender 选项
        Threshold = WARN : 指定日志消息的输出最低层次。
        ImmediateFlush = true: 默认值是true，所有消息都被立即输出。
        File = myLog.txt : 指定输出消息到mylog.txt文件。
        Append = false:默认为true，即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
        DatePattern = ''.''yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。
                也可以指定按月。周。天。时和分
                        ''.''yyyy-MM : 每月
                        ''.''yyyy-ww : 每周
                        ''.''yyyy-MM-dd : 每天
                        ''.''yyyy-MM-dd-a : 每天两次
                        ''.''yyyy-MM-dd-HH : 每小时
                        ''.''yyyy-MM-dd-HH-mm : 每分钟
 B.4 RollingFileAppender 选项
        Threshold = WARN : 指定日志消息的输出最低层次。
        ImmediateFlush = true : 默认值为true，意味着所有的消息都会被立即输出。
        File = mylog.txt:指定消息输出到mylog.txt文件。
        Append= false : 默认值为true，即将消息增加到指定文件中，false只将消息覆盖指定的文件内容。
        MaxFileSize = 100KB : 后缀可以是KB,MB或GB,在日志文件到达该大小时，将会自动滚动，即将原来的内容移到mylog.log.1文件
        MaxBackupIndex = 2 : 指定可以产生的滚动文件的最大数
如：
log4j.category.com.hxbank.fqz.md.xtzdwh=info, mdzdwh

######################################## Extract
log4j.appender.mdzdwh=org.apache.log4j.RollingFileAppender
log4j.appender.mdzdwh.File=mdzdwh.log
log4j.appender.mdzdwh.ImmediateFlush=true
log4j.appender.mdzdwh.MaxFileSize=50000KB
log4j.appender.mdzdwh.MaxBackupIndex=10
log4j.appender.mdzdwh.layout=org.apache.log4j.PatternLayout
log4j.appender.mdzdwh.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %-30c{3} %x - %m %n

9 . 配置日志信息的格式（布局），语法为：
log4j.appender.appenderName.layout = log4j提供的layout类
log4j.appender.appenderName.layout.属性 = 值
...
log4j.appender.appenderName.layout.属性 = 值


其中，log4j提供的layout类为：
org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(可以灵活的指定布局模式)
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间，线程，类别等等信息)


 A.HTMLLayout选项
        LocationInfo = true ： 默认值为false，输出java文件名称和行号
        Title= my app file : 默认值是Log4J Log Messages.
 B.PatternLayout 选项 
        ConversionPattern=%m%n : 指定怎样格式化指定的消息。
 C.XMLLayout 选项
        LocationInfo = true : 默认值是false，输出java文件和行号  
 Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：
      log4j.appender.A1.layout.ConversionPattern = %-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
如：
log4j.appender.mdzdwh.layout=org.apache.log4j.PatternLayout
log4j.appender.mdzdwh.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %-30c{3} %x - %m %n
解释 ：
        -X号 ：X信息输出时左对齐
        %p : 输出日志信息优先级，即DEBUG,INFO,WARN,ERROR,FATAL
        %d : 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式
        %r : 输出自应用启动到输出该log信息耗费的毫秒数
        %c : 输出日志信息所属的类目，通常就是所在类的全名
        %t : 输出产生该日志事件的线程名
        %l : 输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合，包括类目名，发生的线程，以及行数。
        %x : 输出和当前线程相关联的NDC(嵌套诊断环境)，尤其用到像java servlets这样的多客户多线程的应用中。
        %% : 输出一个“%”字符
        %F : 输出日志消息产生时所在的文件名称
        %L : 输出代码中的行号
        %m : 输出代码中指定的消息，产生的日志具体信息
        %n : 输出一个回车换行符，Windows平台下位“\r\n”,unix为"\n"输出日志信息换行


可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如： 
1)%20c：指定输出 category 的名称，最小的宽度是 20，如果 category 的名称小于 20 的话，默认的情
况下右对齐。 
2)%-20c:指定输出 category 的名称，最小的宽度是 20，如果 category 的名称小于 20 的话，"-"号指
定左对齐。 
3)%.30c:指定输出 category 的名称，最大的宽度是 30，如果 category 的名称大于 30 的话，就会将左
边多出的字符截掉，但小于 30 的话也不会有空格。 
4)%20.30c:如果 category 的名称小于 20 就补空格，并且右对齐，如果其名称长于 30 字符，就从左边交
远销出的字符截掉

10.举例：（Conversion单词，转换，改变）
A.
log4j.properties文件：
log4j.rootLogger = debug,myname
log4j.appender.myname = org.apache.log4j.ConsoleAppender-------------------------日志输出目的地为控制台
log4j.appender.myname.layout = org.apache.log4j.TTCCLayout


log4j.appender.myname.layout = org.apache.log4j.PatternLayout
log4j.appender.myname.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %-30c{3} %x - %m %n


测试文件：
import org.apache.log4j.Logger;


public class HelloLog4j {


        private static Logger logger = Logger.getLogger(HelloLog4j.class);
        public static void main(String[] args) {
                logger.debug("debug-----");
                logger.info("info-----");
                logger.error("error-----");
        }
}


输出为：
2014/03/26 14:22:21 [main] DEBUG log4j.test.HelloLog4j           - debug----- 
2014/03/26 14:22:21 [main] INFO  log4j.test.HelloLog4j           - info----- 
2014/03/26 14:22:21 [main] ERROR log4j.test.HelloLog4j           - error----- 

B.
log4j.rootLogger = debug,myname


log4j.appender.myname = org.apache.log4j.FileAppender--------------------日志信息输出目的地Appender


log4j.appender.myname.File = my.txt
log4j.appender.myname.Threshold = WARN ----------------------------------------最低级别
log4j.appender.myname.Append = true ----------------------------------默认为true，继续添加而不是覆盖


log4j.appender.myname.layout = org.apache.log4j.PatternLayout
log4j.appender.myname.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %.8c %x - %m %n


（运行两遍）输出文件my.txt：
2014/03/26 14:34:11 [main] DEBUG lloLog4j  - debug----- 
2014/03/26 14:34:11 [main] INFO  lloLog4j  - info----- 
2014/03/26 14:34:11 [main] ERROR lloLog4j  - error----- 
2014/03/26 14:34:13 [main] DEBUG lloLog4j  - debug----- 
2014/03/26 14:34:13 [main] INFO  lloLog4j  - info----- 
2014/03/26 14:34:13 [main] ERROR lloLog4j  - error----- 

C.
log4j.rootLogger = debug,myname
log4j.appender.myname = org.apache.log4j.RollingFileAppender-----------------文件大小到达指定尺寸的时候产生一个新的文件


log4j.appender.myname.File = my.txt
log4j.appender.myname.Threshold = debug
log4j.appender.myname.Append = true
log4j.appender.myname.MaxFileSize = 10 ---------------------------每个文件的大小
log4j.appender.myname.MaxBackupIndex = 5 -------------------------最多生成的文件数 


log4j.appender.myname.layout = org.apache.log4j.PatternLayout
log4j.appender.myname.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %.8c %x - %m %n


输出文件my.txt，my.txt.1，my.txt.2，my.txt.3
     


D.
log4j.appender.myname.File = myy.txt
log4j.appender.myname.Threshold = debug
log4j.appender.myname.Append = true
log4j.appender.myname.DatePattern = ''.''yyyy-MM-dd-HH-mm-ss


 输出文件myy.txt，一秒生成一次日志，文件逐渐增大。