《SLF4J官方文档》SLF4J迁移工具

原文地址

SLF4J迁移者

SLF4J迁移者是一个很小的Java工具,用于将Java源文件从Jakata Commons Logging(JCL)迁移到SLF4J。它也能将文件从log4j迁移到SLF4J,或者从java.util.logging API到SLF4J。

SLF4J迁移者包括一个独立的jar文件,可以像独立运营的java应用一样运行。命令如下:

Java –jar slf4j-migrator-1.7.21.jar

一旦应用运行了,一个像下面的窗口会显示:

此应用的使用应该是一目了然的。请注意迁移工具只是原地替换java文件,这意味着将没有已修改文件的备份。在使用SLF4J迁移者前,你有义务备份你的文件。

限制

SLF4J迁移者作为一个简单的工具,用于帮你将使用JCL,log4j或JUL的项目文件迁移到SLF4J。它只能进行基本的转换步骤。本质上来说,它将替换适当的导入行(import lines)和日志器声明(logger declarations)。

MyClass是个使用JCL的简单类,替换前如下:

package some.package;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

public MyClass { 

 Log logger = LogFactory.getLog(MyClass.class);

 public void someMethod() {
 logger.info("Hello world");
 }
}

迁移后如下:

package some.package;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public MyClass { 

 Logger logger = LoggerFactory.getLogger(MyClass.class);

 public void someMethod() {
 logger.info("Hello world");
 }
}

尽管转换规则很基本,但SLF4J迁移者仍可以大大缓解java项目从JCL到SLF4J迁移的繁重工作。从log4j到SLF4J,或从JUL到SLF4J的迁移规则是类似的。

一般限制

•生成脚本不会被修改

您的Ant / Maven/Ivy生成脚本需要手动修改为使用SLF4J,而不是JCL或log4j。

•只有支持String类型的消息

如果您的日志声明的包含非字符串对象作为其唯一的参数,你将不得不在对象上手动添加一个toString()方法调用。

例如:

logger.debug(new Object());

已被手动重新写为

logger.debug(new Object().toString());

•不支持FATAL级别。

你必须将它们手动转换。 此限制不被视为非常严重的,因为通常有极少数的日志声明承载FATAL级别。

•如果一个方法声明在同一行的多个日志器,转换将是不完整的。 例:

public void someMethod(Log l1, Log l2) {
 ...
 }

will be converted as 

 public void someMethod(Log l1, Logger l2) {
 ...
 }

从log4j的迁移时限制

•NDC语句保持原样

由于NDC不支持SLF4J,迁移者不能正确处理NDC语句。 你必须手动进行迁移到MDC。 同样,因为通常很少NDC语句,即使在大型项目中此限制不被视为严重。

请注意,相反,NDC,因为SLF4J支持这样的语句MDC陈述正确迁移。

•调用PropertyConfigurator或DomConfigurator无法迁移,因为他们没有SLF4J对应项。

从JUL迁移时的限制

•java.util.logging.Logger调用finest() finer()或finest()方法都保留原样。

鉴于finest() finer()或finest()调用可以映射到两个trace()或debug()调用在SLF4J,不可能猜出用户希望如何这些调用映射。

•所有匹配的字符串“.severe(”会由字符串“.error(”替换,不带任何上下文分析。同样地,所有的字符串匹配“.warning(”是由“.warn(”所取代。

由于匹配/替换操作不是根据语境更改的,如果你的代码包含了一个名为”severe” 或 “warning”,,那么迁移的结果将具有编译错误的方法。 幸运的是,这样的错误应该是罕见的,易于识别的。

•在定义下面的方法调用java.util.logging.Logger类需要手动迁移:log,logp,logrb,entering,exiting。

 

原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: 《SLF4J官方文档》SLF4J迁移工具


司余

司余

积少成多, 聚沙成塔
司余

Latest posts by 司余 (see all)

FavoriteLoading添加本文到我的收藏
  • Trackback 关闭
  • 评论 (0)
  1. 暂无评论

您必须 登陆 后才能发表评论

return top