本教程旨在解决Eclipse E4 RCP应用中，使用日志封装类时无法准确获取实际调用者类信息的问题。文章将深入探讨传统方法的局限性，并提供一个基于Java 9 `StackWalker` API与Eclipse `ILog`接口的专业解决方案。通过此方法，日志输出将精确反映消息的来源类，显著提升日志的可读性和调试效率。
在Eclipse E4 RCP应用程序开发中，日志记录是不可或缺的一部分，它帮助开发者追踪程序行为、诊断问题。常见实践是创建一个统一的日志封装类，避免在每个需要记录日志的类中重复初始化日志实例。然而，当采用这种封装模式时，一个普遍的挑战是如何让日志系统准确地记录实际调用日志方法的类（而非封装类本身），从而在日志文件中清晰地标识消息来源。
传统日志封装的局限性
最初的尝试可能类似于以下结构：
import org.eclipse.e4.core.services.log.Logger;
import org.eclipse.ui.PlatformUI; // 注意：此API不适用于纯E4应用
class MyLoggerWrapper {
// 错误地尝试获取Logger实例，且org.eclipse.e4.core.services.log.Logger不适合终端用户直接使用
static Logger logger = PlatformUI.getWorkbench().getService(org.eclipse.e4.core.services.log.Logger.class);
public static void info(String message) {
logger.info(message);
}
}
class SomeClass {
public void doSomething() {
MyLoggerWrapper.info("执行了某些操作");
}
}当 SomeClass.doSomething() 调用 MyLoggerWrapper.info() 时，日志文件通常会显示 MyLoggerWrapper 或更底层的Eclipse日志组件作为消息来源，例如 [...][!MESSAGE 执行了某些操作]，而无法直接指出是 SomeClass 发出了这条日志。这使得在复杂的应用中追踪日志来源变得困难。
此外，需要注意的是，org.eclipse.e4.core.services.log.Logger 接口的Javadoc明确指出它不适用于最终用户直接使用。同时，PlatformUI 属于 org.eclipse.ui.xxx 插件，它主要用于基于Eclipse 3.x兼容层的RCP应用，对于纯粹的E4应用程序而言，不应直接依赖此类API。
推荐方案：结合 ILog 与 StackWalker
为了在E4 RCP应用中实现精确的日志调用者追踪，我们应该转向使用Eclipse平台提供的 ILog 接口，并通过Java 9及更高版本引入的 StackWalker API来动态获取调用者类。
ILog 接口可以通过 Platform.getLog() 方法获取，它是Eclipse平台推荐的日志接口。StackWalker 则提供了一种高效且标准化的方式来遍历当前线程的堆栈帧，从而获取调用链上的类信息。
下面是一个实现此功能的日志封装类示例：
import org.eclipse.core.runtime.ILog;
import org.eclipse.core.runtime.Platform;
/**
* 统一日志工具类，能够准确识别日志调用者。
* 适用于Eclipse E4 RCP应用，要求Java 9及以上版本。
*/
public final class LogUtil {
/**
* StackWalker实例，用于获取调用者类。
* 配置为保留类引用，以便直接获取Class对象。
*/
private static final StackWalker STACK_WALKER = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE);
/**
* 私有构造函数，防止实例化。
*/
private LogUtil() {
// 工具类无需实例化
}
/**
* 记录信息级别的日志。
* 日志将关联到实际调用此方法的类。
*
* @param message 日志消息
*/
public static void info(final String message) {
// 获取实际调用LogUtil.info()方法的类
final Class callerClass = STACK_WALKER.getCallerClass();
// 使用调用者类获取对应的ILog实例，并记录日志
Platform.getLog(callerClass).info(message);
}
/**
* 记录警告级别的日志。
*
* @param message 日志消息
*/
public static void warn(final String message) {
final Class callerClass = STACK_WALKER.getCallerClass();
Platform.getLog(callerClass).warn(message);
}
/**
* 记录错误级别的日志。
*
* @param message 日志消息
* @param exception 相关的异常对象
*/
public static void error(final String message, final Throwable exception) {
final Class callerClass = STACK_WALKER.getCallerClass();
Platform.getLog(callerClass).error(message, exception);
}
// 可以根据需要添加其他日志级别方法，如 debug, trace 等
}代码解析
-
STACK_WALKER 实例:
- StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE) 创建了一个 StackWalker 实例。RETAIN_CLASS_REFERENCE 选项是关键，它指示 StackWalker 在遍历堆栈时保留对 Class 对象的引用，这样我们就可以直接获取调用者的 Class 对象，而不是仅仅获取类名。
-
getCallerClass() 方法:
- 在 info、warn、error 等日志方法内部，STACK_WALKER.getCallerClass() 会返回调用当前方法的上一个堆栈帧对应的 Class 对象。例如，如果 SomeClass.doSomething() 调用了 LogUtil.info()，那么 getCallerClass() 将返回 SomeClass.class。
-
Platform.getLog(callerClass):
- Platform.getLog() 方法接受一个 Class 对象作为参数，它会根据这个类所在的插件ID来获取对应的 ILog 实例。这样，日志系统就能将日志消息正确地归属到 callerClass 所在的插件，并在日志文件中显示其名称。
如何使用
现在，任何类都可以通过 LogUtil 来记录日志，并且日志将准确地显示该类的名称：
import org.eclipse.core.runtime.ILog; // 引入ILog，但实际使用LogUtil封装
import org.eclipse.core.runtime.Platform;
public class MyService {
public void performAction() {
LogUtil.info("MyService 正在执行一个关键动作。");
try {
// 模拟一个可能抛出异常的操作
throw new IllegalArgumentException("无效的参数！");
} catch (IllegalArgumentException e) {
LogUtil.error("MyService 执行动作失败。", e);
}
}
}
// 在其他地方调用
public class ApplicationStartup {
public static void main(String[] args) {
// 假设这是一个E4应用启动流程的一部分
// 在E4应用中，通常通过DI获取服务，这里为简化示例直接创建
MyService service = new MyService();
service.performAction();
LogUtil.warn("应用程序启动时发现一些非关键警告。");
}
}当 MyService.performAction() 调用 LogUtil.info() 时，日志文件中将清晰地显示 MyService 作为日志来源。
注意事项
- Java版本要求: 此方案依赖于Java 9及以上版本提供的 StackWalker API。如果您的项目仍在使用Java 8或更早版本，则需要寻找其他基于堆栈跟踪（如 Thread.currentThread().getStackTrace()）的替代方案，但这些方案通常效率较低且使用不便。
- 性能考量: StackWalker 比传统的 Thread.currentThread().getStackTrace() 性能更高，但在高频日志场景下，获取堆栈信息仍会带来一定的开销。因此，建议在发布版本中合理配置日志级别，避免输出过多调试信息。
- E4上下文: 确保您的E4应用程序正确运行在Eclipse平台上，以便 Platform.getLog() 能够正常工作。
- 日志配置: Eclipse平台的日志输出行为可以通过 config.ini 或其他OSGi配置进行定制，例如设置日志文件的位置、大小和级别。
总结
通过巧妙地结合Java 9的 StackWalker API和Eclipse平台的 ILog 接口，我们可以构建一个强大且精确的日志封装工具。这个 LogUtil 类不仅简化了日志记录的代码，更重要的是，它解决了在E4 RCP应用中日志调用者信息丢失的问题，使得日志文件更具可读性、更易于分析和调试，从而显著提升了开发和维护效率。
