BEA Server 1

Internationalization Guide 1-1

CHAPTER

1Overview of

Internationalization

for WebLogic Server

The following sections provide an overview of localization and internationalization:

About Internationalization and Localization Standards

Understanding Localization for WebLogic Server

Understanding Message Catalogs

Understanding Java Interfaces for Internationalization

Main Steps for Creating an Internationalized Message

About Internationalization and Localization

Standards

BEA 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 Application

Program Interfaces (APIs) that are used by WebLogic Server. Internationalization

Contents

Main Copyright Restricted Rights Legend Trademarks or Service Marks Part Number Document Revised Software Version Contents About This Document 1. Overview of Internationalization for WebLogic Server 2. Using Message Catalogs with BEA WebLogic Server 3. Using the BEA WebLogic Server Message Editor 4. Using the BEA WebLogic Server Internationalization Utilities Page Page About This Document Audience e-docs Web Site How to Print the Document Related Information Contact Us! xInternationalization Guide Documentation Conventions The following documentation conventions are used throughout this document. Convention Usage Page Page 1 Internationalization for WebLogic Server About Internationalization and Localization Standards 1 Understanding Localization for WebLogic Server Understanding Message Catalogs Understanding Message Catalogs 1 Understanding Java Interfaces for Internationalization Main Steps for Creating an Internationalized Message Main Steps for Creating an Internationalized Message Page 2 Catalogs with BEA Overview of Message Catalogs Message Catalog Hierarchy Choosing Names for Message Catalogs Choosing Names for Message Catalogs Using Message Arguments Message Catalog Formats Elements of a Log Message Catalog 2-6 Internationalization Guide message_catalog The following table describes the attributes that you can define for the Internationalization Guide 2-7 log_message The following table describes the attributes that you can define for the log_message element. 2-8 Internationalization Guide Other log_message Catalog Elements The following table describes the child elements of the log_message element. Log Message Catalog Example 2-10 Internationalization Guide Elements of a Simple Text Message Catalog message_catalog message 2-12 Internationalization Guide messagebody The following table describes the child element of the message element. Simple Text Catalog Example Elements of a Locale-Specific Catalog locale_message_catalog log_message Other locale_message_catalog Elements Locale Message Catalog Syntax Page 3 WebLogic Server Message Editor About the Message Editor Page Starting the Message Editor Starting the Message Editor Working with Catalogs Working with Catalogs Browsing to an Existing Catalog Page Page Page Adding Messages to Catalogs Adding Messages to Catalogs Entering a New Log Message Page Adding Messages to Catalogs Entering a New Simple Text Message Finding Messages Finding a Log Message Finding Messages Finding a Simple Text Message Using the Message Viewer Viewing All Messages in a Catalog Using the Message Viewer Viewing All Messages in Several Catalogs Choosing a Message to Edit from the Message Viewer Editing an Existing Message 4 About the WebLogic Server Internationalization and Localization Interfaces About the WebLogic Server Internationalization and Localization Interfaces 18ngen Utility l10ngen Utility Internationalization Guide 4-5 l10ngen Utility where <l10n_Classpath> should include <WebLogic internationalized messages. CatInfo Utility CatInfo Utility Page A Reference for BEA About Localizer Classes A Localizer Methods Localizer Lookup Class Localizer Lookup Class A B for BEA WebLogic Server About Logger Classes B-2 Internationalization Guide Example of a Generated Logger Class Internationalization Guide B-3 Listing B-2 shows the corresponding java source generated by i18ngen: B-4 Internationalization Guide Listing B-2 Example of Generated Logger Class Internationalization Guide B-5 B-6 Internationalization Guide Internationalization Guide B-7 B-8 Internationalization Guide Page Page C Reference for BEA About Loggable Objects C How Loggable Objects Are Used How Loggable Objects Are Used Page D Reference for BEA About TextFormatter Classes D-2 Internationalization Guide Example of an Application Using a TextFormatter Class Internationalization Guide D-3 D-4 Internationalization Guide Internationalization Guide D-5 D-6 Internationalization Guide Listing 4-5 shows an example of the generated TextFormatter for the HelloWorld catalog. Internationalization Guide D-7 Listing 4-5 Example of Generated TextFormatter Class for the HelloWorld Catalog D-8 Internationalization Guide Page Page Index A C D E M N O P R