在项目中我们必不可少需要打印日志,通过日志我们可以查看系统的运行状态是否正常,当程序出现异常的时候,我们也可以通过查看日志来定位问题的位置,给程序员的工作带来了极大的便利。
以下这边博客的内容是我从一位大神的博客中参考过来的。希望大家都有所收益。
import org.apache.log4j.*;
import test.log4j.bean.Person;
//by godtrue
public class UseLog4j {
//日志记录器
private static Logger LOGGER = LogManager.getLogger(UseLog4j.class);
//循环次数
private static long CYCLE = 102;
//程序入口——主函数
public static void main(String[]args){
long startTime = System.currentTimeMillis();
/**
* 使用自定义的log4j的环境配置
*/
/**
* 一:定义日志信息的格式化方式,Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下:
* 1)%t 用来输出生成该日志事件的线程的名称
* 2)%p 用于输出日志事件的优先级,即DEBUG,INFO,WARN,ERROR,FATAL
* 3)%r 用于输出从layout(布局)的构建到日志事件创建所经过的毫秒数
* 4)%c 用于输出日志事件的category(类别),通常就是所在类的全名
* 5)%F 用于输出被发出日志记录请求,其中的文件名
* 6)%d 用于输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:20017年02月18日 22:10:28,921
* 7)%L 用于输出日志事件的发生位置,即在代码中的行数。举例:10
* 8)%l 用于输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)
* 9)%% 用于输出%标志
* 10)%M 用于输出打印该条日志的方法名
* 11)%m 用于输出代码中指定的消息
* 12)%n 用于输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”
*
*
* 当我们运行程序后发现,因为输出的日志信息长短不一,所以对不齐,看起来不好看,那么有什么法子呢?log4j也发现这个问题,并且为我们提供了格式修饰符
* 格式修饰符:可以控制输出字段的最小字段宽度、最大字段宽度、字段对齐格式,如下所示:
* 序号 格式修饰符 对齐方式 最小宽度 最大宽度 备注(对%c来使用格式修饰符,所以改变的是类别名称)
*
* 1) %-20c 左对齐 20 none 用空格右垫,如果类别名称少于20个字符长
* 2) %20c 右对齐 20 none 用空格左垫,如果类别名称少于20个字符长
* 3) %.30c 左对齐 none 30 从开始截断,如果类别名称超过30个字符长
* 4) %-20.30c 左对齐 20 30 用空格右侧垫,如果类别名称短于20个字符。但是,如果类别名称长度超过30个字符,那么从开始截断。
* 5) %20.30c 右对齐 20 30 用空格左侧垫,如果类别名称短于20个字符。但是,如果类别名称长度超过30个字符,那么从开始截断。
*
*/
//试验,并查看日志格式化后的效果
//String pattern = "[1]%t - [2]%p - [3]%r - [4]%c - [5]%F - [6]%d - [7]%L - [8]%l - [9]%% - [10]%M - [11]%m[12]%n"; //运行程序看看,是不是我们期待的日志输出样子
//试验,并查看日志格式化后的效果
String pattern = "[1]%-10p - [2]%10p - [3]%.3p - [4]%-10.3p - [5]%10.3p 。 %n"; //运行程序看看,是不是我们期待的日志输出样子
/**
* 二:定义日志输出的风格样式,日志输出的风格主要有以下几种(通过官方文档我们会发现还有其他的):
* 1)org.apache.log4j.HTMLLayout(以HTML表格形式布局),
* 2)org.apache.log4j.PatternLayout(可以灵活地指定布局模式,这个在我的实际工作中是最常用的),
* 3)org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
* 4)org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
*/
Layout layout = new PatternLayout(pattern);
/**
* 三:定义日志输出的目的地,日志输出的目的地主要中以下几种(通过官方文档我们会发现还有好多种类的):
* 1)org.apache.log4j.ConsoleAppender(控制台),
* 2)org.apache.log4j.FileAppender(文件),
* 3)org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
* 4)org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件,这个在我的实际工作中也是最常用的),
* 5)org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
*/
Appender appender= new ConsoleAppender(layout);
//配置日志输出的定义,主要有三点:1:输出什么级别的日志信息,2:将日志信息输出到那里,3:输出的日志以什么格式展示
BasicConfigurator.configure(appender);
/**
* 日志输出的级别,主要有以下几种:
* 1)ALL 各级包括自定义级别。
* 2)TRACE 最详细的信息。一般这些信息只记录到日志文件中。自版本1.2.12[3]。
* 3)DEBUG 流经系统的详细信息。一般这些信息只记录到日志文件中。
* 4)INFO 令人感兴趣的运行时事件(启动/关闭)。一般这些信息将立即呈现在状态控制台上,因而要保守使用,并保持到最低限度。
* 5)WARN 使用已过时的API,API的滥用,潜在错误,其他不良的或意外的运行时的状况(但不一定是错误的)。一般这些信息将立即呈现在状态控制台上。
* 6)ERROR 其他运行时错误或意外情况。一般这些信息将立即呈现在状态控制台上。
* 7)FATAL 导致应用程序提前终止的严重错误。一般这些信息将立即呈现在状态控制台上。
* 8)OFF 最高级别,用于关闭日志记录。
*
* 日志的级别之间的大小关系如右所示:ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF
*/
for(int i=0;i<CYCLE;i++){
if(i<100){
try{
LOGGER.info(new Person("godtrue",100/i,'M'));//打印对象的信息
}catch(Exception e){
LOGGER.error(i+"岁的小孩还不存在嘛!");//打印对象的信息
}finally{
LOGGER.warn("现在大部分人的年龄都在0到100岁之间的!");//打印对象的信息
}
}else{
LOGGER.info("我是一棵树,我今年活了"+i+"岁!哈哈,我厉害吧!");//打印对象的信息
}
}
LOGGER.debug("此程序的运行时间是:"+(System.currentTimeMillis()-startTime));//打印程序运行的时间
}
}
结论
1)如果将上述代码中的注释全部去掉,你会发现这段代码其实是相当的简单的,注释是试验的时候添加上的,也是我想记住的知识点,它们就是使用log4j框架控制日志输出的方式了
2)上面的代码有以下几部分构成
2-1)控制日志信息输出格式的——pattern
2-2)控制日志信息输出样式的——layout
2-3)控制日志信息输出目的地的——appender
2-4)控制日志信息输出的——LOGGER,他可以调用不同级别的日志输出方法,然后根据配置的日志输出级别来控制什么方法会被调用,这个后面会再次讲到的
3)无论是通过配置文件控制,还是通过程序本身控制,我们想控制的基本是 2) 所描述的这些部分,这些功能也是一个日志框架提供的最基本的功能