介绍
Log4j是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。
组成
Log4j由三个重要的组件构成:日志信息的优先级(Loggers),日志信息的输出目的地(Appenders),日志信息的输出格式(Layouts)。日志信息的优先级从高到低有ERROR、WARN、 INFO、DEBUG,分别用来指定这条日志信息的重要程度;日志信息的输出目的地指定了日志将打印到控制台还是文件中;而输出格式则控制了日志信息的显示内容。
Log4j支持两种配置文件格式,一种是XML格式的文件,一种是properties格式的文件。
需要的 jar:
第一种:commons-logging.jar 和 logging-log4j-1.2.9.jar
第二种:log4j-api-2.8.2.jar 和 log4j-core-2.8.2.jar(要求:jdk 1.7 以上)
配置 根Logger
语法 : log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来。
appenderName 就是指定日志信息输出到哪个地方,可以同时指定多个输出目的地。
配置日志信息输出目的地Appender,其语法为:
log4j.appender.appenderName = package+appender_class_name --> jar 包引用
可选用的值有:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
org.apache.log4j.jdbc.JDBCAppender(将日志写入数据库)
示例:
#根 Logger 级别设置
log4j.rootLogger=INFO, stdout , R
#输出到控制台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %p [%c] %m%n
#输出到文件
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
log4j.appender.R.DatePattern='.'yyyy-MM-dd
log4j.appender.R.File=F://logs/notify-subscription.log
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d - [%c] %m%n
log4j.appender.R.Append=true
说明:
1、log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 此句为定义名为stdout的输出端的layout是哪种类型,可以是
> org.apache.log4j.HTMLLayout(以HTML表格形式布局),
> org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
> org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
> org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
2、log4j.appender.stdout.layout.ConversionPattern 指定:如果使用pattern布局就要指定的打印信息的具体格式ConversionPattern。
3、log4j.appender.R.Append=true 默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
4、DatePattern=’.'yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下:
1)’.'yyyy-MM: 每月
2)’.'yyyy-ww: 每周
3)’.'yyyy-MM-dd: 每天
4)’.'yyyy-MM-dd-a: 每天两次
5)’.'yyyy-MM-dd-HH: 每小时
6)’.'yyyy-MM-dd-HH-mm: 每分钟
测试使用:
> 在 根目录下配置 log4j.properties 文件;
> 参考如:
import org.apache.log4j.LogManager;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
public class LoggerTest {
private static Logger logger = LogManager.getLogger(LoggerTest.class.getName());
public static void main(String[] args) {
PropertyConfigurator.configure("F://logs//config//log4j.properties"); // 供测试使用
logger.debug("111");
logger.info("提示hh");
logger.error("打印错误ss");
}
}