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

概要

このサンプルでは、共通ロギング・サンプル・プラグイン内のレコードを記録することによって、 Eclipse 環境での共通ロギング戦略実装の使用法を示します。 ユーザーは、Eclipse ログ・レコード (IStatus など) と共通ベース・イベント・ログ・レコードの作成および構成を体験し、 さらに共通ロギング・ロガー のロギング・エージェントおよび Eclipse 共通ロギング XML ログ・ファイル (<workspace>/.metadata/CommonBaseEvent.log) への書き込み用に構成されたプラグインのロガーを使用した新規作成ログ・レコードのロギングを体験します。 共通ロギング・ロガー のロギング・エージェントは、Data Collection Engine サービスまたはデーモンと Hyades ワークベンチを使用してモニターできます。


内容

このサンプルの内容には、Eclipse 環境での共通ロギング戦略実装の使用法を実演するために必要な Java ソース・コードおよび依存関係が含まれています。


要件

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

前提事項
  1. <workspace> は、ワークベンチのワークスペースの絶対パスを表します。

依存関係

このサンプルを実行するには、表にリストされた JAR ファイルが必要です。

JAR ファイル ファイルが含まれるプラグイン 要件である理由
logging.jar com.ibm.etools.common.logging 共通ロギング・インプリメンテーション
hlcore.jar org.eclipse.hyades.logging.core 共通ベース・イベントの Hyades ロギング・コアの依存関係
hlcbe101.jar org.eclipse.hyades.logging.core 共通ベース・イベントの実装
ecore.jar org.eclipse.emf.ecore 共通ベース・イベントの Eclipse モデリング・フレームワーク (EMF) の依存関係
common.jar org.eclipse.emf.common 共通ベース・イベントの Eclipse モデリング・フレームワーク (EMF) の依存関係
hexcore.jar org.eclipse.hyades.execution.core Hyades ロギング・エージェント
hexr.jar org.eclipse.hyades.execution.remote Hyades ロギング・エージェントの依存関係
hexl.jar org.eclipse.hyades.execution.local Hyades ロギング・エージェントの依存関係
hl14.jar org.eclipse.hyades.logging.java14 JSR-047 ロギング API の Hyades サポート

実行ステップ

このサンプルを実行するには、以下のステップを行います。
  1. ワークベンチのデフォルト JRE が 1.4.0 以上でない場合は、JRE 1.4.0 以上を使用してコンパイルおよび実行するために、新しく作成された Java プロジェクト (つまり CommonLoggingProject) を変更します。
    1. CommonLoggingProject を選択して右クリックし、「プロパティー」を選択します。
    2. プロパティー・ダイアログで、左側のリストから「Java のビルド・パス」を選択します。
    3. 「ライブラリー」タブで、「JRE_LIB」を選択し、「除去」ボタンをクリックします。
    4. 新しい JRE を追加するには、「ライブラリーの追加」ボタンをクリックします。
    5. ライブラリーの追加」ダイアログで、リストから「JRE システム・ライブラリー」を選択し、「次へ」をクリックします。
    6. 代替 JRE」オプションを選択し、「インストール済みの JRE」をクリックして JRE を追加します。インストール済みの Java ランタイム環境の設定ダイアログが開きます。
    7. 「追加」をクリックします。
    8. 「JRE の追加」ダイアログで、JRE 1.4.0 の名前とホーム・ディレクトリーを指定します。「OK」をクリックします。
    9. OK」をクリックします。
    10. 「終了」をクリックします。
    11. プロパティー・ダイアログで「OK」をクリックします。
  2. すべてのコンパイル・エラーが修正されていることを確認します。
  3. このサンプルを実行する前に、必須プラグインをワークベンチの検索パスに追加し、ワークベンチのランタイム・インスタンスを作成します。
  4. 共通ロギング・サンプル」>「実行」またはツールバー・ボタンの緑の丸いアイコンを選択して共通ロギング・サンプルのファイル・メニューを選択し、共通ロギング・サンプルを実行します。