Class Config


  • public class Config
    extends Object
    Use this class to access the configuration settings for BASE.

    The configuration settings are always stored in a file named base.config. It should be located at the root of one of the paths in the CLASSPATH environment variable. For Tomcat this means it should be located in the WEB-INF/classes folder.

    Version:
    2.0
    Author:
    Nicklas
    • Field Detail

      • config

        private static Properties config
        Variable for holding the configuration properties.
      • overridden

        private static Properties overridden
        Properties that has been programmatically overridden.
      • isInitialised

        private static boolean isInitialised
      • configDir

        private static File configDir
      • locale

        private static Locale locale
    • Constructor Detail

      • Config

        public Config()
    • Method Detail

      • unload

        static void unload()
        Unload all settings.
      • setProperty

        public static void setProperty​(String key,
                                       String value)
        Programatically set a configuration property that overrides a configuration setting in the base.config file. This method should be called before the init() method is called (eg. before Application.start() is called). The configuration can't be changed once BASE has been started. Properties that has been overridden are automatically cleared when BASE is stopped (Application.stop(), unload()).
        Parameters:
        key - The name of the configuration property
        value - The value or null to remove the overridden property
        Since:
        2.16
      • getConfigDirectory

        public static File getConfigDirectory()
        Get the directory where the BASE configuration files are located.
        Returns:
        The directory as a java.io.File object
        Since:
        2.6
      • getString

        public static String getString​(String key)
        Get the configuration setting specified by key as a String value.
        Parameters:
        key - The key for the setting
        Returns:
        The value specified by key or null if it is not found
      • getRequiredString

        public static String getRequiredString​(String key,
                                               String message)
        Get a required configuration setting. If the setting doesn't exists or is empty the given message is thrown as a ConfigurationException
        Parameters:
        key - The key for the setting
        message - The error message to throw if the setting doesn't exists
        Returns:
        The value specified by key
        Since:
        3.0
      • getString

        public static String getString​(String key,
                                       String defaultValue)
        Get the configuration setting specified by key as a String value.
        Parameters:
        key - The key for the setting
        defaultValue - The value to return if the key is not found
        Returns:
        The value specified by key or defaultValue if it is not found or is empty
      • getInt

        public static int getInt​(String key)
        Get the configuration setting specified by key as an integer value.
        Parameters:
        key - The key for the setting
        Returns:
        The value specified by key or 0 if it is not found or is not a number
      • getInt

        public static int getInt​(String key,
                                 int defaultValue)
        Get the configuration setting specified by key as an integer value.
        Parameters:
        key - The key for the setting
        defaultValue - The value to return if the key is not found
        Returns:
        The value specified by key or defaultValue if it is not found
      • getLong

        public static long getLong​(String key,
                                   long defaultValue)
        Get the configuration setting specified by key as a long value.
        Parameters:
        key - The key for the setting
        defaultValue - The value to return if the key is not found
        Returns:
        The value specified by key or defaultValue if it is not found
      • getBoolean

        public static boolean getBoolean​(String key)
        Get the configuration setting specified by key as a boolean value. FALSE is returned if the setting doesn't exist, if it contains an empty string, or one of the values 'no', 'false' or '0'. In all other cases TRUE is returned.
        Parameters:
        key - The key for the setting
        Returns:
        The value specified by key
      • getCharset

        public static String getCharset()
        Get the default character set to use when no other has been specified. It reads the setting from the defaultCharset setting and uses ISO-8859-1 if not specified.
        Returns:
        The name of the default charset to use
        Since:
        2.1.1
      • getCommonCharsets

        public static SortedSet<String> getCommonCharsets()
        Get a set containing the most common character sets used by text files. The set is sorted by name.
        Returns:
        A sorted set
        Since:
        2.17
      • getAllCharsets

        public static SortedSet<String> getAllCharsets()
        Get a set containing all character sets known to the current java virtual machine. The set is sorted by name with the most common character sets first.
        Returns:
        A sorted set
        Since:
        2.17
      • getLocale

        public static Locale getLocale()
        Get the default locale configured for the server.
        Since:
        2.16