/**
* Check if the setting is set into this {@link Bundle}.
*
- * @param id
+ * @param name
* the id of the setting to check
* @param includeDefaultValue
- * TRUE to only return false when the setting is not set AND
- * there is no default value
+ * TRUE to only return false when the setting is explicitly set
+ * to NULL (and not just "no set") in the change maps
*
* @return TRUE if the setting is set
*/
* @param def
* the default value when it is not present in the config file
*
- * @return the associated value, or NULL if not found (not present in the
- * resource file)
+ * @return the associated value, or <tt>def</tt> if not found (not present
+ * in the resource file)
*/
public String getString(E id, String def) {
return getString(id, def, -1);
/**
* Return the value associated to the given id as a {@link String}.
* <p>
- * If no value is associated, take the default one if any.
+ * If no value is associated (or if it is empty!), take the default one if
+ * any.
*
* @param id
* the id of the value to get
* the item number to get for an array of values, or -1 for
* non-arrays
*
- * @return the associated value, or NULL if not found (not present in the
- * resource file)
+ * @return the associated value, <tt>def</tt> if not found (not present in
+ * the resource file) or NULL if the item is specified (not -1) and
+ * does not exist
*/
public String getString(E id, String def, int item) {
String rep = getString(id.name(), null);
if (rep == null) {
- try {
- Meta meta = type.getDeclaredField(id.name()).getAnnotation(
- Meta.class);
- rep = meta.def();
- } catch (NoSuchFieldException e) {
- } catch (SecurityException e) {
- }
+ rep = getMetaDef(id.name());
}
- //TODO: is it ok? need to jDoc?
- if (rep == null || rep.isEmpty()) {
+ if (rep.isEmpty()) {
return def;
}
setString(id.name(), value);
} else {
List<String> values = getList(id);
- for (int i = values.size(); i < item; i++) {
- values.add(null);
- }
- values.set(item, value);
- setString(id.name(), BundleHelper.fromList(values));
+ setString(id.name(), BundleHelper.fromList(values, value, item));
}
}
* the id of the value to get
* @param suffix
* the runtime suffix
- * @param item
- * the item number to get for an array of values, or -1 for
- * non-arrays
* @param def
* the default value when it is not present in the config file
* @param item
* the item number to get for an array of values, or -1 for
* non-arrays
*
- * @return the associated value, or NULL if not found (not present in the
- * resource file)
+ * @return the associated value, <tt>def</tt> if not found (not present in
+ * the resource file), NULL if the item is specified (not -1) but
+ * does not exist and NULL if bad key
*/
public String getStringX(E id, String suffix, String def, int item) {
String key = id.name()
* @param def
* the default value when it is not present in the config file or
* if it is not a char value
+ * @param item
+ * the item number to get for an array of values, or -1 for
+ * non-arrays
*
* @return the associated value
*/
*
* @param id
* the id of the value to get
+ * @param def
+ * the default value when it is not present in the config file or
+ * if it is not a char value
*
* @return the associated value
*/
*
* @param id
* the id of the value to get
+ * @param def
+ * the default value when it is not present in the config file or
+ * if it is not a char value
+ * @param item
+ * the item number to get for an array of values, or -1 for
+ * non-arrays
*
* @return the associated value
*/
*
* @param id
* the id of the value to get
+ * @param def
+ * the default value when it is not present in the config file or
+ * if it is not a char value
*
* @return the associated list, empty if the value is empty, NULL if it is
* not found or cannot be parsed as a list
*
* @param id
* the id of the value to get
+ * @param def
+ * the default value when it is not present in the config file or
+ * if it is not a char value
+ * @param item
+ * the item number to get for an array of values, or -1 for
+ * non-arrays
*
* @return the associated list, empty if the value is empty, NULL if it is
* not found or cannot be parsed as a list
return changeMap.containsKey(key) || map.containsKey(key);
}
+ /**
+ * The default {@link Meta#def()} value for the given enumeration name.
+ *
+ * @param id
+ * the enumeration name (the "id")
+ *
+ * @return the def value in the {@link MetaInfo} or "" if none (never NULL)
+ */
+ protected String getMetaDef(String id) {
+ String rep = "";
+ try {
+ Meta meta = type.getDeclaredField(id).getAnnotation(Meta.class);
+ rep = meta.def();
+ } catch (NoSuchFieldException e) {
+ } catch (SecurityException e) {
+ }
+
+ if (rep == null) {
+ rep = "";
+ }
+
+ return rep;
+ }
+
/**
* Get the value for the given key if it exists in the internal map, or
* <tt>def</tt> if not.
+ * <p>
+ * DO NOT get the default meta value (MetaInfo.def()).
*
* @param key
* the key to check for
}
/**
- * Reset the backing map to the content of the given bundle, or with default
+ * Reset the backing map to the content of the given bundle, or with NULL
* values if bundle is NULL.
*
* @param bundle
*/
protected void resetMap(ResourceBundle bundle) {
this.map.clear();
- for (Field field : type.getDeclaredFields()) {
- try {
- Meta meta = field.getAnnotation(Meta.class);
- if (meta != null) {
- E id = Enum.valueOf(type, field.getName());
-
- String value;
- if (bundle != null) {
- value = bundle.getString(id.name());
- } else {
- value = meta.def();
+ if (bundle != null) {
+ for (Field field : type.getDeclaredFields()) {
+ try {
+ Meta meta = field.getAnnotation(Meta.class);
+ if (meta != null) {
+ E id = Enum.valueOf(type, field.getName());
+ String value = bundle.getString(id.name());
+ this.map.put(id.name(),
+ value == null ? null : value.trim());
}
-
- this.map.put(id.name(), value == null ? null : value.trim());
+ } catch (MissingResourceException e) {
}
- } catch (MissingResourceException e) {
}
}
}