This chapter includes the following sections:
This document is a resource for Java Platform, Enterprise Edition (Java EE) application developers who want to use WebLogic message catalogs and logging services as a way for their applications to produce log messages and want to integrate their application logs with WebLogic Server logs. This document is relevant to all phases of a software project, from development through test and production phases.
This document does not address how you configure logging, subscribe to and filter log messages. For links to information on these topics, see Related Documentation.
It is assumed that the reader is familiar with Java EE and Web technologies, object-oriented programming techniques, and the Java programming language.
The document is organized as follows:
Introduction and Roadmap describes the scope of this guide and lists related documentation.
Application Logging and WebLogic Logging Services discusses how to use WebLogic logging services to monitor application events.
Internationalization and Localization for WebLogic Server summarizes the processes required for internationalization and localization.
Using Message Catalogs with WebLogic Server describes message catalog types, message definitions, elements, and arguments.
Writing Messages to the WebLogic Server Log describes how to create and use message catalogs and how to use the NonCatalogLogger
class to write log messages.
Using the WebLogic Server Message Editor explains how to use the Message Editor that is included with WebLogic Server.
Using the WebLogic Server Internationalization Utilities explains how to use the internationalization utilities included with WebLogic Server.
Localizer Class Reference for WebLogic Server describes Localizer
classes, Localizer
methods, key values for Localizers
, and lookup properties for Localizers
.
Loggable Object Reference for WebLogic Server describes loggable objects
and how they are used.
TextFormatter Class Reference for WebLogic Server provides an example of an application that uses a TextFormatter
class.
Logger Class Reference for WebLogic Server describes Logger
classes and provides an example of a message catalog and its corresponding Logger
class.
The corporate Web site provides all documentation for WebLogic Server. Specifically, View and configure logs in the Oracle WebLogic Server Administration Console Online Help describes configuring log files and log messages that a WebLogic Server instance generates, and Configuring WebLogic Logging Services in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server describes configuring WebLogic Server to write messages to log files, filtering message output, and listening for the log messages that WebLogic Server broadcasts.
For general information about internationalization and localization, refer to the following sources:
The Java Developer Connection at http://www.oracle.com/technetwork/java/index.html
The Internationalization section of the World Wide Web Consortium (W3C) Web Site at http://www.w3.org
In addition to this document, we provide a variety of logging code samples and tutorials that show logging configuration and API use.
MedRec is an end-to-end sample Java EE application shipped with WebLogic Server that simulates an independent, centralized medical record management system. The MedRec application provides a framework for patients, doctors, and administrators to manage patient data using a variety of different clients.
MedRec demonstrates WebLogic Server and Java EE features, and highlights recommended best practices. MedRec is optionally installed with the WebLogic Server installation. You can start MedRec from the ORACLE_HOME
\user_projects\domains\medrec
directory, where ORACLE_HOME
is the directory you specified as the Oracle Home when you installed Oracle WebLogic Server. For more information, see Sample Applications and Code Examples in Understanding Oracle WebLogic Server.
WebLogic Server optionally installs API code examples in ORACLE_HOME
\wlserver\samples\server
, where ORACLE_HOME
represents the directory in which you installed WebLogic Server. For more information, see Sample Applications and Code Examples in Understanding Oracle WebLogic Server.
This example shows various methods for displaying localized text using simple message catalogs. Using any of the languages supported by the example requires the appropriate operating system localization software and character encoding. The package that contains this example is:
java examples.i18n.simple.HelloWorld [lang [country]]
where lang
is a two-character ISO language code (for example, en for English) and country
is a two-character ISO country code (for example, US for the United States).
The files are located in ORACLE_HOME
\wlserver\samples\server\examples\src\examples\i18n\simple
, where ORACLE_HOME
represents the directory in which you installed WebLogic Server. For more information, see Sample Applications and Code Examples in Understanding Oracle WebLogic Server.
For a comprehensive listing of the new WebLogic Server features introduced in this release, see What's New in Oracle WebLogic Server 12.2.1.3.0.