Log4j是Apache下的一款开源的日志框架,通过在项目中使Log4J,我们可以控制日志信息输出到控制台、文件、甚至是数据库中。我们可以控制每一条日志的输出格式,通过定义日志的输出级别,可以更灵活的控制日志的输出过程。方便项目的调试。
官方网站: http://logging.apache.org/log4j/1.2/
1、 Log4j入门
1.1、建立maven工程
1.2、添加依赖
<dependencies>
<!--log4j-->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<!--测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
1.3、java代码
//快速入门
@Test
public void test01()throws Exception{
//3、初始化配置信息,在入门案例中暂不使用配置文件
BasicConfigurator.configure();
//1、获取日志记录器对象 import org.apache.log4j.Logger;
Logger logger = Logger.getLogger(Log4jTest.class);
//2、日志记录输出
logger.info("Hello Log4j");
//4、日志级别
logger.fatal("fatal"); //严重的错误,造成系统奔溃,并终止程序
logger.error("error"); //错误信息,不会影响系统运行
logger.warn("warn"); //警告信息,可能会发生问题
logger.info("info"); //运行信息,数据库的连接,网络的连接等等
logger.debug("debug"); //调试信息,一般在开发中使用,记录程序变量参数传递信息等等 【默认日志】
logger.trace("trace"); //追踪信息,记录程序所有的流程信息
}
1.4、日志的级别
【每个Logger都被了一个日志级别(log level),用来控制日志信息的输出。日志级别从高到低分别为】
fatal 指出每个严重的错误事件将会导致应用程序的退出。
error 指出虽然发生错误事件,但仍然不影响系统的继续运行。
warn 表明会出现潜在的错误情形。
info 一般和在粗粒度级别上,强调应用程序的运行全程。
debug 一般用于细粒度级别上,对调试应用程序非常有帮助。
trace 是程序追踪,可以用于输出程序运行中的变量,显示执行的流程。
【还有两个特殊的级别】
OFF,可用来关闭日志记录。
ALL,启用所有消息的日志记录。
注:一般只使用4个级别,优先级从高到低为 ERROR > WARN > INFO > DEBUG
2、 Log4j组件
Log4J 主要由 Loggers (日志记录器)、Appenders(输出端)和 Layout(日志格式化器)组成。其中Loggers 控制日志的输出级别与日志是否输出;Appenders 指定日志的输出方式(输出到控制台、文件等);Layout 控制日志信息的输出格式。
2.1 Loggers
日志记录器,负责收集处理日志记录,实例的命名就是类“XX”的full quailied name(类的全限定名),Logger的名字大小写敏感,其命名有继承机制:例如:name为org.apache.commons的logger会继承name为org.apache的logger。
Log4J中有一个特殊的logger叫做“root”,他是所有logger的根,也就意味着其他所有的logger都会直接或者间接地继承自root。root logger可以用Logger.getRootLogger()方法获取。
但是,自log4j 1.2版以来, Logger 类已经取代了 Category 类。对于熟悉早期版本的log4j的人来说,Logger 类可以被视为 Category 类的别名。
2.2 Appenders
Appender 用来指定日志输出到哪个地方,可以同时指定日志的输出目的地。Log4j 常用的输出目的地。
有以下几种:
2.3 Layouts
布局器 Layouts用于控制日志输出内容的格式,让我们可以使用各种需要的格式输出日志。Log4j常用的Layouts:
3、Layout的格式
在 log4j.properties 配置文件中,我们定义了日志输出级别与输出端,在输出端中分别配置日志的输出格式。
【注意:有了配置文件可以注释掉【1.3、java代码】中的 BasicConfigurator.configure();配置信息,也可以不注释,使用】
#%m 输出代码中指定的日志信息
#%p 输出优先级,及 DEBUG、INFO 等
#%n 换行符(Windows平台的换行符为 "\n",Unix 平台为 "\n")
#%r 输出自应用启动到输出该 log 信息耗费的毫秒数
#%c 输出打印语句所属的类的全名
#%t 输出产生该日志的线程全名
#%d 输出服务器当前时间,默认为 ISO8601,也可以指定格式,如:%d{yyyy年MM月dd日 HH:mm:ss}
#%l 输出日志时间发生的位置,包括类名、线程、及在代码中的行数。如:Test.main(Test.java:10)
#%F 输出日志消息产生时所在的文件名称
#%L 输出代码中的行号
#%% 输出一个 "%" 字符
#* 可以在 % 与字符之间加上修饰符来控制最小宽度、最大宽度和文本的对其方式。如:
#%5c 输出category名称,最小宽度是5,category<5,默认的情况下右对齐
#%-5c 输出category名称,最小宽度是5,category<5,"-"号指定左对齐,会有空格
#%.5c 输出category名称,最大宽度是5,category>5,就会将左边多出的字符截掉,<5不会有空格
#%20.30c category名称<20补空格,并且右对齐,>30字符,就从左边交远销出的字符截掉
4 、Appender的输出
4.1、控制台【在log4j.properties 配置文件】
#指定日志的输出级别与输出端
log4j.rootLogger=INFO,Console
# 控制台输出配置
#1、指定控制台日志输出的appender
log4j.appender.console = org.apache.log4j.ConsoleAppender
#指定消息格式layout,使用简单格式SimpleLayout ,HTML格式HTMLLayout,xml格式xml.XMLLayout
log4j.appender.console.layout = org.apache.log4j.PatternLayout
#指定消息格式的内容
#log4j.appender.console.layout.conversionPattern = %r [%t] %p %c %x - %m%n
log4j.appender.console.layout.conversionPattern =[%p] %r %l %d{yyyy-MM-dd- HH:mm:ss:SSS} %m%n
java代码同1.3。测试:日志级别是info,所有只输出fatal、error、warn、info。并且按照指定的格式输出。
4.2、文件【在log4j.properties 配置文件】
#指定日志的输出级别与输出端
log4j.rootLogger=INFO,file
#2、日志文件输出的appender对象
#指定文件日志输出的appender 【默认是追加的】
log4j.appender.file = org.apache.log4j.FileAppender
#指定消息格式layout,使用简单格式SimpleLayout ,HTML格式HTMLLayout,xml格式xml.XMLLayout
log4j.appender.file.layout = org.apache.log4j.PatternLayout
#指定消息格式的内容
#log4j.appender.console.layout.conversionPattern = %r [%t] %p %c %x - %m%n
log4j.appender.file.layout.conversionPattern =[%p] %r %l %d{yyyy-MM-dd- HH:mm:ss:SSS} %m%n
#指定日志文件的保存路径
log4j.appender.file.file = E:/code/maven/log4j_demo/logs/log4j.log
#指定日志文件的字符集
log4j.appender.file.encoding = UTF-8
测试:会在指定的路径下生成文件,并写入日志
4.3、按照文件大小拆分【在log4j.properties 配置文件】
#指定日志的输出级别与输出端
log4j.rootLogger=INFO,rollingFile
#3、按照文件大小拆分的 appender
#日志文件输出的 appender
log4j.appender.rollingFile = org.apache.log4j.RollingFileAppender
#指定消息格式layout,使用简单格式SimpleLayout ,HTML格式HTMLLayout,xml格式xml.XMLLayout
log4j.appender.rollingFile.layout = org.apache.log4j.PatternLayout
#指定消息格式的内容
#log4j.appender.console.layout.conversionPattern = %r [%t] %p %c %x - %m%n
log4j.appender.rollingFile.layout.conversionPattern =[%p] %r %l %d{yyyy-MM-dd- HH:mm:ss:SSS} %m%n
#指定日志文件的保存路径
log4j.appender.rollingFile.file = E:/code/maven/log4j_demo/logs/log4j.log
#指定日志文件的字符集
log4j.appender.rollingFile.encoding = UTF-8
#指定日志文件内容的大小
log4j.appender.rollingFile.maxFileSize = 1MB
#指定日志文件的数量【默认是一个】 超过10个,按照时间覆盖
log4j.appender.rollingFile.maxBackupIndex = 10
测试:在测试代码中加入for循环,让其输出1000次
4.4、按照时间规则拆分【在log4j.properties 配置文件】
#指定日志的输出级别与输出端
log4j.rootLogger=INFO.dailyFile
#日志文件输出的 appender
log4j.appender.dailyFile = org.apache.log4j.DailyRollingFileAppender
#指定消息格式layout,使用简单格式SimpleLayout ,HTML格式HTMLLayout,xml格式xml.XMLLayout
log4j.appender.dailyFile.layout = org.apache.log4j.PatternLayout
#指定消息格式的内容
#log4j.appender.console.layout.conversionPattern = %r [%t] %p %c %x - %m%n
log4j.appender.dailyFile.layout.conversionPattern =[%p] %r %l %d{yyyy-MM-dd- HH:mm:ss:SSS} %m%n
#指定日志文件的保存路径
log4j.appender.dailyFile.file = E:/code/maven/log4j_demo/logs/log4j.log
#指定日志文件的字符集
log4j.appender.dailyFile.encoding = UTF-8
#指定日期拆分规则 默认【'.'yyyy-MM-dd】
log4j.appender.dailyFile.datePattern = '.'yyyy-MM-dd-HH-mm-ss
测试:在测试代码中加入for循环,让其输出1000次
4.5、数据库
数据库这里需要新建数据库,加入数据库的依赖,并连接数据库
依赖
<!--mysql依赖-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.9</version>
</dependency>
新建数据库
CREATE TABLE log (
log_id int(11) NOT NULL AUTO_INCREMENT,
project_name varchar(255) DEFAULT NULL COMMENT '目项名',
create_date varchar(255) DEFAULT NULL COMMENT '创建时间',
level varchar(255) DEFAULT NULL COMMENT '优先级',
category varchar(255) DEFAULT NULL COMMENT '所在类的全名',
file_name varchar(255) DEFAULT NULL COMMENT '输出日志消息产生时所在的文件名称',
thread_name varchar(255) DEFAULT NULL COMMENT '日志事件的线程名',
line varchar(255) DEFAULT NULL COMMENT '号行',
all_category varchar(255) DEFAULT NULL COMMENT '日志事件的发生位置',
message varchar (4000) DEFAULT NULL COMMENT '输出代码中指定的消息',
PRIMARY KEY (log_id)
);
配置文件【在log4j.properties 配置文件】
#指定日志的输出级别与输出端
log4j.rootLogger=INFO,logDB
#5、mysql
log4j.appender.logDB = org.apache.log4j.jdbc.JDBCAppender
#输出格式
log4j.appender.logDB.layout = org.apache.log4j.PatternLayout
#驱动
log4j.appender.logDB.Driver = com.mysql.jdbc.Driver
#URL
log4j.appender.logDB.URL = jdbc:mysql://localhost:3306/springdb
#用户名
log4j.appender.logDB.User = root
#密码
log4j.appender.logDB.Password = 123456
#sql语句
log4j.appender.logDB.Sql = INSERT INTO log(project_name,create_date,level,category,file_name,thread_name,line,all_category,message ) values('itcast','%d{yyyy-MM-dd HH:mm:ss}','%p','%c','%F','%t','%L','%l','%m')
测试:
5 、自定义Logger
自定义logger的作用:有时候需要将某些日志写入日志文件,将另一些日志输出到控制台,自定义logger可以很好的区分。
log4j.rootLogger = trace,console
#6、自定义logger 对象设置 一般是包名,默认继承rootLogger,即同时会向控制台输出,也会写入文件
log4j.logger.edu.xust = info,file
#继承rootLogger,只向控制台输出,并且日志级别是error,其以下的都不会输出
log4j.logger.org.apache = error
java代码
//快速入门
@Test
public void test01()throws Exception{
//1、获取日志记录器对象 import org.apache.log4j.Logger;
Logger logger = Logger.getLogger(Log4jTest.class);
//2、日志记录输出
logger.info("Hello Log4j");
//4、日志级别
logger.fatal("fatal"); //严重的错误,造成系统奔溃,并终止程序
logger.error("error"); //错误信息,不会影响系统运行
logger.warn("warn"); //警告信息,可能会发生问题
logger.info("info"); //运行信息,数据库的连接,网络的连接等等
logger.debug("debug"); //调试信息,一般在开发中使用,记录程序变量参数传递信息等等 【默认日志】
logger.trace("trace"); //追踪信息,记录程序所有的流程信息
//再创建日志记录器
Logger logger1 = Logger.getLogger(Logger.class); //用的包是org.apache,对应配置文件中的第二个配置,而logger类是apache的
logger1.fatal("fatal logger1"); //严重的错误,造成系统奔溃,并终止程序
logger1.error("error logger1"); //错误信息,不会影响系统运行
logger1.warn("warn logger1"); //警告信息,可能会发生问题
logger1.info("info logger1"); //运行信息,数据库的连接,网络的连接等等
logger1.debug("debug logger1"); //调试信息,一般在开发中使用,记录程序变量参数传递信息等等 【默认日志】
logger1.trace("trace logger1"); //追踪信息,记录程序所有的流程信息
}
测试:logger1只输出了fatal和error,其余级别没有输出。