共通ロギング・サンプルの操作

このサンプルでは、Eclipse 環境における共通ロギング実装の使用を、 共通ロギング・サンプル・プラグインのレコードを記録することによって説明します。 Eclipse ログ・レコード (例えば、IStatus) および共通ベース・イベント・ログ・レコードを作成し、構成できます。 そして、Common.Logging.Logger ロギング・エージェント および Eclipse 共通ロギング XML ログ・ファイル (workspace/.metadata/CommonBaseEvents.xml) への 書き込み用として構成されたプラグインのロガーを介して、新規に作成したログ・レコードを記録できます。 Common.Logging.Logger ロギング・エージェントは、 Agent Controller のサービスまたはデーモンを使用することでワークベンチからモニターできます。

ワークスペースにサンプルを追加する手順は、次のとおりです。

  1. 「ファイル」>「新規」>「プロジェクト」を選択します。
  2. 新規プロジェクト・ウィザードで、「例 (Examples)」>「共通ロギング (Common Logging)」> 「共通ロギング・サンプル (Common Logging Sample)」を選択します。
  3. 次へ」をクリックして、プロジェクト名と位置を確認し、任意でそれらをデフォルトから変更します。
  4. 終了」をクリックする。

前提条件

このサンプルのコンパイルおよび実行には、JRE 1.4.0 以上が必要です。

このサンプルの実行には、以下の JAR ファイルが必要です。

JAR ファイル名 この JAR を含むプラグイン 必要である理由
com.ibm.etools.common.logging.jar com.ibm.etools.common.logging 共通ロギング実装
org.eclipse.emf.common.jar org.eclipse.emf.common 共通ベース・イベントの Eclipse Modeling Framework (EMF) への依存
org.eclipse.emf.ecore.jar org.eclipse.emf.ecore 共通ベース・イベントの Eclipse Modeling Framework (EMF) への依存
hexr.jar org.eclipse.hyades.execution TPTP ロギング・エージェントへの依存
hl14.jar org.eclipse.hyades.logging.core JSR-047 ロギング API の TPTP サポート
hlcbe101.jar org.eclipse.hyades.logging.core 共通ベース・イベント実装
hlcore.jar org.eclipse.hyades.logging.core 共通ベース・イベントの TPTP ロギング・コアへの依存
org.eclipse.core.runtime.jar org.eclipse.core.runtime Eclipse ロギング実装

サンプルの実行

このサンプルを実行する手順は、次のとおりです。

  1. ワークベンチのデフォルト JRE が、バージョン 1.4.0 以上でない場合は、 次の手順に従って新規に作成した Java プロジェクト (CommonLoggingProject) を変更し、 JRE 1.4.0 以上を使用してコンパイルおよび実行を行ないます。
    1. 「CommonLoggingProject」を選択し、右クリックして「プロパティー」を選択します。
    2. 「プロパティー」ダイアログで、「Java ビルド・パス」を選択します。
    3. 「ライブラリー (Libraries)」タブで、「JRE システム・ライブラリー (JRE System Library)」 を選択し、「除去」ボタンをクリックします。
    4. 新規 JRE を追加するには、「Add Library」ボタンをクリックします。
    5. 「Add Library」ダイアログで、リストから「JRE System Library」を選択して「次へ」をクリックします。
    6. Alternate JRE」オプションを選択し、「インストール済みの JRE」をクリックして、JRE を追加します。 「インストール済みの JRE」の設定ページが開きます。
    7. 追加」をクリックします。
    8. 「Add JRE」ダイアログで、JRE 1.4.0 の名前およびホーム・ディレクトリーを指定します。 「OK」をクリックする。
    9. OK」をクリックする。
    10. 終了」をクリックする。
    11. プロパティー・ダイアログで「OK」をクリックします。
  2. コンパイル・エラーがすべて修正されていることを確認します。
  3. 必要なプラグイン (前出) をワークベンチの検索パスに追加します。
  4. ワークベンチのランタイム・インスタンスを作成します。
    1. 「ウィンドウ」>「設定」を選択して「設定」ダイアログを開きます。
    2. 「Plug-in Development」>「Target Platform」を選択します。
    3. 再ロード (Reload)」ボタンをクリックします。
    4. OK」をクリックする。
    5. 実行」>「次を実行」> 「Eclipse アプリケーション (Eclipse Application)」と選択します。 ワークベンチの新規インスタンスが起動します。 この新規のインスタンスを使用して、次のステップを実行します。
  5. メインメニューから「共通ロギング・サンプル (Common Logging Sample)」> 「実行」と選択して、共通ロギング・サンプルを実行します。