SLF4J - 迁移器
如果您在 Jakarta Commons Logging (JCL) 或 log4j 或 java.util.logging (JUL) 中有一个项目,并且想要将这些项目转换为 SLF4J,则可以使用 SLF4J 发行版中提供的迁移器工具来执行此操作。
运行 SLF4J 迁移器
SLF4J 是一个简单的单个 jar 文件 (slf4j-migrator.jar),您可以使用 java –jar 命令运行它。
要运行它,请在命令提示符下浏览包含此 jar 文件的目录并执行以下命令。
java -jar slf4j-migrator-1.8.0-beta2.jar Starting SLF4J Migrator
这将启动迁移器,您可以看到一个独立的 java 应用程序:
根据窗口中的指定,您需要检查要执行的迁移类型并选择项目目录,然后单击“将项目迁移到 SLF4J”按钮。
该工具会转到您提供的源文件并执行简单的修改,例如将导入行和记录器声明从当前日志记录框架更改为 SLF4j。
例子
例如,假设我们在 Eclipse 中有一个示例log4j(2)项目,其中包含一个文件,如下所示 -
import org.apache.log4j.Logger; import java.io.*; import java.sql.SQLException; import java.util.*; public class Sample { /* Get actual class name to be printed on */ static Logger log = Logger.getLogger(Sample.class.getName()); public static void main(String[] args)throws IOException,SQLException { log.debug("Hello this is a debug message"); log.info("Hello this is an info message"); } }
要将示例log4j(2)项目迁移到 slf4j,我们需要选中从 log4j 到 slf4j的单选按钮,并选择项目的目录,然后单击退出进行迁移。
迁移者将上述代码更改如下。在这里,如果您观察到 import 和 logger 语句已被修改。
import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.*; import java.sql.SQLException; import java.util.*; public class Sample { static Logger log = LoggerFactory.getLogger(Sample.class.getName()); public static void main(String[] args)throws IOException,SQLException { log.debug("Hello this is a debug message"); log.info("Hello this is an info message"); } }
由于您的项目中已经有log4j.jar,因此需要将slf4j-api.jar和slf4jlog12.jar文件添加到项目中才能执行。
SLF4JMigrator 的局限性
以下是 SLF4J 迁移器的限制。
Migrator 不会修改 ant、maven 和 ivy 等构建脚本,您需要自己修改。
Migrator 不支持字符串类型以外的消息。
迁移器不支持 FATAL 级别。
使用 log4j 时,迁移器不会迁移对 PropertyConfigurator 或 DomConfigurator 的调用。