List icon 目录

日志记录

本指南描述了如何配置 JxBrowser 日志记录。

许多问题的根本原因可以通过分析 JxBrowser 日志消息来检测。

如果您看到问题或一些意外行为,请配置 JxBrowser 以将所有日志消息打印到文件或 System.err,重现问题,并向我们提供收集的日志消息。

默认情况下,JxBrowser 配置为将所有 ERROR 级别的日志消息打印到 System.err

级别

JxBrowser 支持以下日志级别:DEBUG < INFO < WARNING < ERROR。 默认情况下,库仅打印具有 ERROR 日志记录级别的消息,其余的将被忽略。

使用 OFF 级别可以完全关闭日志记录,而使用 ALL 级别可以记录所有消息。

您可以通过 jxbrowser.logging.level 系统属性或 JxBrowser Logging API 更改默认日志记录级别。

示例:设置日志记录级别

使用以下系统属性启用 DEBUG 日志记录:

-Djxbrowser.logging.level=DEBUG

或者在代码中进行配置:

Java
Kotlin
System.setProperty("jxbrowser.logging.level", "DEBUG");
System.setProperty("jxbrowser.logging.level", "DEBUG")

或者使用 JxBrowser Logging API:

Java
Kotlin
import com.teamdev.jxbrowser.logging.Level;
import com.teamdev.jxbrowser.logging.Logger;
...
Logger.level(Level.DEBUG);
import com.teamdev.jxbrowser.logging.Level
import com.teamdev.jxbrowser.logging.Logger
...
Logger.level(Level.DEBUG)

日志记录到文件

如果要将所有日志消息打印到文件,请使用 jxbrowser.logging.file 系统属性。

使用以下系统属性配置日志文件路径:

-Djxbrowser.logging.file=jxbrowser.log

或者在代码中进行配置:

Java
Kotlin
System.setProperty("jxbrowser.logging.file", "jxbrowser.log");
System.setProperty("jxbrowser.logging.file", "jxbrowser.log")

该属性的值可以是文件的绝对路径或相对路径。

如果库无法创建日志文件,它会回退到默认行为并打印一条错误消息,并将异常堆栈跟踪打印到 System.err