Many Java applications must support internationalization (i18n) of message
strings presented as part of the user interface, or in messages written to
log files. The standard Java APIs offer the
java.util.ResourceBundle family of classes to support this
requirement; however, these classes have the following limitations that
reduce their usefulness:
ResourceBundleimplementation classes do not implement the
java.io.Serializableinterface, which is required in some operational environments.
The classes in the
Resources package offer solutions
to these two problems, and provide a framework for providing customized
Resources implementations that can access resource strings
from any desired static or dynamically updated collection.
The core of the resources framework are two interfaces:
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:
See the Commons Wiki for the User Guide, class diagram and other resources:
The JavaDoc API documents are available here.
The following versions of the JavaDoc API documents are available online:
The commons 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 via ASF Bugzilla. Please remember that Bugzilla is shared between all commons components, so prefix your issue by [resources].