如何在 Eclipse 的Error Log 中显示自己的日志
开发任何软件都不得不处理 Exception 和 Log,Eclipse Plug-in 也是如此。不过幸运的是,Eclipse PDE 提供了记录及显示Exception和Log的机制:Error Log View。作为 Eclipse SDK 的一部分,PDE 的普及率很高,所以除非你是要做 RCP,不然的话用 Error Log View处理 Exception 和 Log 应该是你的最佳选择。当然,这也带来了对 PDE 的依赖性。
使用 Error Log View实际上非常简单,每个 Plug-in 的 Activator 类都有一个 getLog() 方法,返回一个 ILog 对象,这个对象就可以把 Exception 和 Log 记录到 Error Log View 中。ILog 对象最主要的方法就是 log 了,顾名思义,它接收一个 IStatus类型的对象,并把其代表的状态记录下来。Eclipse 和许多常用的插件(如JDT)实现了很多的 IStatus,最 common 的就是Status类,我们可以简单地使用它,或创建自己的 IStatus 实现。Status的构造函数有5个参数,具体如下:
?
package cn.cooperware.eclipse.utility; import org.eclipse.core.runtime.ILog; import org.eclipse.core.runtime.Status; import xxx.PluginActivator; public class EclipseErrorLog { private static ILog logger = null; static { logger = PluginActivator.getDefault().getLog(); } private EclipseErrorLog() { // nothing to do } public static void logCancel(String message, Throwable exception) { logger.log(new Status(Status.CANCEL, PluginActivator.PLUGIN_ID, Status.OK, message, exception)); } public static void logError(String message, Throwable exception) { logger.log(new Status(Status.ERROR, PluginActivator.PLUGIN_ID, Status.OK, message, exception)); } public static void logInfo(String message, Throwable exception) { logger.log(new Status(Status.INFO, PluginActivator.PLUGIN_ID, Status.OK, message, exception)); } public static void logOk(String message, Throwable exception) { logger.log(new Status(Status.OK, PluginActivator.PLUGIN_ID, Status.OK, message, exception)); } public static void logWarning(String message, Throwable exception) { logger.log(new Status(Status.WARNING, PluginActivator.PLUGIN_ID, Status.OK, message, exception)); } }?
?
除此之外,我们还可以通过 ILog 的 addLogListener 方法和 removeLogListener 方法为日志动作添加和删除事件监听器。这些Listener 可以帮助我们在日志记录完成后做一些额外的事情。例如,如果记录的是 ERROR 级别的 Log,那么我们可能要弹出一个Alert 对话框告诉用户出现了错误,但如果是 INFO 级别,就没这个必要了。
?
?
?
备注:
本来eclipse自带有默认日志的,但是由于RCP中有时候不能依赖PDE,所以还是自己单独实现一套跟log4j相关的,简单的日志处理视图。