/* * Copyright 2011 gitblit.com. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.gitblit; import java.util.ArrayList; import java.util.List; import java.util.Map; import java.util.Properties; import org.slf4j.Logger; import org.slf4j.LoggerFactory; 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 clazz) { logger = LoggerFactory.getLogger(clazz); } protected abstract Properties read(); private Properties getSettings() { Properties props = read(); 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 getAllKeys(String startingWith) { List keys = new ArrayList(); 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 = getSettings(); if (props.containsKey(name)) { String value = props.getProperty(name); if (!StringUtils.isEmpty(value)) { return Boolean.parseBoolean(value.trim()); } } 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 = getSettings(); if (props.containsKey(name)) { try { String value = props.getProperty(name); if (!StringUtils.isEmpty(value)) { return Integer.parseInt(value.trim()); } } catch (NumberFormatException e) { logger.warn("Failed to parse integer for " + name + " using default of " + defaultValue); } } 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.trim().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 = getSettings(); if (props.containsKey(name)) { String value = props.getProperty(name); if (value != null) { return value.trim(); } } return defaultValue; } /** * Returns a list of space-separated strings from the specified key. * * @param name * @return list of strings */ public List 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 getStrings(String name, String separator) { List strings = new ArrayList(); 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); } /** * Updates the values for the specified keys and persists the entire * configuration file. * * @param map * of key, value pairs * @return true if successful */ public abstract boolean saveSettings(Map updatedSettings); }