From f8dc86f1b362c2906ea302eb56928b59156cd484 Mon Sep 17 00:00:00 2001 From: James Moger <james.moger@gitblit.com> Date: Wed, 27 Jul 2011 09:40:57 -0400 Subject: [PATCH] Renamed README for GutHub. --- src/com/gitblit/IStoredSettings.java | 122 ++++++++++++++++++++++++++++++++++++---- 1 files changed, 109 insertions(+), 13 deletions(-) diff --git a/src/com/gitblit/IStoredSettings.java b/src/com/gitblit/IStoredSettings.java index 7108c06..be836c9 100644 --- a/src/com/gitblit/IStoredSettings.java +++ b/src/com/gitblit/IStoredSettings.java @@ -24,31 +24,65 @@ import com.gitblit.utils.StringUtils; +/** + * Base class for stored settings implementations. + * + * @author James Moger + * + */ public abstract class IStoredSettings { protected final Logger logger; - + + protected final Properties overrides = new Properties(); + public IStoredSettings(Class<? extends IStoredSettings> clazz) { logger = LoggerFactory.getLogger(clazz); } - + protected abstract Properties read(); - public List<String> getAllKeys(String startingWith) { - startingWith = startingWith.toLowerCase(); - List<String> keys = new ArrayList<String>(); + private Properties getSettings() { Properties props = read(); - for (Object o : props.keySet()) { - String key = o.toString(); - if (key.toLowerCase().startsWith(startingWith)) { - keys.add(key); + props.putAll(overrides); + return props; + } + + /** + * Returns the list of keys whose name starts with the specified prefix. If + * the prefix is null or empty, all key names are returned. + * + * @param startingWith + * @return list of keys + */ + public List<String> getAllKeys(String startingWith) { + List<String> keys = new ArrayList<String>(); + Properties props = getSettings(); + if (StringUtils.isEmpty(startingWith)) { + keys.addAll(props.stringPropertyNames()); + } else { + startingWith = startingWith.toLowerCase(); + for (Object o : props.keySet()) { + String key = o.toString(); + if (key.toLowerCase().startsWith(startingWith)) { + keys.add(key); + } } } return keys; } + /** + * Returns the boolean value for the specified key. If the key does not + * exist or the value for the key can not be interpreted as a boolean, the + * defaultValue is returned. + * + * @param key + * @param defaultValue + * @return key value or defaultValue + */ public boolean getBoolean(String name, boolean defaultValue) { - Properties props = read(); + Properties props = getSettings(); if (props.containsKey(name)) { String value = props.getProperty(name); if (!StringUtils.isEmpty(value)) { @@ -58,8 +92,17 @@ return defaultValue; } + /** + * Returns the integer value for the specified key. If the key does not + * exist or the value for the key can not be interpreted as an integer, the + * defaultValue is returned. + * + * @param key + * @param defaultValue + * @return key value or defaultValue + */ public int getInteger(String name, int defaultValue) { - Properties props = read(); + Properties props = getSettings(); if (props.containsKey(name)) { try { String value = props.getProperty(name); @@ -74,8 +117,37 @@ return defaultValue; } + /** + * Returns the char value for the specified key. If the key does not exist + * or the value for the key can not be interpreted as a char, the + * defaultValue is returned. + * + * @param key + * @param defaultValue + * @return key value or defaultValue + */ + public char getChar(String name, char defaultValue) { + Properties props = getSettings(); + if (props.containsKey(name)) { + String value = props.getProperty(name); + if (!StringUtils.isEmpty(value)) { + return value.charAt(0); + } + } + return defaultValue; + } + + /** + * Returns the string value for the specified key. If the key does not exist + * or the value for the key can not be interpreted as a string, the + * defaultValue is returned. + * + * @param key + * @param defaultValue + * @return key value or defaultValue + */ public String getString(String name, String defaultValue) { - Properties props = read(); + Properties props = getSettings(); if (props.containsKey(name)) { String value = props.getProperty(name); if (value != null) { @@ -85,17 +157,41 @@ return defaultValue; } + /** + * Returns a list of space-separated strings from the specified key. + * + * @param name + * @return list of strings + */ public List<String> getStrings(String name) { return getStrings(name, " "); } + /** + * Returns a list of strings from the specified key using the specified + * string separator. + * + * @param name + * @param separator + * @return list of strings + */ public List<String> getStrings(String name, String separator) { List<String> strings = new ArrayList<String>(); - Properties props = read(); + Properties props = getSettings(); if (props.containsKey(name)) { String value = props.getProperty(name); strings = StringUtils.getStringsFromValue(value, separator); } return strings; } + + /** + * Override the specified key with the specified value. + * + * @param key + * @param value + */ + public void overrideSetting(String key, String value) { + overrides.put(key, value); + } } \ No newline at end of file -- Gitblit v1.9.1