![[きのさいと]](image/kinosite.png "[きのさいと]"){kind=small}
エラーログの制御 で、エラーが発生したときのロギング、またそのログを表示するためのエラー・ログビューについて書きました。次はエラーをユーザに通知するエラーダイアログ機能を調べてみました。
EclipseはStatusオブジェクトを使用したエラーダイアログ表示機能があります。エラーダイアログは、
org.eclipse.jface.dialogs.ErrorDialog
というクラスを用います。
やり方は簡単で、エラーログの制御で出てきたMultiStatusのオブジェクトを使って、以下のようにErrorDialog#openError を呼び出します。
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);
Shell shell = getSite().getWorkbenchWindow().getShell();
ErrorDialog.openError(shell, null, null, mStatus); <-ダイアログ表示処理
そうすると以下のようなエラーダイアログが表示されます。
更にこのダイアログには詳細ボタンがあり、それをクリックすると以下の画面が表示されます。
メイン部分の「マルチステータスのメッセージ」は、MultiStatusの第３引数の文字列、詳細部分のメッセージは、
MutliStatusクラスの例外クラスのメッセージ |--- MutliStatusのなかの１個目のStatusクラスの第３引数の文字列 |--- MutliStatusのなかの１個目のStatusクラスの例外クラスのメッセージ |--- MutliStatusのなかの２個目のStatusクラスの第３引数の文字列 |--- MutliStatusのなかの２個目のStatusクラスの例外クラスのメッセージ |--- ......
となります。
ErrorDialog.openError(shell, null, null, mStatus);
のnullの箇所に文字を設定することで、ちょっとですが表示を変更することができます。
また、もろもろのStatusクラスの引数のうち、例外クラスを受け取る箇所をnullにしてみると、こんな感じになります。
このやり方でやれば例外が発生していなくても、ユーザ通知に使うことができそうですね。例外を全てnullにして、MultuStatus内のStatusもERRORでなくて全てINFOとしてみます。コーディングは以下の感じですね。
MultiStatus mStatus = new MultiStatus(SamplePlugin
.getPluginId(), IStatus.OK, "マルチステータスのメッセージ", null);
IStatus status = new Status(IStatus.INFO, SamplePlugin
.getPluginId(), IStatus.OK, "メッセージ１", null);
mStatus.add(status);
status = new Status(IStatus.INFO, SamplePlugin.getPluginId(),
IStatus.OK, "メッセージ２", null);
mStatus.add(status);
Shell shell = getSite().getWorkbenchWindow().getShell();
ErrorDialog.openError(shell, "完了しました", "処理が完了しました。", mStatus);
そうするとこのようなダイアログが表示されました。
ErrorDialogってのが気になりますが、処理が完了しました、とか普通の通知にも使えそうです。
流れでMultiStatusを先にやりましたが、普通のStatusの場合ももちろん使えます。
IStatus status = new Status(IStatus.ERROR, SamplePlugin
.getPluginId(), IStatus.OK, "メッセージ１", new Exception(
"エラーメッセージ１"));
Shell shell = getSite().getWorkbenchWindow().getShell();
ErrorDialog.openError(shell, null, null, status);
エラー画面はこんな感じ。
予想通りって感じですが、
IStatus status = new Status(IStatus.ERROR, SamplePlugin
.getPluginId(), IStatus.OK, "メッセージ１", null);
ErrorDialog.openError(shell, null, null, status);
というように例外を渡さないと、詳細ボタンと詳細を表示する領域は現れませんでした。
ただ、MultiStatusを使用した場合はどうしても詳細領域がでちゃいますね。ダメ元で
MultiStatus mStatus = new MultiStatus(SamplePlugin
.getPluginId(), IStatus.OK, "マルチステータスのメッセージ", null);
IStatus status = new Status(IStatus.ERROR, SamplePlugin
.getPluginId(), IStatus.OK, null, null);
mStatus.add(status);
とかやったら、nullはダメだって例外が発生しちゃいました。
この記事は
現在のアクセス:16741
errorStatus.png 1255件
[詳細]
error03.png 1314件
[詳細]
error02.png 1390件
[詳細]
noDetail.png 1304件
[詳細]
info.png 1242件
[詳細]
error01.png 1388件
[詳細]
error04.png 1334件
[詳細]
