Eclipse/プラグイン開発のTIPS集/エラーログの制御

Eclipseにはエラー情報を表示するエラー・ログビューがありますが、そのビューの使い方です。

エラー・ログビュー

その詳細画面

使い方 †

このビューにエラー内容を表示するには以下の記述をすればよいようです。

IStatus status = new Status(IStatus.ERROR, SamplePlugin
        .getPluginId(),  IStatus.OK, "メッセージ", 
        new Exception("エラーメッセージ"));
SamplePlugin.getDefault().getLog().log(status);

2行目のlogメソッドが呼ばれたときに、与えられたstatus(IStatusの実装クラス)オブジェクトの内容をログに出力します。Statusオブジェクトはエラーなどの状況を格納したクラスです。コンストラクタの引数の意味は以下の通り。

/**
 * Creates a new status object.  The created status has no children.
 *
 * @param severity the severity; one of <code>OK</code>, <code>ERROR</code>, 
 * <code>INFO</code>, <code>WARNING</code>,  or <code>CANCEL</code>
 * @param pluginId the unique identifier of the relevant plug-in
 * @param code the plug-in-specific status code, or <code>OK</code>
 * @param message a human-readable message, localized to the
 *    current locale
 * @param exception a low-level exception, or <code>null</code> if not
 *    applicable 
 */
public Status(int severity, String pluginId, int code, 
              String message, Throwable exception)

さて、エラー・ログビューは重要度やメッセージなどの項目がありますが、各項目はStatusオブジェクトの値に対応してるみたいです。具体的には以下のような対応になっています。

• 重要度:Statusの第１引数。上の例だとIStatus.ERROR
• メッセージ:Statusの第４引数。上の例だと"メッセージ"
• プラグイン:Statusの第２引数。上の例だとSamplePlugin?.getPluginId?()
• 日付:ログ出力をした日付。
• 例外スタック・トレース:Statusの第５引数のstackTrace。上の例だとnew Exception("エラーメッセージ")のstackTraceです。
• セッション・データ:？？よくわかんなかったです。

このようにログに出力したい内容をStatusに格納してあげればよいわけですね。

MultiStatus?を使う †

MultiStatus?とは、複数のエラーを同時に扱う場合に使用するStatusの拡張クラスです。このクラスは内部に複数のStatusクラスを格納することができます。具体的なコードは以下の通り。

MultiStatus mStatus = new MultiStatus(SamplePlugin
        .getPluginId(), IStatus.OK, "マルチステータスのメッセージ",
        new Exception("マルチのエラーメッセージ"));
IStatus status = new Status(IStatus.ERROR, SamplePlugin
        .getPluginId(), IStatus.OK, "メッセージ１", new Exception(
        "エラーメッセージ１"));
mStatus.add(status);
status = new Status(IStatus.INFO, SamplePlugin.getPluginId(),
        IStatus.OK, "メッセージ２", new Exception("エラーメッセージ２"));
mStatus.add(status);
SamplePlugin.getDefault().getLog().log(mStatus);

この出力結果は以下のようになります。

次はエラーダイアログの制御を調べてみます。

この記事は

• RCPで使おうとすると、プラグインなんてカラムいらねぇ。消す制御ができればよいなあと思ったけど、Extendsして使うのかなぁ。 -- きの? 2006-08-13 08:55:10 (日)

現在のアクセス:17632