ナビゲーションをスキップ

eDocs ホーム > BEA WebLogic Server 8.1 ドキュメント > インターナショナライゼーション ガイド > BEA WebLogic Server メッセージ エディタの使い方

インターナショナライゼーション ガイド

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

BEA WebLogic Server メッセージ エディタの使い方

以下の節では、メッセージ エディタの使用方法について説明します。

 

メッセージ エディタの概要

メッセージ エディタは、XML メッセージ カタログの作成、読み込み、および書き込みに使用するグラフィカル インタフェース ツールです。メッセージ エディタは、WebLogic Server のインストール時にインストールされます。必要に応じて、XML カタログはテキスト エディタまたは任意の XML 編集ツールで直接編集することもできます。

注意 : WebLogic Server には独自のメッセージ カタログがあり、WebLogic Server のサブシステムおよび機能に関連するメッセージが含まれます。これらのカタログは、編集できません。WebLogic Server のカタログの詳細については、『範囲別メッセージ索引』を参照してください。

注意 : メッセージ エディタは、ローカライズされたカタログの編集はサポートしていません。

メッセージ エディタで可能な作業は以下のとおりです。

 

メッセージ エディタの起動

メッセージ エディタを起動する前に、WebLogic Server システムをインストール、コンフィグレーションし、環境変数 (setExamplesEnv.cmd) を設定します。また、クラスパスの設定が正しいことを確認してください。詳細については、『インストール ガイド』を参照してください。

サンプルのメッセージ カタログ ファイルは、SAMPLES_HOME/server/examples/i18n/msgcat/ ディレクトリにあります。

このサンプルのメッセージ カタログをテンプレートとして使用し、独自のメッセージを作成できます。パッケージ名、クラス名などの与えられた情報を変更するだけです。次に、メッセージ テキストを翻訳し、カタログを保存します。詳細については、『WebLogic Server ロギング サービスの使い方』の「WebLogic Server ログへのメッセージの書き込み」を参照してください。

注意 : samples/ ディレクトリ パスの場所は、WebLogic Server のインストール先によって異なる場合があります。

メッセージ エディタを起動するには、次のように入力します。

java weblogic.MsgEditor
または
java weblogic.i18ntools.gui.MessageEditor

基本的なコマンドライン ヘルプにアクセスするには、次のコマンドを入力します。

java weblogic.MsgEditor -help

ログ メッセージ用の WebLogic メッセージ エディタのメイン ウィンドウは、 図 3-1 のようになります。

図 3-1 ログ メッセージ用 WebLogic メッセージ エディタ

ログ メッセージ用 WebLogic メッセージ エディタ


 

 

カタログに関する作業

以下の節では、メッセージ エディタをカタログ管理に使用する方法について説明します。

既存のカタログの参照

WebLogic メッセージ エディタのメイン ウィンドウから、既存のカタログを検索するには、[メッセージ カタログ] フィールドに絶対パス名を入力するか、[参照] をクリックして [開く] ダイアログから既存のカタログに移動します。

図 3-2 カタログへのアクセス

カタログへのアクセス


 

WebLogic Server のインストールに付属しているサンプル カタログは、SAMPLES_HOME/server/examples/i18n/msgcat/ ディレクトリにあります。

注意 : このディレクトリ パスは、WebLogic Server のインストール先によって異なる場合があります。

ユーザ定義のカタログは、任意のディレクトリを指定して配置できます。

配置すると、そのカタログのパッケージ、サブシステム、バージョン、および開始 ID と終了 ID (ある場合) が表示され、そのカタログが、他のすべてのアクションが実行されるコンテキスト カタログになります。この時点で、カタログでは、新しいメッセージの入力、既存のメッセージの編集、メッセージの検索、またはすべてのメッセージの表示を行うことができます。

[メッセージ カタログ] フィールドで、ログ メッセージ カタログが選択された場合、図 3-3 に示されているようなログ メッセージ用の WebLogic メッセージ エディタ ウィンドウが表示されます。

図 3-3 ログ メッセージ用 WebLogic メッセージ エディタ

ログ メッセージ用 WebLogic メッセージ エディタ


 

