You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by rd...@apache.org on 2003/09/08 20:41:32 UTC
cvs commit: jakarta-commons-sandbox/resources/src/java/org/apache/commons/resources package.html ResourcesFactory.java
rdonkin 2003/09/08 11:41:32
Modified: resources/src/java/org/apache/commons/resources
ResourcesFactory.java
Added: resources/src/java/org/apache/commons/resources package.html
Log:
Some package documentation
Revision Changes Path
1.6 +5 -5 jakarta-commons-sandbox/resources/src/java/org/apache/commons/resources/ResourcesFactory.java
Index: ResourcesFactory.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/resources/src/java/org/apache/commons/resources/ResourcesFactory.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ResourcesFactory.java 28 Dec 2002 04:40:55 -0000 1.5
+++ ResourcesFactory.java 8 Sep 2003 18:41:32 -0000 1.6
@@ -7,7 +7,7 @@
*
* The Apache Software License, Version 1.1
*
- * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
+ * Copyright (c) 1999-2003 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
1.1 jakarta-commons-sandbox/resources/src/java/org/apache/commons/resources/package.html
Index: package.html
===================================================================
<html>
<head>
<title>Package Documentation for org.apache.commons.resources Package</title>
</head>
<body bgcolor="white">
<p>Resources is a component that provides advanced management of message resources.</p>
<p>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
<code>java.util.ResourceBundle</code> family of classes to support this
requirement; however, these classes have the following limitations that
reduce their usefulness:</p>
<ul>
<li>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.</li>
<li>The <code>ResourceBundle</code> implementation classes do not implement
the <code>java.io.Serializable</code> interface, which is required in
some operational environments.</li>
</ul>
<p>The classes in the proposed <code>Resources</code> package offer solutions
to these two problems, and provide a framework for providing customized
<code>MessageResources</code> implementations that can access resource strings
from any desired static or dynamically updated collection.</p>
</body>
</html>