【log4j】下载、安装、使用

log4j的意思：log for java
官网：https://logging.apache.org/log4j/1.2
w3cschool教程参考：https://www.w3cschool.cn/java/log4j-installation.html

1. 下载

http://logging.apache.org/log4j/1.2/download.html
下载后文件：log4j-1.2.17.zip

2. 安装

（1）解压【log4j-1.2.17.zip】
解压后文件夹：

（2）拷贝【log4j-1.2.17.jar】到工程里面：

（3）jar文件点右键 ->【Build Path】->【Add to Build Path】

导入后：

3. 使用log4j输出log

（1）src下新建配置文件【log4j.properties】
默认情况下， LogManager 在CLASSPATH中查找名为log4j.properties的文件。

log4j.properties的内容(使用方法参考其中的注释)：

### 导出文件夹的变量定义
logFolder = D://logs

### log4j.rootLogger格式： [ level ] , appenderName1, appenderName2, appenderName3, ......
log4j.rootLogger = debug,stdout,file1,file2

### Log4j的appender有以下几种实现：
###    org.apache.log4j.ConsoleAppender：控制台
###    org.apache.log4j.FileAppender：文件
###    org.apache.log4j.DailyRollingFileAppender：每天产生一个日志文件（用DatePattern控制何时滚动文件。默认情况下每晚0点滚动。）
###    org.apache.log4j.RollingFileAppender：文件大小到达指定尺寸的时候产生一个新的文件
###    org.apache.log4j.WriterAppender：将日志信息以流格式发送到任意指定的地方

### Log4j的layout有以下几种实现（实际开发一般用PatternLayout）：
###    org.apache.log4j.HTMLLayout：以HTML表格形式布局
###    org.apache.log4j.PatternLayout：可以灵活地指定布局模式
###    org.apache.log4j.SimpleLayout：包含日志信息的级别和信息字符串
###    org.apache.log4j.TTCCLayout：包含日志产生的时间、线程、类别等等信息

### 定义stdout，输出到控制台 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 定义file1，输出到 D://logs/log.log
log4j.appender.file1 = org.apache.log4j.DailyRollingFileAppender
###File：设定生成log的目录和文件名
log4j.appender.file1.File = ${logFolder}/log.log
###Append：(true：追加到原文件末尾；false：覆盖原文件内容）
log4j.appender.file1.Append = true
###Threshold：设定输出log的阈值级别
log4j.appender.file1.Threshold = DEBUG 
log4j.appender.file1.layout = org.apache.log4j.PatternLayout
log4j.appender.file1.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 定义file2，输出到 D://logs/error.log
log4j.appender.file2 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.file2.File =${logFolder}/error.log 
log4j.appender.file2.Append = true
log4j.appender.file2.Threshold = ERROR 
log4j.appender.file2.layout = org.apache.log4j.PatternLayout
log4j.appender.file2.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

更多参考：https://www.w3cschool.cn/java/log4j-configuration.html

（2）写出log
Main.java

package abc;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;

public class Main {
    // 获取logger实列
	private static Logger logger = Logger.getLogger(Main.class); 
	
	public static void main(String[] args) throws Exception {
	    // 定义输出log的级别
		logger.setLevel(Level.TRACE);
		
		// 输出log
		logger.trace("trace message");
		logger.debug("debug message");
		logger.info("info message");
		logger.warn("warn message");
		logger.error("error message");
		logger.fatal("fatal message");
	}
}

（3）运行java程序后，看log。
①控制台（因为设定了TRACE以上级别，所以输出了所有log）：

②D://logs/log.log（因为设定了DEBUG以上级别，所以输出DEBUG级别以上的log）：

③D://logs/error.log（因为设定了ERROR以上级别，所以输出ERROR级别以上的log）：

④如果在不同日期执行，可以看到之前的log文件按日期进行备份，然后生成了当天的新的log文件。（可以用DatePattern控制何时滚动文件。默认情况下每晚0点滚动。）

【完】