[メッセージ カタログ] フィールドで、シンプル メッセージ カタログが選択された場合、図 3-4 に示されているようなシンプル メッセージ用の WebLogic メッセージ エディタ ウィンドウが表示されます。

図 3-4 シンプル メッセージ用 WebLogic メッセージ エディタ

シンプル メッセージ用 WebLogic メッセージ エディタ


 

新規カタログの作成

新規カタログを作成するには、次の手順に従います。

  1. WebLogic メッセージ エディタ ウィンドウのメイン メニュー バーから [ファイル｜新しいカタログの開始] を選択します。

    2. 図 3-5 に示されているように、[新しいカタログを作成] ダイアログが表示されます。

    図 3-5 [新しいカタログを作成] ダイアログ

    [新しいカタログを作成] ダイアログ


     
  2. [メッセージ カタログ] フィールドに、新規カタログ (拡張子 xml を含むファイル) の絶対パス名と名前を入力します。 または、[参照] をクリックして、適切なカタログ ディレクトリに移動します (WebLogic Server のサンプル メッセージを使用している場合は、msgcat ディレクトリに移動します)。
  3. [カタログ タイプ] ドロップダウン リストを使用して、作成するカタログが、ログ メッセージ (Log messages) カタログ、シンプル テキスト メッセージ (Simple messages) カタログのいずれかを指定します。

    4. ログ メッセージ カタログを選択した場合は、[開始 ID] および [終了 ID] フィールドが表示されます。この 2 つのフィールドは、カタログ内のメッセージに使用する ID 番号の範囲を指定するものです。シンプル テキスト メッセージ カタログを選択した場合は、これらのフィールドは表示されません。

  4. 生成された Logger クラスを入れるパッケージの名前を [I18n パッケージ] フィールドに入力します。デフォルト値は weblogic.i18n です。Logger クラスをアプリケーションと共に別のパッケージに入れたい場合は、ここでそのパッケージ名を指定します。
  5. カタログ データを入れるパッケージの名前を [L10n パッケージ] フィールドに入力します。デフォルト値は weblogic.l10n です。カタログ データをアプリケーションと共に別のパッケージに入れる場合は、ここでそのパッケージ名を指定します。
  6. [サブシステム] フィールドに、メッセージをログに記録するシステムの部分を示す名前を入力します。この名前がメッセージと共にログに書き込まれます。アプリケーションの場合、通常、[サブシステム] フィールドにはそのアプリケーション名が入ります。
  7. [プレフィックス] フィールドに、ログに記録されるときにメッセージ ID の先頭に追加するプレフィックスを入力します。デフォルトのサーバ メッセージのプレフィックスは、BEA です。ユーザ メッセージに、任意のプレフィックスを入力できます (プレフィックスは、10 文字未満にするようにお勧めします。また、標準的な Java 命名規約を使用します)。
  8. [カタログを作成] をクリックします。

    9. [新しいカタログを作成] ダイアログが閉じ、今作成したカタログが、メッセージ エディタのメイン ウィンドウにコンテキスト カタログとして表示されます。

 

カタログへのメッセージの追加

以下の節では、メッセージ エディタを使用してカタログにメッセージを追加する方法について説明します。

新規ログ メッセージの入力

