BEA WebLogic Server 用の Localizer クラスのリファレンス

以下の節では、Localizer クラスのリファレンス情報を提供します。

• Localizer クラスの概要

• Localizer メソッド

• Localizer のルックアップ クラス

注意: この Localizer クラス メソッドの情報は、上級ユーザ向けのリファレンスです。通常、ユーザがこのインタフェースを直接使用する必要はありません。

 

---

Localizer クラスの概要

Localizer は、出力用のテキストをローカライズするためにアプリケーションやサーバ コードによって使用されるクラスです。i18ngen ユーティリティでは、メッセージ カタログの内容に基づいて Localizer クラスが作成されます。

Localizer クラスは、カタログ ファイルごとに 1 つ生成されます。クラスの名前は、カタログ名 (.xml 拡張子はユーティリティによって削除される) の後に LogLocalizer を付けたものです。カタログ ejb.xml の Localizer クラスは、ejbLogLocalizer です。

 

---

Localizer メソッド

Localizer は、java.util.ListResourceBundle クラスを拡張したものです。Localizer でのローカライゼーション データのアクセスを容易にするために、4 つのメソッドが追加されています。これらのメソッドは、以下の表 A-1 で説明されています。

表 A-1 ローカライゼーション データのアクセスに使用されるメソッド

メソッド	説明
public Object getObject(String key, String id)	メッセージ id の key 要素に対応するローカライゼーション テキストを返す。
public Object getObject(String key, int id)	メッセージ id の key 要素に対応するローカライゼーション テキストを返す。
public String getString(String key, String id)	メッセージ id の key 要素に対応するローカライゼーション テキストを返す。
public String getString(String key, int id)	メッセージ id の key 要素に対応するローカライゼーション テキストを返す。

 

ローカライゼーション データ アクセスに使用される各メソッドには key 引数があります。次に挙げるのは、key 引数として識別される値です。

• Localizer.SEVERITY

• Localizer.MESSAGE_ID

• Localizer.MESSAGE_BODY

• Localizer.MESSAGE_DETAIL

• Localizer.CAUSE

• Localizer.ACTION

Localizer.SEVERITY キーの場合を除き、Localizer によって返されるローカライゼーション データは整数型のオブジェクトを返す String オブジェクトです。

返される重要度 (severity) の値は、以下のとおりです。

• weblogic.logging.severities.EMERGENCY

• weblogic.logging.severities.ALERT

• weblogic.logging.severities.CRITICAL

• weblogic.logging.severities.ERROR

• weblogic.logging.severities.WARNING

• weblogic.logging.severities.NOTICE

• weblogic.logging.severities.INFO

• weblogic.logging.severities.DEBUG

返される特定の文字列は、メッセージ カタログで定義されます。

get*() メソッドの key 引数は、定義のどの要素を返すのかを識別します。受け入れられる値は、Localizer クラスの定義で定義されます。返されるテキストは、java.text.MessageFormat.format() によってさらに拡張できます。message body、detail、cause、および action の各要素は、すべてローカライズできます。他の要素 (message ID、severity、および subsystem) はローカライズ可能ではなく、MessageFormat で処理を加える必要もありません。

 

---

Localizer のルックアップ クラス

メッセージに対して正しい Localizer を取得するには、L10nLookup クラスを使用します。L10nLookup は、システムの起動時に次のプロパティ ファイルからロードされる Property クラスの拡張です。

¥weblogic¥i18n¥i18n.properties 

このプロパティ ファイルは、i18ngen によって作成されます。ルックアップ ファイルのプロパティのフォーマットは次のとおりです。

nnnnnn=subsystem:Localizer class

この行の引数は次のように定義されています。

• nnnnnn はメッセージ ID を表します。

• subsystem は関連するサブシステムを表します。

• Localizer class は生成された Localizer クラスの名前を表します。

たとえばメッセージ 001234 は、次のルックアップ ファイルのプロパティに基づいて、weblogic.i18n.ejbLogLocalizer クラスからの EJB サブシステム メッセージ ID として識別されます。

001234=EJB:weblogic.i18n.ejbLogLocalizer