Movatterモバイル変換

Resources : Resource bundle component

Many Java applications must support internationalization (i18n) of messagestrings presented as part of the user interface, or in messages written tolog files. The standard Java APIs offer thejava.util.ResourceBundle family of classes to support thisrequirement; however, these classes have the following limitations thatreduce their usefulness:

The classes assume that all messages should be presented based on a single Locale, while many applications require support for different Locales for each current application user.
TheResourceBundle implementation classes do not implement thejava.io.Serializable interface, which is required in some operational environments.

The classes in theResources package offer solutionsto these two problems, and provide a framework for providing customizedResources implementations that can access resource stringsfrom any desired static or dynamically updated collection.

Resources API

The core of the resources framework are two interfaces:

Resources Representation of a set of internationalized resources, which are arbitrary objects identified by a unique String key and can be accessed for differentjava.util.Locale.
ResourcesFactory Factory class to configure and instantiate an appropriateResources instance.

Basic implementations of the above are provided for resources contained in property files, XML and databases(via JDBC). Implementations are also provided for use in a Web App environment.

The resources framework also includes interfaces for encapsualting messages and message lists:

Message An encapsulation of an individual message, consisting of a message key, and replacement values.
MessageList A class that encapsulates a set of messages.

Documentation

Wiki

See theCommons Wiki for the User Guide, class diagram and other resources:

JavaDoc

The JavaDoc API documents are availablehere.

The following versions of the JavaDoc API documents are available online:

TheCurrent Release
Thelatest SVN

Source Code Repository

Thesubversion repository can bebrowsed.

Releases

See theDownloads page for current/previous releases.

Release Notes are availablehere.

Support

Thecommons mailing lists act as the main support forum. The user list is suitable for most library usage queries. The dev list is intended for the development discussion. Please remember that the lists are shared between all commons components, so prefix your email by [resources].

Issues may be reported viaASF Bugzilla. Please remember that Bugzilla is shared between all commons components, so prefix your issue by [resources].