ログ カタログに新規メッセージを入力するには、以下の手順に従います。

  1. WebLogic メッセージ エディタのメイン ダイアログ (図 3-6) で、[メッセージ カタログ] フィールドに絶対パス名を入力するか、[参照] をクリックして既存のカタログに移動します。

    2. 図 3-6 ログ メッセージ

    ログ メッセージ


     
  2. [次の ID を取得] ボタンをクリックして、コンテキスト カタログ内でユニークな次の ID を生成します。この ID は、[メッセージ ID] フィールドに表示されます。
  3. メッセージに関連するコメントを、[コメント] フィールドに入力します。
  4. 括弧と引数も含めて、ログ メッセージに使用する適切なメソッドを入力します。例 : logErrorSavingTimestamps(Exception ioExcep)
  5. ログ メッセージのメソッド タイプを設定します。 logger または getter を指定します。デフォルトのメソッド タイプは logger で、ログとして記録されるメッセージに使用します。getter は、例外など、ログとして記録しないメッセージに使用する場合に選択します。
  6. リストから重大度を選択します。
  7. [メッセージ本文] にテキストを入力します。 パラメータは {n} で示します。例 : "Exception occurred while loading _WL_TIMESTAMP FILE."
  8. [メッセージ詳細] にテキストを入力します。パラメータは {n} で示します。例 : "Exception occurred while loading _WL_TIMESTAMP FILE. Forcing recompilation: {0}."
  9. [妥当な原因] にテキストを入力します。パラメータは {n} で示します。例 : "There was an error reading this file."
  10. [アクション] にテキストを入力します。パラメータは {n} で示します。例 : "No action required."
  11. チェックマーク ボックスをクリックして、[スタック トレースを表示] オプションのオン、オフを切り替えます。このオプションは、Logger メソッドが例外を引数として取る場合に、メッセージと共にスタックトレースを出力するときに使用します。
  12. チェックマーク ボックスをクリックして、[廃止されたメッセージ] オプションのオン、オフを切り替えます。使用しなくなったメッセージを廃止 (非表示に) するには、このオプションを使用します。廃止されたメッセージは、生成されたクラスに表示されないという観点では削除されます。ただし、メッセージ データは、.xml ファイルに残ります。
  13. [追加] をクリックします。

    14. メッセージが追加されると、カタログ全体がただちにディスクに書き込まれます。

新規シンプル テキスト メッセージの入力

シンプル メッセージ カタログにシンプル テキスト メッセージを入力するには、次の手順に従います。

  1. WebLogic メッセージ エディタのメイン ダイアログで、[メッセージ カタログ] フィールドに絶対パス名を入力するか、[参照] をクリックして既存のカタログに移動します。

    2. 図 3-7 に示されているようなシンプル メッセージ用の WebLogic メッセージ エディタのメイン ウィンドウが表示されます。

    図 3-7 シンプル メッセージ用ウィンドウ

    シンプル メッセージ


     
  2. ユニークな英数字のメッセージ ID を入力します。
  3. 必要に応じて、コメントを入力します。
  4. 括弧と引数も含めて、シンプル メッセージに使用する適切なメソッドを入力します。例 : startingClusterService()
  5. メッセージ本文を入力します。例 : startingClusterService
  6. [追加] をクリックします。

    7. メッセージが追加されると、カタログ全体がただちにディスクに書き込まれます。

 

メッセージの検索

以下の節では、メッセージ エディタをメッセージ検索に使用する方法について説明します。

ログ メッセージの検索

ログ メッセージを検索するには、次の手順に従います。

  1. コンテキスト カタログがログ メッセージ カタログであること、図 3-3 に示されているように WebLogic メッセージ エディタのログ メッセージのメイン ウィンドウが表示されていることを確認します。
  2. メイン メニュー バーから [編集] を選択します。
  3. [検索] を選択して、図 3-8 に示すような [ログ メッセージを検索] ダイアログを表示します。

    4. 図 3-8 ログ メッセージの検索

    ログ メッセージの検索


     
  4. メッセージ ID およびメソッド名を入力します。
  5. [メッセージ テキスト検索] に、求めるメッセージの検索データを必要なだけ入力します。テキストの検索では、テキスト フィールドに入力されたすべての内容について部分一致検索が行われます。
  6. [先頭から検索] または [次を検索] をクリックします。

    7. メッセージの検索は、フィールドの情報をつなぎ合わせて実行されます。一致するメッセージが見つかると、図 3-1 に示されているように、そのメッセージがメッセージ エディタのメイン ウィンドウに表示されます。

シンプル テキスト メッセージの検索

シンプル テキスト メッセージを検索するには、次の手順に従います。

  1. コンテキスト カタログがシンプル テキスト メッセージ カタログであること、図 3-4 に示されているように WebLogic メッセージ エディタのシンプル メッセージのメイン ウィンドウが表示されていることを確認します。
  2. メイン メニュー バーから [編集] を選択します。
  3. [検索] を選択して、図 3-9 に示すような [シンプル メッセージを検索] ダイアログを表示します。

    4. 図 3-9 シンプル メッセージの検索

    シンプル メッセージの検索


     
  4. メッセージ ID を入力します。
  5. [メッセージ テキスト検索] に、求めるメッセージの検索データを必要なだけ入力します。テキストの検索では、テキスト フィールドに入力されたすべての内容について部分一致検索が行われます。
  6. [先頭から検索] または [次を検索] をクリックします。

    7. メッセージの検索は、フィールドの情報をつなぎ合わせて実行されます。一致するメッセージが見つかると、図 3-4 に示されているように、そのメッセージがメッセージ エディタのメイン ウィンドウに表示されます。

 

