BEAWebLogic Server™Internationalization GuideRelease 7.0Document Revised: August 20, 2002

x Internationalization GuideDocumentation ConventionsThe following documentation conventions are used throughout this document.Convention UsageCtrl+Ta

Internationalization Guide xi|Separates mutually exclusive choices in a syntax line. Example:java weblogic.deploy [list|deploy|undeploy|update] pas

xii Internationalization Guide

Internationalization Guide 1-1CHAPTER1 Overview of Internationalization for WebLogic ServerThe following sections provide an overview of localization

1 Overview of Internationalization for WebLogic Server1-2 Internationalization Guide(I18N) refers to the preparation of software so that it behaves pr

Understanding Message CatalogsInternationalization Guide 1-3Understanding Message CatalogsAll internationalized text is defined in message catalogs, e

1 Overview of Internationalization for WebLogic Server1-4 Internationalization GuideUnderstanding Java Interfaces for InternationalizationWebLogic Ser

Main Steps for Creating an Internationalized MessageInternationalization Guide 1-52. Run i18ngen to validate the catalog you created or edited in Step

1 Overview of Internationalization for WebLogic Server1-6 Internationalization Guide

Internationalization Guide 2-1CHAPTER2 Using Message Catalogs with BEA WebLogic ServerThe following sections describe message catalogs and how to use

CopyrightCopyright © 2002 BEA Systems, Inc. All Rights Reserved.Restricted Rights LegendThis software and documentation is subject to and made availab

2 Using Message Catalogs with BEA WebLogic Server2-2 Internationalization GuideMessage catalogs support multiple locales or languages. For a specific

Choosing Names for Message CatalogsInternationalization Guide 2-3Note: This directory path may vary, depending on where you chose to install WebLogic

2 Using Message Catalogs with BEA WebLogic Server2-4 Internationalization Guide Java allows you to group classes into a collection called a package.

