メッセージ・カタログmsgcat.dtdこの付録では、ローカライズ可能なログ・メッセージのメッセージ・カタログ要素の構成に使用するXMLの背後にあるスキーマである、msgcat.dtdスキーマの要素へのリファレンスを示します。この付録の内容は次のとおりです。Processingでは、ローカライズできるログ・メッセージの定義に使用する、多数のメッセージ・カタログ要素が提供されます。Processingメッセージ・カタログ要素は、メッセージのカタログ・タイプに応じて次の階層で構成されます。例この項では、次のメッセージ・カタログの例を示します。message_catalogこの要素はログ・メッセージ・カタログを表します。子要素message_catalog要素は、次の子要素をサポートしています。表G-1では、message_catalog要素の属性を示します。必須?i18n_packageこのカタログのLoggerクラスを含むJavaパッケージ。クラスの名前はカタログ・ファイルの名前に基づいて付けられます。Loggerクラスの名前はi18n_package.mycatLogger.classになります。標準のJavaパッケージ構文。weblogic.i18nStringいいえ。I10n_packageカタログ用に生成したLogLocalizerプロパティを含むJavaパッケージ。カタログの名前がmycat.xmlの場合、次のプロパティ・ファイルが生成されます。標準のJavaパッケージ構文。weblogic.i18nStringいいえ。subsystemこのカタログと関連付けられているサブシステムを識別する頭字語。サブシステムの名前はサーバー・ログに含まれ、メッセージの分離を目的として使用されます。subsystem="MYUTIL"Stringはい。version使用されるmsgcat.dtdのバージョンを指定します。"1.0"である必要があります。ここで、xおよびyは数値です。version="1.0"Stringはい。baseidこのカタログで使用される最低のメッセージIDを指定します。:ユーザー定義のカタログStringいいえ。endidこのカタログで使用される最高のメッセージIDを指定します。:ユーザー定義のカタログStringいいえ。loggablesLoggableオブジェクトを返す追加メソッドを生成するかどうかを示します。falseStringprefixログに記録されるときにメッセージIDの先頭に追加するStringを指定します。Processingサーバー・メッセージは、接頭辞のデフォルトは「CEP」で、別の接頭辞を指定することはできません。ユーザー・メッセージは、任意の接頭辞を指定することが可能です。接頭辞が付いたメッセージIDは、ログ・エントリで次のように表示されます。<[prefix-]id>ここで、prefixはこの属性であり、idは特定のメッセージに関連付けられた6桁のメッセージIDです。<XYZ-987654>として表示されます。prefixが定義されていない場合、ログ・エントリは<987654>となります。Processingサーバー・カタログnullはユーザー定義カタログStringいいえ。descriptionカタログの内容を説明する省略可能な属性。application"Stringいいえ。次の例は、ログ・メッセージ・カタログ・ファイル内のmessage_catalog要素の使用方法を示します。logmessageこの要素を使用して正式なログ・メッセージを定義します。子要素logmessageコンポーネント構成要素では、次の子要素をサポートしています。表G-2ではlogmessageコンポーネント構成要素の属性が一覧表示されています。必須?messageidこのログ・メッセージのユニークな識別子。識別子は、すべてのカタログにわたりユニークである必要があります。値は、baseid属性とendid属性で定義された範囲で指定する必要があります。値は、message_catalog要素に定義されているbaseidおよびendid属性で定義された範囲内である必要があります。messageid="600001"Stringはい。datelastchangedこのメッセージの修正管理に使用される日付と時刻のスタンプ。日付は、カタログで動作するユーティリティによって提供されます。日付はカタログで動作するユーティリティによって提供されます。Date().getTime());Stringいいえ。severityログ・メッセージの重大度を示します。ユーザー定義カタログでは、debug、info、warningおよびerrorのみを使用します。severity="warning"Stringはい。methodこのメッセージをログに記録するためのメソッド・シグネチャ。構文は標準のJavaメソッド・シグネチャから修飾子、セミコロン、および拡張子を除いたもの。引数の型にはJavaプリミティブまたはJavaクラスを使用できます。クラスはjava.langにない場合は完全修飾である必要があります。クラスはjava.text.MessageFormatの規約に準拠している必要があります。場合、クラス引数は便利なtoString()メソッドを備えています。規則に従っている必要があります。指定できる引数は10個までです。各argnについて、G.3.1項「子要素」で説明されているテキスト要素に少なくとも1つの対応するプレースホルダーが存在している必要があります。プレースホルダーの形式は{n}、{n,number}または{n,date}です。methodtype生成するメソッドのタイプを指定します。メソッドは次のとおりです。メッセージ本文をデフォルトのロケールにフォーマットし、結果をログに記録するloggerメソッド。subsystemおよびmessageidの接頭辞の付いたメッセージ本文を[susbsystem:msgid]textのように戻すgetterメソッド。loggerStringいいえ。stacktraceThrowableの引数としてスタック・トレースを生成するかどうかを示します。値がtrueの場合はトレースが生成されます。