本文旨在解决eclipse e4 rcp应用中，构建集中式日志系统时无法准确识别日志调用来源类的问题。针对直接使用`org.eclipse.e4.core.services.log.logger`和`platformui`的局限，本教程推荐采用`platform.getlog()`获取`ilog`接口，并利用java 9及以上版本提供的`stackwalker`机制，动态捕获调用者的类信息，从而在日志输出中清晰地展现原始调用位置，显著提升日志的可追溯性和调试效率。
在开发大型或模块化的Eclipse E4 RCP应用程序时，为了保持代码的整洁性和一致性，通常会倾向于构建一个集中式的日志工具类。然而，这种做法的一个常见挑战是，当日志消息通过这个工具类发出时，日志系统往往会将工具类本身记录为消息的来源，而非实际调用日志方法的原始类。这会大大降低日志的有用性，因为无法快速定位问题发生的具体业务代码位置。
许多开发者可能会尝试创建一个静态的日志工具类，并在其中封装org.eclipse.e4.core.services.log.Logger的实例，如下所示：
import org.eclipse.e4.core.services.log.Logger;
import org.eclipse.ui.PlatformUI; // 注意：此为SWT/JFace/Workbench API
class A {
// 这种获取Logger的方式在纯E4应用中不推荐
static Logger logger = PlatformUI.getWorkbench().getService(org.eclipse.e4.core.services.log.Logger.class);
public static void info(String message) {
logger.info(message);
}
}
class B {
public void doSomething() {
A.info("Foobar");
}
}当B类调用A.info("Foobar")时，日志文件可能会显示类似[...]<PackageOfA>!MESSAGE Foobar，或者更糟糕的是，显示org.eclipse.e4.ui.workbench作为来源。这主要有以下几个原因：
为了在E4 RCP应用中实现一个既集中又能够准确识别调用者的日志系统，我们应该遵循E4推荐的日志接口，并利用Java 9及以上版本提供的StackWalker机制来动态获取调用者的类信息。
在Eclipse RCP/OSGi环境中，推荐的日志接口是org.eclipse.core.runtime.ILog，可以通过org.eclipse.core.runtime.Platform.getLog()方法获取。Platform.getLog()可以接受一个Bundle对象或一个Class对象作为参数，这样日志系统就可以知道日志消息是来自哪个插件或哪个类。
StackWalker是Java 9引入的一个强大API，用于高效地遍历和检查当前线程的调用堆栈。它比传统的Thread.currentThread().getStackTrace()方法更高效，并且提供了更灵活的过滤和访问堆栈帧的方式。其中，StackWalker.getCallerClass()方法可以直接获取到当前方法调用者的Class对象。
结合ILog和StackWalker，我们可以构建一个简洁高效的日志工具类：
import org.eclipse.core.runtime.ILog;
import org.eclipse.core.runtime.Platform;
/**
* 集中式日志工具类，能够准确识别日志调用者。
* 要求 Java 9 或更高版本。
*/
public final class Log {
/**
* 用于获取调用者的StackWalker实例。
* 配置为保留类引用，以便直接获取Class对象。
*/
private static final StackWalker STACK_WALKER =
StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE);
// 私有构造函数，防止实例化
private Log() {
// 工具类无需实例化
}
/**
* 记录信息级别的日志消息。
*
* @param msg 要记录的日志消息。
*/
public static void info(final String msg) {
// 获取实际调用Log.info()方法的类
final Class<?> callerClass = STACK_WALKER.getCallerClass();
// 使用调用者类获取对应的ILog实例，确保日志系统能识别来源
final ILog logger = Platform.getLog(callerClass);
// 记录日志
logger.info(msg);
}
/**
* 记录警告级别的日志消息。
*
* @param msg 要记录的日志消息。
*/
public static void warn(final String msg) {
final Class<?> callerClass = STACK_WALKER.getCallerClass();
final ILog logger = Platform.getLog(callerClass);
logger.warn(msg);
}
/**
* 记录错误级别的日志消息。
*
* @param msg 要记录的日志消息。
* @param throwable 相关的异常。
*/
public static void error(final String msg, final Throwable throwable) {
final Class<?> callerClass = STACK_WALKER.getCallerClass();
final ILog logger = Platform.getLog(callerClass);
logger.error(msg, throwable);
}
// 可以根据需要添加其他日志级别的方法，如 debug, trace 等
}在您的应用程序代码中，只需像往常一样调用这个Log工具类的方法即可：
// 假设这是您的一个业务类
package com.example.myapp.core;
import com.example.myapp.util.Log; // 导入您的日志工具类
public class MyService {
public void performTask(String data) {
Log.info("开始执行任务，数据: " + data);
try {
// 模拟一些操作
if (data == null || data.isEmpty()) {
throw new IllegalArgumentException("输入数据不能为空");
}
// ... 业务逻辑 ...
Log.info("任务执行成功。");
} catch (Exception e) {
Log.error("任务执行失败！", e);
}
}
}当MyService.performTask()方法调用Log.info()或Log.error()时，StackWalker.getCallerClass()将准确地返回com.example.myapp.core.MyService.class。这样，Platform.getLog(callerClass)就能获取到与MyService类所属的Bundle相关的ILog实例，从而在日志输出中正确地标记出MyService作为消息的来源。
通过采用E4 RCP推荐的ILog接口并结合Java 9+的StackWalker机制，我们可以构建一个既符合平台规范，又能有效解决日志来源识别问题的集中式日志系统。这种方法不仅提升了日志的可读性和可追溯性，也促进了代码的专业性和可维护性，是现代Eclipse E4 RCP应用中日志管理的一个高效实践。
以上就是在 Eclipse E4 RCP 中构建可识别调用者的专业日志系统的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
435
收藏