Message Catalog FormatsInternationalization Guide 2-5An example of a method attribute for the above message is as follows:-method=“logNoFile(String na

2 Using Message Catalogs with BEA WebLogic Server2-6 Internationalization Guide log_message Other log_message Catalog Elementsmessage_catalogThe fol

Message Catalog FormatsInternationalization Guide 2-7log_messageThe following table describes the attributes that you can define for the log_message e

2 Using Message Catalogs with BEA WebLogic Server2-8 Internationalization GuideOther log_message Catalog ElementsThe following table describes the chi

Message Catalog FormatsInternationalization Guide 2-9Log Message Catalog ExampleThe following example shows a log message catalog, MyUtilLog.xml, with

2 Using Message Catalogs with BEA WebLogic Server2-10 Internationalization Guide version="1.0" baseid="600000" endid="6001

Message Catalog FormatsInternationalization Guide 2-11message_catalogThe following table describes the attributes that you can define for the message_

Hybrid Templates for FrameMaker 5.5 -iiiContentsAbout This DocumentAudience...

2 Using Message Catalogs with BEA WebLogic Server2-12 Internationalization GuidemessagebodyThe following table describes the child element of the mess

Message Catalog FormatsInternationalization Guide 2-13Simple Text Catalog ExampleThe following example shows a simple text catalog, MyUtilLabels.xml,

2 Using Message Catalogs with BEA WebLogic Server2-14 Internationalization GuideElements of a Locale-Specific CatalogThe locale-specific catalogs are

Message Catalog FormatsInternationalization Guide 2-15Locale Message Catalog SyntaxThe following example shows a French translation of a message that

2 Using Message Catalogs with BEA WebLogic Server2-16 Internationalization Guide

Internationalization Guide 3-1CHAPTER3 Using the BEA WebLogic Server Message EditorThe following sections describe how to use the Message Editor: Abo

3 Using the BEA WebLogic Server Message Editor3-2 Internationalization GuideNote: The Message Editor does not support the editing of localized catalog

Starting the Message EditorInternationalization Guide 3-3Starting the Message EditorBefore you start the Message Editor, you should have installed and

3 Using the BEA WebLogic Server Message Editor3-4 Internationalization GuideFigure 3-1 WebLogic Message Editor for Log MessagesWorking with Catalogs

Working with CatalogsInternationalization Guide 3-5Browsing to an Existing CatalogTo find an existing catalog from the main WebLogic Message Editor wi

-iv Hybrid Templates for FrameMaker 5.5message_catalog... 2-11message ...

3 Using the BEA WebLogic Server Message Editor3-6 Internationalization GuideFigure 3-3 WebLogic Message Editor for Log MessagesIf a simple messages

Working with CatalogsInternationalization Guide 3-7Figure 3-4 WebLogic Message Editor for Simple MessagesCreating a New CatalogTo create a new catal

3 Using the BEA WebLogic Server Message Editor3-8 Internationalization GuideFigure 3-5 Create New Catalog3. In the Message Catalog field, enter the

Adding Messages to CatalogsInternationalization Guide 3-9Adding Messages to CatalogsThe following sections describe how to use the Message Editor to a

3 Using the BEA WebLogic Server Message Editor3-10 Internationalization GuideFigure 3-6 Log Messages2. Enter a unique alphanumeric Message ID or cli

Adding Messages to CatalogsInternationalization Guide 3-116. Toggle the Display stacktrace option on or off by clicking the checkmark box. Use this op

3 Using the BEA WebLogic Server Message Editor3-12 Internationalization Guide5. Enter the Message body text.6. Click Add.The message is added and the

Finding MessagesInternationalization Guide 3-135. Enter as much information as you need in the Message text search field to find the correct message.

3 Using the BEA WebLogic Server Message Editor3-14 Internationalization GuideUsing the Message ViewerThe WebLogic Message Editor contains a Message Vi

Using the Message ViewerInternationalization Guide 3-15Figure 3-10 Message ViewerViewing All Messages in Several CatalogsIf you view the messages fr

Hybrid Templates for FrameMaker 5.5 -vSyntax ... 4-5Opti

3 Using the BEA WebLogic Server Message Editor3-16 Internationalization GuideEditing an Existing MessageTo edit an existing message, complete the foll

Internationalization Guide 4-1CHAPTER4 Using the BEA WebLogic Server Internationalization UtilitiesThe following sections contain information about th

4 Using the BEA WebLogic Server Internationalization Utilities4-2 Internationalization Guide 18ngen Utility—Message catalog parser. Use this utility

About the WebLogic Server Internationalization and Localization InterfacesInternationalization Guide 4-3As another example, when the MyUtilLog.xml cat

4 Using the BEA WebLogic Server Internationalization Utilities4-4 Internationalization GuideThe output prints the message text in the current locale,

l10ngen UtilityInternationalization Guide 4-5l10ngen UtilityThe l10ngen utility processes the locale-specific catalogs in directories that are subordi

4 Using the BEA WebLogic Server Internationalization Utilities4-6 Internationalization GuideNote: Utilities can be run from any directory, but if file

CatInfo UtilityInternationalization Guide 4-7OptionsNote: All options may be abbreviated to a single character.To export the detailed list of messages

4 Using the BEA WebLogic Server Internationalization Utilities4-8 Internationalization Guide

Internationalization Guide A-1APPENDIXA Localizer Class Reference for BEA WebLogic ServerThe following sections provide reference information for Loca

-vi Hybrid Templates for FrameMaker 5.5

A Localizer Class Reference for BEA WebLogic ServerA-2 Internationalization GuideLocalizer MethodsLocalizers are extensions to the java.util.ListResou

Localizer Lookup ClassInternationalization Guide A-3The following list shows the severity values that are returned: weblogic.logging.severities.EMERG

A Localizer Class Reference for BEA WebLogic ServerA-4 Internationalization Guide Localizer class is the name of the generated Localizer classFor exa

Internationalization Guide B-1APPENDIXB Logger Class Reference for BEA WebLogic ServerThe following sections provide reference information for Logger

B Logger Class Reference for BEA WebLogic ServerB-2 Internationalization GuideExample of a Generated Logger ClassListing B-1 show an example of a cata

Example of a Generated Logger ClassInternationalization Guide B-3 stacktrace="true" > <messagebody>This message is foll

B Logger Class Reference for BEA WebLogic ServerB-4 Internationalization GuideListing B-2 Example of Generated Logger Classpackage examples.i18n.log

Example of a Generated Logger ClassInternationalization Guide B-5 public static Loggable testArgsLoggable(String arg0, int arg1) throws MissingResour

B Logger Class Reference for BEA WebLogic ServerB-6 Internationalization Guide * messageid: 600004 * severity: info */ public static String

Example of a Generated Logger ClassInternationalization Guide B-7import java.util.Locale;import weblogic.i18n.Localizer;import weblogic.i18ntools.L10n

Internationalization Guide viiAbout This DocumentThis document defines internationalization and localization, and explains how to use the templates an

B Logger Class Reference for BEA WebLogic ServerB-8 Internationalization Guide */ Throwable t = new Throwable("Test with stack trace&q

Example of a Generated Logger ClassInternationalization Guide B-9 System.out.println(fmt.i18nPackage(messageId,lcl.getI18nPackage())); Syste

B Logger Class Reference for BEA WebLogic ServerB-10 Internationalization Guide

Internationalization Guide C-1APPENDIXC Loggable Object Reference for BEA WebLogic ServerThe following sections provide reference information for Logg

C Loggable Object Reference for BEA WebLogic ServerC-2 Internationalization GuideHow Loggable Objects Are UsedTo create a Logger that provides methods

How Loggable Objects Are UsedInternationalization Guide C-3 logIOErrorLoggable (Throwable)—returns a Loggable objectThe Loggable class can be used as

C Loggable Object Reference for BEA WebLogic ServerC-4 Internationalization Guide

Internationalization Guide D-1APPENDIXD TextFormatter Class Reference for BEA WebLogic ServerThe following sections provide reference information for

D TextFormatter Class Reference for BEA WebLogic ServerD-2 Internationalization GuideExample of an Application Using a TextFormatter ClassListing 4-3

Example of an Application Using a TextFormatter ClassInternationalization Guide D-3 </message> <!-- --> <message messageid=

viii Internationalization GuideAudienceThis document is written for application developers who must internationalize or localize the message catalogs

D TextFormatter Class Reference for BEA WebLogic ServerD-4 Internationalization Guide datelastchanged="967578755587" method="

Example of an Application Using a TextFormatter ClassInternationalization Guide D-5 * using the catalog editing utility, weblogic.i18ntools.gui.Messag

D TextFormatter Class Reference for BEA WebLogic ServerD-6 Internationalization Guide */ HelloWorldTextFormatter fmt = new HelloWorldTextForm

Example of an Application Using a TextFormatter ClassInternationalization Guide D-7Listing 4-5 Example of Generated TextFormatter Class for the Hell

D TextFormatter Class Reference for BEA WebLogic ServerD-8 Internationalization Guide <!-- --> <message messageid="VERSION&quo

Example of an Application Using a TextFormatter ClassInternationalization Guide D-9

D TextFormatter Class Reference for BEA WebLogic ServerD-10 Internationalization Guide

Hybrid Templates for FrameMaker 5.5 I--iIndexAargumentkey A-2message 2-4Ccatalogbrowsing for 3-5context 3-2creating 3-7entering a new log message 3-9e

I--ii Hybrid Templates for FrameMaker 5.5definition of 1-2log messages 1-2simple text 1-2Localizers 4-2, A-1log message catalogelements 2-5example 2-9

Internationalization Guide ixRelated InformationFor more information in general about internationalization and localization, refer to the following so