From portal-commits at lists.jboss.org Sun Mar 25 08:48:44 2007
Content-Type: multipart/mixed; boundary="===============8382871178110415493=="
MIME-Version: 1.0
From: portal-commits at lists.jboss.org
To: portal-commits at lists.jboss.org
Subject: [portal-commits] JBoss Portal SVN: r6820 -
 trunk/common/src/main/org/jboss/portal/common/i18n.
Date: Sun, 25 Mar 2007 08:48:44 -0400
Message-ID: <E1HVS9M-0002hx-CZ@committer01.frg.pub.inap.atl.jboss.com>

--===============8382871178110415493==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: julien(a)jboss.com
Date: 2007-03-25 08:48:44 -0400 (Sun, 25 Mar 2007)
New Revision: 6820

Modified:
   trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleFactory=
.java
   trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleManager=
.java
Log:
resource bundle manager and factory basic javadoc

Modified: trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundle=
Factory.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleFactor=
y.java	2007-03-25 02:23:56 UTC (rev 6819)
+++ trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleFactor=
y.java	2007-03-25 12:48:44 UTC (rev 6820)
@@ -26,6 +26,8 @@
 import java.util.Locale;
 =

 /**
+ * Definition of a factory for resource bundles.
+ *
  * @author <a href=3D"mailto:julien(a)jboss.org">Julien Viet</a>
  * @version $Revision: 1.1 $
  */

Modified: trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundle=
Manager.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleManage=
r.java	2007-03-25 02:23:56 UTC (rev 6819)
+++ trunk/common/src/main/org/jboss/portal/common/i18n/ResourceBundleManage=
r.java	2007-03-25 12:48:44 UTC (rev 6820)
@@ -33,8 +33,12 @@
 import java.util.MissingResourceException;
 =

 /**
- * Manage a set of resource bundles.
+ * <p>Manage a set of resource bundles. Obtention of bundles is done using=
 a ResourceBundleFactory object.
+ * A bundle obtained succesfully is cached in order to avoid the potential=
 expensive cost of bundle obtention.</p>
  *
+ * <p>The manager can also be used to build LocalizedString object from th=
e loaded bundles.</p> =

+ *
+ *
  * @author <a href=3D"mailto:julien(a)jboss.org">Julien Viet</a>
  * @author <a href=3D"mailto:theute(a)jboss.org">Thomas Heute</a>
  * @version $Revision: 6697 $
@@ -42,20 +46,29 @@
 public class ResourceBundleManager
 {
 =

-   /** */
+   /** . */
    private Logger log =3D Logger.getLogger(getClass());
 =

-   /** */
+   /** . */
    private volatile Map localeBundles;
 =

-   /** */
+   /** . */
    private ResourceBundle defaultBundle;
 =

-   /** */
+   /** . */
    private ResourceBundleFactory resourceBundleFactory;
 =

-   public ResourceBundleManager(ResourceBundle defaultBundle, ResourceBund=
leFactory resourceBundleFactory)
+   /**
+    * @param defaultBundle the default bundle returned when no bundle has =
been obtained for the locale
+    * @param resourceBundleFactory the resource bundle factory
+    * @throws IllegalArgumentException IllegalArgumentException if the res=
ource bundle factory is null
+    */
+   public ResourceBundleManager(ResourceBundle defaultBundle, ResourceBund=
leFactory resourceBundleFactory) throws IllegalArgumentException
    {
+      if (resourceBundleFactory =3D=3D null)
+      {
+         throw new IllegalArgumentException("Need a resource bundle factor=
y");
+      }
       this.localeBundles =3D new HashMap();
       this.defaultBundle =3D defaultBundle;
       this.resourceBundleFactory =3D resourceBundleFactory;


--===============8382871178110415493==--