Summary of the content on the page No. 1
BEA WebLogic
™
Server
Internationalization Guide
Release 7.0
Document Revised: August 20, 2002
Summary of the content on the page No. 2
Copyright Copyright © 2002 BEA Systems, Inc. All Rights Reserved. Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part, be copied photocopied, reproduced, translated, or reduced to a
Summary of the content on the page No. 3
Contents About This Document Audience............................................................................................................ viii e-docs Web Site................................................................................................. viii How to Print the Document............................................................................... viii Related Information..............................................................................................ix Conta
Summary of the content on the page No. 4
message_catalog................................................................................ 2-11 message ............................................................................................. 2-11 messagebody ..................................................................................... 2-12 Simple Text Catalog Example .......................................................... 2-13 Elements of a Locale-Specific Catalog .................................................... 2-14 l
Summary of the content on the page No. 5
Syntax ................................................................................................. 4-5 Options................................................................................................ 4-6 CatInfo Utility ................................................................................................... 4-6 Syntax ................................................................................................. 4-6 Options...............................................
Summary of the content on the page No. 6
-vi Hybrid Templates for FrameMaker 5.5
Summary of the content on the page No. 7
About This Document This document defines internationalization and localization, and explains how to use the templates and tools provided with WebLogic Server to create or edit message catalogs that are locale-specific. The document is organized as follows: Chapter 1, “Overview of Internationalization for WebLogic Server,” summarizes the processes required for internationalization and localization. Chapter 2, “Using Message Catalogs with BEA WebLogic Server,” describes message catalog type
Summary of the content on the page No. 8
Audience This document is written for application developers who must internationalize or localize the message catalogs included in the WebLogic Server distribution for locale-specific administration and management. It is assumed that readers are familiar with the WebLogic Server Platform and know Web technologies, object-oriented programming techniques, and the Java programming language. e-docs Web Site BEA product documentation is available on the BEA corporate Web site. From the BEA Home
Summary of the content on the page No. 9
Related Information For more information in general about internationalization and localization, refer to the following sources: The Java Developer Connection™ at java.sun.com The Internationalization section of the World Wide Web Consortium (W3C) Web Site at http://www.w3.org Contact Us! Your feedback on BEA documentation is important to us. Send us e-mail at docsupport@bea.com if you have questions or comments. Your comments will be reviewed directly by the BEA professionals who create a
Summary of the content on the page No. 10
Documentation Conventions The following documentation conventions are used throughout this document. Convention Usage Ctrl+Tab Keys you press simultaneously. italics Emphasis and book titles. monospace Code samples, commands and their options, Java classes, data types, text directories, and file names and their extensions. Monospace text also indicates text that you enter from the keyboard. Examples: import java.util.Enumeration; chmod u+w * config/examples/applications .java config.xml float
Summary of the content on the page No. 11
Convention Usage | Separates mutually exclusive choices in a syntax line. Example: java weblogic.deploy [list|deploy|undeploy|update] password {application} {source} ... Indicates one of the following in a command line: An argument can be repeated several times in the command line. The statement omits additional optional arguments. You can enter additional parameters, values, or other information Internationalization Guide xi
Summary of the content on the page No. 12
xii Internationalization Guide
Summary of the content on the page No. 13
CHAPTER 1 Overview 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 Consortiu
Summary of the content on the page No. 14
1 Overview of Internationalization for WebLogic Server (I18N) refers to the preparation of software so that it behaves properly in multiple locations. Localization (L10N) is the use of locale-specific language and constructs at run time. Internationalization of textual data in WebLogic Server is provided through message catalogs. WebLogic Server supports message catalogs for log messages as well as simple text. Log messages contain data that is written to the log file. This data is predomin
Summary of the content on the page No. 15
Understanding Message Catalogs Understanding Message Catalogs All internationalized text is defined in message catalogs, each of which defines a collection of log messages or simple text. To create an internationalized message, you externalize all message strings in a message catalog so that the strings can be easily 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
Summary of the content on the page No. 16
1 Overview of Internationalization for WebLogic Server Understanding Java Interfaces for Internationalization WebLogic Server uses the Java internationalization interfaces for providing internationalization and localization. In addition to understanding how WebLogic Server handles internationalization, users should be familiar with the Java internationalization interfaces and the following classes included in the Java Development Kit (JDK): Class Description java.util.Locale Represents a sp
Summary of the content on the page No. 17
Main Steps for Creating an Internationalized Message 2. Run i18ngen to validate the catalog you created or edited in Step 1 and generate runtime classes. The generated classes contain a method for each message. The method is defined according to information specified in the message catalog entry. The methods include Logger or TextFormatter methods, depending on the type of catalog. For details, see “18ngen Utility” on page 4-4. 3. Create locale-specific catalogs as required for the message
Summary of the content on the page No. 18
1 Overview of Internationalization for WebLogic Server 1-6 Internationalization Guide
Summary of the content on the page No. 19
CHAPTER 2 Using Message Catalogs with BEA WebLogic Server The following sections describe message catalogs and how to use them: Overview of Message Catalogs Message Catalog Hierarchy Choosing Names for Message Catalogs Using Message Arguments Message Catalog Formats Overview of Message Catalogs Message catalogs are XML files that contain a description of a collection of text messages, each indexed by a unique idenifier. You compile these XML files into classes during the i18ngen ut
Summary of the content on the page No. 20
2 Using Message Catalogs with BEA WebLogic Server Message catalogs support multiple locales or languages. For a specific message catalog there is exactly one default version, known as the top-level catalog. Then there are corresponding locale-specific catalogs, one for each additional supported locale. The top-level catalog includes all the information necessary to define the message. The locale-specific catalogs contain only the message ID, the date changed, and the translation of the mess
