![]() ![]() ![]() ![]() ![]() ![]() |
The following sections provide an overview of localization and internationalization:
Oracle has adopted the World Wide Web Consortium’s (W3C) recommendations for standard formats and protocols that are usable worldwide in all languages and in all writing systems. These standards are part of the Java internationalization APIs that are used by WebLogic Server. Internationalization (I18N) refers to the process of designing software so that it can be adapted to various languages and regions easily, cost-effectively, and, in particular, without engineering changes to the software. Localization (L10N) is the use of locale-specific language and constructs at run time.
Localization covers not only language, but collation, date and time formats, monetary formats, and character encoding. Messages that are logged to the WebLogic server log can be localized to meet your particular requirements.
WebLogic Server internationalization supports localization of two types of data:
All internationalized text is defined in message catalogs, each of which defines a collection of log messages or simple text. Log messages contain data that is written to the log file. This data is predominantly dynamic and contains information that is specific to the current state of the application and system. When merged with text in a localized log message catalog, this data results in well-formatted, localized messages that describe the error condition in the language of the user. The output sent to the WebLogic Server Administration Console is simple text. As with log messages, simple text can be merged with dynamic data.
To create an internationalized message, you externalize all message strings in a message catalog so that the strings can be converted to multiple locales without changing or recompiling the code. The application code supplies run-time values to the logging methods. The logging methods merge the code with the message string in the catalog according to the current locale. The application code then prints a localized message in the log files.
There are three types of message catalogs:
Message IDs in log message catalogs or locale message catalogs are unique across all log message or locale message catalogs. Within the message catalog file, each localized version of the message is assigned a unique message ID and message text specific to the error. Ideally, a message is logged from only one location within the system so that a support team can easily find it. Message IDs in simple text catalogs are unique within each simple text catalog.
See Using Message Catalogs with WebLogic Server for more detailed information about message catalogs.
To view the WebLogic Server message catalogs, see the Index of Messages by Message Range.
WebLogic Server uses the Java internationalization interfaces to provide internationalization and localization. In addition to understanding how WebLogic Server handles internationalization, you should be familiar with the Java internationalization interfaces and the following classes included in the Java Development Kit (JDK).
The following steps summarize how you create an internationalized message to use with WebLogic Server. Later sections of this guide describe these steps in more detail.
In addition to message text, include information about the type and placement of any run-time values that the message contains. For details, see Using the WebLogic Server Message Editor.
The generated classes contain a method for each message. The class is defined according to information specified in the message catalog entry. The classes include methods for logging or getting message text, depending on the type of catalog. The class name ends with Logger
or TextFormatter
. For details, see
weblogic.i18ngen Utility.
Logger
or TextFormatter
classes you generated in Step 2. When the application logs or returns a message, the message is written using the localized version of the text according to the Logger
or TextFormatter
classes used.For more detailed information, see Writing Messages to the WebLogic Server Log.
![]() ![]() ![]() |