メッセージ ビューアの使い方

WebLogic メッセージ エディタには、メッセージ ビューアが付属しており、このビューアを使えば、1 つのカタログ内の全メッセージおよび複数のカタログ内の全メッセージを表示すること、さらに任意のメッセージを選択して編集することができます。

以下の節では、メッセージ ビューアを使用して、メッセージを表示する方法、およびメッセージを選択して編集する方法を説明します。

1 つのカタログ内の全メッセージの表示

1 つのカタログ内のすべてのメッセージを表示する手順は次のとおりです。

  1. WebLogic メッセージ エディタを開きます。WebLogic メッセージ エディタのメイン ウィンドウに、最後に表示したメッセージのカタログが、現在のコンテキスト カタログとして表示されます。
  2. メニュー バーから [表示] を選択します。
  3. [すべてのメッセージ] オプションを選択します。現在のコンテキスト カタログのすべてのメッセージが、図 3-10 に示されているように [メッセージ ビューア] ウィンドウに表形式で表示されます。 メッセージ ビューアは、メッセージ エディタとは別のウィンドウに表示されます。メッセージ エディタは開いたままです。

    4. 図 3-10 メッセージ ビューア

    メッセージ ビューア


     

複数のカタログ内の全メッセージの表示

現在のコンテキスト カタログからメッセージを表示し、次に WebLogic メッセージ エディタのメイン ウィンドウで [参照] をクリックして新しいカタログに移動してコンテキストを変更すると、前のカタログの表示は元の画面に残り、新しいカタログの内容は別の [メッセージ ビューア] ウィンドウに表示されます。この操作を繰り返すと、必要な (または画面に表示が収まる限りの) 数のカタログを同時に表示できます。カタログごとに別々の [メッセージ ビューア] ウィンドウが表示されます。新規カタログの参照の詳細については、「既存のカタログの参照」を参照してください。

メッセージ ビューアからの編集対象メッセージの選択

メッセージ ビューアを使用して、メッセージ リストを表示後、ビューアの行に表示された任意のメッセージをクリックして選択することができます。選択したメッセージのカタログがコンテキスト カタログとなり、そのメッセージがメッセージ エディタのメイン ウィンドウに表示されます。

図 3-11 メッセージ 909001 に対するメッセージ ビューアとメッセージ エディタ


 

メッセージ 909001 に対するメッセージ ビューアとメッセージ エディタ


 

 

既存のメッセージの編集

既存のメッセージを編集するには、次の手順に従います。

  1. 「ログ メッセージの検索」および「シンプル テキスト メッセージの検索」に記載されているように [検索] ダイアログを使用して検索するか、「メッセージ ビューアからの編集対象メッセージの選択」に示されているようにメッセージ ビューアで行をクリックして、編集するメッセージを指定します。
  2. メッセージ エディタのメイン ウィンドウでフィールドを編集します。
  3. [更新] をクリックします。

    4. メッセージが更新され、カタログ全体がただちにディスクに書き込まれます。

 

メッセージの廃止と復帰

メッセージ エディタのメイン ウィンドウで、メッセージの廃止および復帰ができます。メッセージを廃止しても、そのメッセージはマスタ カタログからは削除されません。ユーザに表示されなくなるだけです。この機能は、使用しなくなったメッセージを削除する場合に役立ちます。廃止したメッセージを再び表示する必要がある場合は、復帰できます。

メッセージを廃止、または復帰するには、次の手順に従います。

  1. 「ログ メッセージの検索」および「シンプル テキスト メッセージの検索」に記載されているように [検索] ダイアログを使用して、廃止または復帰するメッセージを検索します。
  2. メッセージ エディタのメイン ウィンドウでチェックマーク ボックスをクリックして、[廃止されたメッセージ] オプションのオン、オフを切り替えます。
  3. [更新] をクリックします。

 

フッタのナビゲーションのスキップ  ページの先頭 前 次