1.JUL的好处
package JUL;
import com.sun.tools.javac.Main;
import java.util.logging.Logger;
public class test {
public static void main(String[] args) {
// 首先获取日志打印器
Logger logger = Logger.getLogger(Main.class.getName());
// 调用info来输出一个普通的信息,直接填写字符串即可
logger.info("我是普通的日志");
}
}
Logger.getLogger()
方法的参数通常是一个表示类的名称的字符串。这个字符串通常通过调用类的 getName()
方法获得
从上面的例子我们可以看出日志可以打印更加详细的信息。相较于sout,我们可以更容易地知道调试的详细信息。
2.日志的级别
日志分为7个级别,详细信息我们可以在Level类中查看:
- SEVERE(最高值)- 一般用于代表严重错误
- WARNING - 一般用于表示某些警告,但是不足以判断为错误
- INFO (默认级别) - 常规消息
- CONFIG
- FINE
- FINER
- FINEST(最低值)
当日志的级别低于默认值的时候,日志内容将不会打印到控制台上。
当我们在现实生活里开发程序的时候,在开发环境中,我们可能希望尽可能多地看到调试信息,但当程序上线的时候,我们只希望看到最关键的信息。这时候我们只需要调整日志的默认级别就可以了。
我们可以设定日志的级别:
logger.info("我是普通的日志");
logger.log(Level.SEVERE, "严重的错误", new IOException("我就是错误"));
logger.log(Level.WARNING, "警告的内容");
logger.log(Level.INFO, "普通的信息");
logger.log(Level.CONFIG, "级别低于普通信息");
我们发现,级别低于默认级别的日志信息,无法输出到控制台,我们可以通过设置来修改日志的打印级别:
//修改日志级别
logger.setLevel(Level.CONFIG);
//不使用父日志处理器
logger.setUseParentHandlers(false);
//使用自定义日志处理器
ConsoleHandler handler = new ConsoleHandler();
handler.setLevel(Level.CONFIG);
logger.addHandler(handler);
logger.log(Level.SEVERE, "严重的错误", new IOException("我就是错误"));
logger.log(Level.WARNING, "警告的内容");
logger.log(Level.INFO, "普通的信息");
logger.log(Level.CONFIG, "级别低于普通信息");
此时,级别比较低的“配置”logger也打印出来了。
注意,
logger.setUseParentHandlers(false);
这行代码表示禁用 Logger 对象的父处理器。
在Java的日志系统中,Logger 对象可以有一个父 Logger,它通常是由日志系统的配置确定的。父 Logger 负责将日志消息传递给其处理器(handlers)。也就是说父logger通过预设的配置文件指定子logger向哪里输出日志。
通过调用 setUseParentHandlers(false)
,你告诉 Logger 对象不要使用其父 Logger 的处理器。这意味着,该 Logger 将不再将日志消息传递给其父处理器所指定的目标。相反,你可以在该 Logger 上设置自己的处理器,或者让该 Logger 不输出日志信息到任何目标。
这通常用于在特定的 Logger 上自定义日志处理方式,而不受其父 Logger 的影响。例如,如果你希望某个特定的 Logger 只输出日志到文件而不是控制台,你可以禁用其父处理器,然后添加一个文件处理器。
在上面这个例子里,我们添加了我们自己的handler,更改了默认的输出位置。在创建handler之后,也要增加一个 handler.setLevel(Level.CONFIG);
一个日志语句,首先级别要高于logger的默认级别,然后还要高于handler的默认级别,才会被打印出来。
每个Logger
都有一个父日志打印器,我们可以通过getParent()
来获取:
public static void main(String[] args) throws IOException {
Logger logger = Logger.getLogger(Main.class.getName());
System.out.println(logger.getParent().getClass());
}
我们发现,得到的是java.util.logging.LogManager$RootLogger
这个类,它默认使用的是ConsoleHandler,且日志级别为INFO。
3.向文件中打印日志
//添加输出到本地文件
FileHandler fileHandler = new FileHandler("test.log");
fileHandler.setLevel(Level.WARNING);
logger.addHandler(fileHandler);
注意,这个时候就有两个日志处理器了,因此日志会打印到控制台和.log文件里。打印在.log文件里的格式默认为xml,我们也可以设定其他的格式。比如我们控制台处理器就默认使用的是SimpleFormatter
,而文件处理器则是使用的XMLFormatter
,我们可以自定义:
//使用自定义日志处理器(控制台)
ConsoleHandler handler = new ConsoleHandler();
handler.setLevel(Level.CONFIG);
handler.setFormatter(new XMLFormatter());
logger.addHandler(handler);
当我们每次重新启动这个类的时候,原来的日志文件内容会被覆盖,如果我们不想被覆盖,只需要FileHandler加上一个参数:FileHandler fileHandler = new FileHandler("test.log",ture);
4.日志的过滤器
日志可以设置过滤器,如果我们不希望某些日志信息被输出,我们可以配置过滤规则:
package JUL;
import com.sun.tools.javac.Main;
import java.io.IOException;
import java.util.logging.Level;
import java.util.logging.Logger;
public class LogFilter {
public static void main(String[] args) throws IOException {
// 获取 Logger 对象,与 Main 类相关联
Logger logger = Logger.getLogger(Main.class.getName());
// 自定义过滤规则,只记录消息不包含"普通"的日志记录
logger.setFilter(record -> !record.getMessage().contains("普通"));
// 记录严重级别的日志,附带异常信息
logger.log(Level.SEVERE, "严重的错误", new IOException("我就是错误"));
// 记录警告级别的日志
logger.log(Level.WARNING, "警告的内容");
// 记录信息级别的日志,由于过滤规则,不会记录包含"普通"的日志信息
logger.log(Level.INFO, "普通的信息");
}
}
整个日志的输出流程如下: