// ---------------------------------------------------------------------------- // Copyright 2007-2013, GeoTelematic Solutions, Inc. // All rights reserved // ---------------------------------------------------------------------------- // // 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. // // ---------------------------------------------------------------------------- // Description: // Support for hierarchical runtime properties // ---------------------------------------------------------------------------- // Change History: // 2006/03/26 Martin D. Flynn // -Initial release // 2006/04/23 Martin D. Flynn // -Changed support for default properties // 2006/06/30 Martin D. Flynn // -Repackaged // 2007/03/30 Martin D. Flynn // -Added support for immutable System properties // 2007/05/06 Martin D. Flynn // -Added support for checking invalid command-line args // 2007/06/13 Martin D. Flynn // -Catch 'SecurityException's when getting System properties. // 2007/08/09 Martin D. Flynn // -Changed the way this module searches for runtime config files. // 2007/09/16 Martin D. Flynn // -Added method 'insertKeyValues' // -Added support for key/value replace in config-file value strings // 2008/06/20 Martin D. Flynn // -Added 'System.getenv()' map checking // 2008/10/16 Martin D. Flynn // -Removed check for default value when an explicit default value is specified. // 2009/01/28 Martin D. Flynn // -Added custom key/value map option to 'insertKeyValues' method to allow // overriding runtime keys with custom key/value map. // -Added ability to specify a thread-temporary RTProperties instance. // 2009/02/05 Martin D. Flynn // -Added "reload()" method // 2009/04/02 Martin D. Flynn // -Set implied logging-level to "debug" when "-debugMode" specified on command-line. // 2009/06/01 Martin D. Flynn // -Fixed conversion from URL to File when URL contains '%' encoded hex // 2009/07/01 Martin D. Flynn // -Added support for returning BigInteger types // 2010/10/21 Martin D. Flynn // -Fixed Temporary property traversal (back to front). // 2012/02/03 Martin D. Flynn // -Also check for "debug" argument to set "debugMode". // 2012/05/27 Martin D. Flynn // -Added command-line option to merge property files. // 2012/09/02 Martin D. Flynn // -Added "getLongArray" and "getDoubleArray" methods // 2012/10/16 Martin D. Flynn // -Added support for saving the PID file // ---------------------------------------------------------------------------- package org.opengts.util; import java.io.*; import java.util.*; import java.net.*; import java.math.*; /** *** Provides static support for hierarchical runtime properties **/ public class RTConfig { // ------------------------------------------------------------------------ // Cannot initialize here, otherwise we would be unable to override 'configFile' //static { _startupInit(false); } // ------------------------------------------------------------------------ /** *** PropertySetter interface **/ public interface PropertySetter { public void setProperty(Object key, Object value); } /** *** Returns a PropertySetter for RTConfig *** @return An RTConfig PropertySetter **/ public static PropertySetter getPropertySetter() { return new PropertySetter() { public void setProperty(Object key, Object value) { if (key instanceof String) { RTConfig.setProperty((String)key, value); } else { RTConfig.setProperty(StringTools.trim(key), value); } } }; } // ------------------------------------------------------------------------ /** *** PropertyGetter interface **/ public interface PropertyGetter { public Object getProperty(Object key, Object dftValue); } /** *** Returns a PropertyGetter for RTConfig *** @return An RTConfig PropertyGetter **/ public static PropertyGetter getPropertyGetter() { return new PropertyGetter() { public Object getProperty(Object key, Object value) { if (key instanceof String) { return RTConfig.getProperty((String)key, value); } else { return RTConfig.getProperty(StringTools.trim(key), value); } } }; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static boolean ENABLE_ENVIRONMENT_VARIABLES = true; /** *** Sets if system environment variables will be loaded on next *** initialization/reload *** @param enable True if environment variables should be loaded **/ public static void setEnvironmentVariablesEnabled(boolean enable) { ENABLE_ENVIRONMENT_VARIABLES = enable; } /** *** Gets if system environment variables should be loaded *** @return True if environment variables should be loaded **/ public static boolean getEnvironmentVariablesEnabled() { return ENABLE_ENVIRONMENT_VARIABLES; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static boolean verbose = false; private static boolean quiet = false; // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static String localhostName = null; /** *** Lookup and return the local host name *** @return The local host name **/ public static String getHostName() { /* host name */ if (RTConfig.localhostName == null) { try { String hd = InetAddress.getLocalHost().getHostName(); int p = hd.indexOf("."); RTConfig.localhostName = (p >= 0)? hd.substring(0,p) : hd; } catch (UnknownHostException uhe) { RTConfig.localhostName = "UNKNOWN"; } } return RTConfig.localhostName; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static final int THREAD_LOCAL = 0; // ThreadLocal (explicitly set) properties private static final int RUNTIME_CONSTANT = THREAD_LOCAL + 1; // Runtime constant properties private static final int SERVLET_CONTEXT = RUNTIME_CONSTANT + 1; // Servlet Context properties private static final int COMMAND_LINE = SERVLET_CONTEXT + 1; // Command-line properties private static final int CONFIG_FILE = COMMAND_LINE + 1; // Config files properties private static final int SYSTEM_PROPS = CONFIG_FILE + 1; // Java System properties private static final int ENVIRONMENT = SYSTEM_PROPS + 1; // Environment variables private static RTProperties CFG_PROPERTIES[] = new RTProperties[ENVIRONMENT + 1]; /** *** Gets the configuration properties index name assocaited with the *** specified index *** @param ndx The configuration properties index name *** @return The configuration properties index name **/ public static String getConfigPropertiesIndexName(int ndx) { switch (ndx) { case THREAD_LOCAL : return "Thread"; case RUNTIME_CONSTANT : return "RTConst"; case SERVLET_CONTEXT : return "Servlet"; case COMMAND_LINE : return "CmdLine"; case CONFIG_FILE : return "CfgFile"; case SYSTEM_PROPS : return "SysProp"; case ENVIRONMENT : return "EnvVars"; default : return "Unk(" + ndx + ")"; } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static ThreadLocal> CFG_THREAD_TEMPORARY = null; /** *** Prints the temporary RTProperties instances to stdout *** @param msg Displayed message header **/ public static void printTemporaryProperties(String msg) { if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if (rtpStack != null) { int level = 1; // back to front for (int r = rtpStack.size() - 1; r >= 0; r--) { RTProperties rtp = rtpStack.get(r); rtp.printProperties(msg + " #" + level); level++; } } } } /** *** Returns the temporary RTProperties instance that contains *** the specified key *** @return The temporary RTProperties instance that contains *** the specified key **/ public static RTProperties getTemporaryProperties(String key) { /* find temporary properties that has the specified key */ if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if (rtpStack != null) { // back to front for (int r = rtpStack.size() - 1; r >= 0; r--) { RTProperties rtp = rtpStack.get(r); if (rtp.hasProperty(key)) { return rtp; } } } } /* not found */ return null; } /** *** Pushes the RTProperties instance onto a temporary stack *** for the current thread *** @param props The RTProperties instance **/ public static void pushTemporaryProperties(RTProperties props) { /* ignore if properties are null */ if (props == null) { Print.logStackTrace("**** Attempting to push a null RTProperties instance!"); return; } /* create the ThreadLocal instance */ if (CFG_THREAD_TEMPORARY == null) { synchronized (CFG_PROPERTIES) { if (CFG_THREAD_TEMPORARY == null) { // likely still null after lock CFG_THREAD_TEMPORARY = new ThreadLocal>(); } } } /* get the current thread property stack */ Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if (rtpStack == null) { rtpStack = new Stack(); CFG_THREAD_TEMPORARY.set(rtpStack); } /* push the properties onto the stack */ rtpStack.push(props); } /** *** Pops the last temporary RTProperties instance for the *** current thread *** @param props The RTProperties instance that is the *** expected entry on the top of the stack **/ public static void popTemporaryProperties(RTProperties props) { /* remove the last RTProperties from the list [LIFO] */ if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if ((rtpStack != null) && !rtpStack.empty()) { /* pop last RTProperties entry */ RTProperties rtp = rtpStack.pop(); if ((props != null) && (props != rtp)) { Print.logStackTrace("Unexpected RTProperties at top of stack"); } //Print.logInfo("Stack size: %d", rtpStack.size()); /* remove Stack if empty */ if (rtpStack.empty()) { // discard Stack (garbage collect) CFG_THREAD_TEMPORARY.set(null); } } else if (props != null) { /* warning */ Print.logStackTrace("RTProperties Stack is already empty"); } } } /** *** Clears the temporary RTProperties stack for the *** current thread **/ public static void popAllTemporaryProperties() { /* remove the last RTProperties from the list [LIFO] */ if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if ((rtpStack != null) && !rtpStack.empty()) { /* clear RTProperties stack */ rtpStack.clear(); CFG_THREAD_TEMPORARY.set(null); } } } /** *** Gets the temporary RTProperties stack size (for current *** thread) *** @return The temporary RTProperties stack size **/ public static int getTemporaryPropertiesStackSize() { if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); return (rtpStack != null)? rtpStack.size() : 0; } else { return 0; } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets the thread local RTProperties instance *** @return The thread local RTProperties **/ public static RTProperties getThreadProperties() { if (CFG_PROPERTIES[THREAD_LOCAL] == null) { synchronized (CFG_PROPERTIES) { if (CFG_PROPERTIES[THREAD_LOCAL] == null) { CFG_PROPERTIES[THREAD_LOCAL] = new RTProperties(new ThreadLocalMap()); } } } return CFG_PROPERTIES[THREAD_LOCAL]; } /** *** Gets the runtime constant properties RTProperties instance *** @return The runtime constant properties **/ public static RTProperties getRuntimeConstantProperties() { if (CFG_PROPERTIES[RUNTIME_CONSTANT] == null) { synchronized (CFG_PROPERTIES) { if (CFG_PROPERTIES[RUNTIME_CONSTANT] == null) { CFG_PROPERTIES[RUNTIME_CONSTANT] = new RTProperties(); } } } return CFG_PROPERTIES[RUNTIME_CONSTANT]; } /** *** Gets the serverlet context properties RTProperties instance *** @return The serverlet context properties instance **/ public static RTProperties getServletContextProperties() { return CFG_PROPERTIES[SERVLET_CONTEXT]; // may be null if not initialized } /** *** Gets the command line properties RTProperties instance *** @return The command line properties **/ public static RTProperties getCommandLineProperties() { return CFG_PROPERTIES[COMMAND_LINE]; // may be null if not initialized } /** *** Gets the RTProperties instance from the config file *** @return The properties obtained from the config file **/ public static RTProperties getConfigFileProperties() { if (CFG_PROPERTIES[CONFIG_FILE] == null) { // this should have been initialized before, but force initialization now if (RTConfig.verbose) { Print.logInfo("Late initialization!!!"); } _startupInit(false); } if (CFG_PROPERTIES[CONFIG_FILE] != null) { return CFG_PROPERTIES[CONFIG_FILE]; } else { Print.sysPrintln("'RTConfig.getConfigFileProperties()' returning temporary RTProperties"); return new RTProperties(); } } /** *** Gets the RTProperties instance representing the system *** properties. Values obtained from System.getProperties() *** @return The RTProperties instance representing the system *** properties. *** @see System#getProperties **/ public static RTProperties getSystemProperties() { if (CFG_PROPERTIES[SYSTEM_PROPS] == null) { // this should have been initialized before, but force initialization now if (RTConfig.verbose) { Print.logInfo("Late initialization!!!"); } _startupInit(false); } return CFG_PROPERTIES[SYSTEM_PROPS]; } // ------------------------------------------------------------------------ /** *** Returns true if the command-line properties have been defined *** @return True if the command-line properties have been defined **/ public static boolean isCommandLine() { return (RTConfig.getCommandLineProperties() != null); } /** *** Returns true if the current context is likely a servlet *** @return True if the current context is likely a servlet **/ public static boolean isTrueServlet() { // A 'fake' servlet is one where the command-line app has called "setWebApp(true)" return (!RTConfig.isCommandLine() && RTConfig.isWebApp()); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Returns the RTProperties for the specified key *** @param key The key *** @param dftOk True to check defaults, if not found elsewhere *** @return The RTProperties **/ public static RTProperties getPropertiesForKey(String key, boolean dftOk) { if (key != null) { /* initialized? */ if (!isInitialized()) { // 'Print._println...' used here to eliminate possible recursion stack-overflow //Print._println(null, "ConfigFile not yet loaded"); //Thread.dumpStack(); // continue ... } /* first try the thread local temporary properties */ RTProperties tempProps = RTConfig.getTemporaryProperties(key); if (tempProps != null) { //if (key.equals(testKey)) System.out.println("RTConfig.getPropertiesForKey: Found "+testKey+" @ " + getTemporaryProperties()); return tempProps; } /* look for key in our property list stack */ //String testKey = RTKey.LOG_LEVEL_HEADER; for (int i = 0; i < CFG_PROPERTIES.length; i++) { RTProperties rtProps = CFG_PROPERTIES[i]; if ((rtProps != null) && rtProps.hasProperty(key)) { //if (key.equals(testKey)) System.out.println("RTConfig.getPropertiesForKey: Found "+testKey+" @ " + getConfigPropertiesIndexName(i)); return rtProps; } } /* still not found, try the default properties */ if (dftOk) { RTProperties dftProps = RTKey.getDefaultProperties(); if ((dftProps != null) && dftProps.hasProperty(key)) { //if (key.equals(testKey)) System.out.println("RTConfig.getPropertiesForKey: Found "+testKey+" in defaults"); return dftProps; } } } return null; } /** *** Returns the RTProperties instance in which the key is defined *** @param key The key array *** @param dftOk True to check defaults, if not found elsewhere *** @return The RTProperties **/ public static RTProperties getPropertiesForKey(String key[], boolean dftOk) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOk); if (rtp != null) { return rtp; } } } return null; } // ------------------------------------------------------------------------ /** *** Returns the name of the RTProperties location for the specified key *** @param key The key *** @return The name of the RTProperties location **/ public static String findPropertiesForKey(String key) { if (key != null) { /* first try the thread local temporary properties */ RTProperties tempProps = RTConfig.getTemporaryProperties(key); if (tempProps != null) { return "Temporary"; } /* look for key in our property list stack */ for (int i = 0; i < CFG_PROPERTIES.length; i++) { RTProperties rtProps = CFG_PROPERTIES[i]; if ((rtProps != null) && rtProps.hasProperty(key)) { return getConfigPropertiesIndexName(i); } } /* still not found, try the default properties */ RTProperties dftProps = RTKey.getDefaultProperties(); if ((dftProps != null) && dftProps.hasProperty(key)) { return "Defaults"; } } return null; } /** *** Returns the name of the RTProperties location for the specified key *** @param key The key *** @return The name of the RTProperties location **/ public static String findPropertiesForKey(String key[]) { if (key != null) { for (int i = 0; i < key.length; i++) { String name = findPropertiesForKey(key[i]); if (!StringTools.isBlank(name)) { return name; } } } return null; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets the command line properties and initializes RTConfig *** if it hasn't been. Initialization is held off untill this method is *** called so 'configFile' can be overridden on the command line. *** @param argv The command line arguments **/ public static int setCommandLineArgs(String argv[]) { return RTConfig.setCommandLineArgs(argv, null); } /** *** Sets the command line properties and initializes RTConfig *** if it hasn't been. Initialization is held off untill this method is *** called so 'configFile' can be overridden on the command line. *** @param argv The command line arguments *** @param keyAttr A list of expected keys and attributes. See *** {@link RTProperties#validateKeyAttributes} *** @throws RuntimeException If invalid arguments are specified **/ public static int setCommandLineArgs(String argv[], String keyAttr[]) { RTProperties cmdArgs = (argv != null)? new RTProperties(argv) : new RTProperties(); RTConfig.setCommandLineArgs(cmdArgs, false); if (!ListTools.isEmpty(keyAttr) && !cmdArgs.validateKeyAttributes(keyAttr,true)) { throw new RuntimeException("Invalid arguments specified"); } return cmdArgs.getNextCommandLineArgumentIndex(); } /** *** Sets the command line properties and initializes RTConfig *** if it hasn't been. Initialization is held off untill this method is *** called so 'configFile' can be overridden on the command line. *** @param cmdLineProps The command line properties **/ public static void setCommandLineArgs(RTProperties cmdLineProps) { if (cmdLineProps != null) { RTConfig.setCommandLineArgs(cmdLineProps, false); } else { RTConfig.setCommandLineArgs(new RTProperties(), false); } } /** *** Sets the command line properties and initializes RTConfig *** if it hasn't been. Initialization is held off untill this method is *** called so 'configFile' can be overridden on the command line. *** @param argv The command line arguments *** @param testMode does nothing, ignored? [CHECK] [ASK] *** @return The next command-line argument, or '-1' if there are no additional *** command-line arguments. See *** {@link RTProperties#getNextCommandLineArgumentIndex} **/ public static int setCommandLineArgs(String argv[], boolean testMode) { RTProperties cmdArgs = (argv != null)? new RTProperties(argv) : new RTProperties(); RTConfig.setCommandLineArgs(cmdArgs, testMode); return cmdArgs.getNextCommandLineArgumentIndex(); } /** *** Sets the command line properties and initializes RTConfig *** if it hasn't been. Initialization is held off untill this method is *** called so 'configFile' can be overridden on the command line. *** @param cmdLineProps The command line properties *** @param testMode does nothing, ignored? [CHECK] [ASK] **/ public static void setCommandLineArgs(RTProperties cmdLineProps, boolean testMode) { if (cmdLineProps != null) { cmdLineProps.setIgnoreKeyCase(true); //Class mainClass = RTConfig.getMainClass(); // may be null //if (mainClass != null) { // cmdLineProps.setProperty(RTKey.MAIN_CLASS, mainClass); // sets tha actual class // String mainClassStr = StringTools.className(mainClass); // int p = mainClassStr.lastIndexOf("."); // String contextName = (p >= 0)? mainClassStr.substring(p+1) : mainClassStr; // RTConfig.setContextName(contextName); //} if (CFG_PROPERTIES[COMMAND_LINE] == null) { // first initialization CFG_PROPERTIES[COMMAND_LINE] = cmdLineProps; _startupInit(true); // initialize now to allow for overriding 'configFile' } else { // subsequent re-initialization CFG_PROPERTIES[COMMAND_LINE].setProperties(cmdLineProps); } } else { _startupInit(true); } } // ------------------------------------------------------------------------ private static Set _parseArgs(Object argv, Set set) { if ((argv != null) && (set != null)) { if (argv instanceof Object[]) { Object a[] = (Object[])argv; for (int i = 0; i < a.length; i++) { RTConfig._parseArgs(a[i], set); } } else { set.add(argv.toString()); } } return set; } /** *** Validates the command line arguments in RTConfig against *** a single string or array of strings listing valid arguments *** @param argv A single or array of valid arguments *** @return Array of keys of the invalid/unrecognised arguments **/ public static String[] validateCommandLineArgs(Object argv) { RTProperties cmdLineProps = RTConfig.getCommandLineProperties(); if (cmdLineProps != null) { java.util.List badArgs = new Vector(); Set argSet = new HashSet(); //argSet.add(RTKey.MAIN_CLASS); RTConfig._parseArgs(argv, argSet); for (Iterator keys = cmdLineProps.keyIterator(); keys.hasNext();) { String k = (String)keys.next(); if (RTKey.hasDefault(k) || RTKey.COMMAND_LINE_CONF.equals(k)) { // defaulted keys and "-conf", "-configFile", "-configFileDir" are ok } else if (!argSet.contains(k)) { badArgs.add(k); } } return badArgs.isEmpty()? null : badArgs.toArray(new String[badArgs.size()]); } else { return null; } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets the Servlet context properties. *** @param props A map containing the Servlet context properties **/ public static void _setServletContextProperties(RTProperties props) { CFG_PROPERTIES[SERVLET_CONTEXT] = props; } /** *** Sets the runtime mode to 'WebApp' and initializes the Servlet context *** properties. *** @param props A map containing the Servlet context properties **/ public static void setServletContextProperties(Map props) { //RTConfig.verbose = true; // default to verbose RTConfig.setWebApp(true); // force isWebapp=true RTConfig._setServletContextProperties(new RTProperties(props)); RTConfig._startupInit(false); } /** *** Clears the runtime Servlet context properties *** This is intended to be called when the Servlet context is destroyed *** @param servlet The servlet instance (not currently used) **/ public static void clearServletContextProperties(Object servlet) { RTConfig._setServletContextProperties(null); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static int _didStartupInit = 0; // 0=not initialized, 1=initializing, 2=initialized private static boolean _allowSysPropChange = false; // valid iff _didStartupInit!=0 private static URL _foundConfigURL = null; private static File _foundConfigFile = null; /** *** Returns true if the Runtime config is in the process of being initialized *** @return True if in the process of initializing **/ public static boolean isInitializing() { return (_didStartupInit == 1); } /** *** Returns true if the Runtime config has been initialized *** @return True if initialized **/ public static boolean isInitialized() { return (_didStartupInit == 2); } /** *** Returns the URL of the loaded config file *** @return The URL of the loaded config file **/ public static URL getLoadedConfigURL() { return _foundConfigURL; } /** *** Returns the File instance of the loaded config file, or null if the runtime config *** was not loaded from a file. *** @return The File instance of the loaded config file. **/ public static File getLoadedConfigFile() { if (_foundConfigFile == null) { if ((_foundConfigURL != null) && (_foundConfigURL.getProtocol().equalsIgnoreCase("file"))) { try { _foundConfigFile = FileTools.toFile(_foundConfigURL); } catch (URISyntaxException use) { Print.logException("Unable to convert URL to File: " + _foundConfigURL, use); } } } return _foundConfigFile; } /** *** Returns the File instance of the loaded config file directory, or null if the runtime config *** was not loaded from a file. *** @return The File instance of the loaded config file directory. **/ public static File getLoadedConfigDir() { File cfgFile = RTConfig.getLoadedConfigFile(); if (cfgFile != null) { return cfgFile.getParentFile(); } else { return null; } } /** *** Returns the config file URL *** @return The config file URL **/ protected static URL getConfigURL() { try{ URL cfgURL = RTConfig._getConfigURL(); if (cfgURL != null) { if (RTConfig.verbose) { Print.logInfo("Config URL found at " + cfgURL); } return cfgURL; } else { if (!RTConfig.quiet) { Print.logWarn("No valid config URL was found"); } return null; } } catch (MalformedURLException mue) { Print.logError("Invalid URL: " + mue); } catch (Throwable t) { Print.logException("Invalid URL", t); } return null; } /** *** Searches for, and returns the URL of the runtime configuration file *** @return The URL of the runtime configuration file **/ protected static URL _getConfigURL() throws MalformedURLException { // This module checks for the runtime config file in the following order: // - Explicit "-configFile=" specification // - Explicit "-conf=" specification (if command-line) // - Resource "[default|webapp]_.conf" // - Resource "[default|webapp].conf" // - Servlet "/WEB-INF/webapp_.conf" (if servlet) // - Servlet "/WEB-INF/webapp.conf" (if servlet) // - FileSystem "/[default|webapp]_.conf" // - FileSystem "/[default|webapp].conf" /* init */ String hostName = RTConfig.getHostName(); // should not be null RTProperties cmdLineProps = RTConfig.getCommandLineProperties(); RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); boolean isCommandLine = (cmdLineProps != null); boolean isTrueServlet = !isCommandLine && RTConfig.isWebApp(); // A 'fake' servlet is one where the command-line app called "setWebApp(true)" /* Check for "-configFile=" */ if (RTConfig.hasProperty(RTKey.CONFIG_FILE,false)) { File cfgFile = RTConfig.getFile(RTKey.CONFIG_FILE); if (RTConfig.hasProperty(RTKey.CONFIG_FILE_DIR,false)) { File cfgDir = RTConfig.getFile(RTKey.CONFIG_FILE_DIR); cfgFile = new File(cfgDir, cfgFile.toString()); } if (cfgFile.isFile()) { return FileTools.toURL(cfgFile); } else { Print.logError("Explicitly specified config file does not exist: " + cfgFile); return null; } } /* Check for command-line "-conf=" */ if (isCommandLine) { //Print.logInfo("Search Command-line ..."); /* check for alternate command line override '-conf=' */ File cfgFile = cmdLineProps.getFile(RTKey.COMMAND_LINE_CONF, null); if (cfgFile != null) { if (RTConfig.hasProperty(RTKey.CONFIG_FILE_DIR,false)) { File cfgDir = RTConfig.getFile(RTKey.CONFIG_FILE_DIR); cfgFile = new File(cfgDir, cfgFile.toString()); } if (cfgFile.isFile()) { URL fileURL = FileTools.toURL(cfgFile); return fileURL; } else { Print.logError("Explicitly specified config file does not exist: " + cfgFile); return null; } } else { // continue } } else { //Print.logInfo("Not a Command-Line ..."); // continue } /* separate directory from path */ File rtCfgDir = null; File rtCfgFile = null; if (isTrueServlet) { rtCfgDir = RTConfig.getFile(RTKey.CONFIG_FILE_DIR); rtCfgFile = RTConfig.getFile(RTKey.WEBAPP_FILE); // should be simply "webapp.conf" } else { rtCfgFile = RTConfig.getFile(RTKey.CONFIG_FILE); if (rtCfgFile.isAbsolute()) { rtCfgDir = rtCfgFile.getParentFile(); rtCfgFile = new File(rtCfgFile.getName()); } else { File cf = new File(RTConfig.getFile(RTKey.CONFIG_FILE_DIR), rtCfgFile.toString()); rtCfgDir = cf.getParentFile(); rtCfgFile = new File(cf.getName()); } } /* separate file name from extension */ String cfgFileName = rtCfgFile.toString(); int cfgExtPos = cfgFileName.lastIndexOf("."); String cfgName = (cfgExtPos >= 0)? cfgFileName.substring(0,cfgExtPos) : cfgFileName; String cfgExtn = (cfgExtPos >= 0)? cfgFileName.substring(cfgExtPos ) : ""; /* special servlet context config files */ if (isTrueServlet) { //Print.logInfo("Searching Servlet context for config file ..."); // RTConfigContextListener check if (RTConfig.getServletContextProperties() == null) { // If we are here, then this means that 'ContextListener' was not specified for this // context and we are initializing late (possible too late). Print.logWarn("---------------------------------------------------------------------"); Print.logWarn("** WebApp: " + RTConfig.getServletClassName()); Print.logWarn("** Appears to be missing the 'RTConfigContextListener' initialization"); Print.logWarn("---------------------------------------------------------------------"); } // check "/[WEB-INF/]webapp[_].conf" String ctxPath = RTConfig.getContextPath(); if (!StringTools.isBlank(ctxPath)) { File web_inf = new File(ctxPath, "WEB-INF"); // Check for "/WEB-INF/webapp_.conf" File webInfHostFile = new File(web_inf, cfgName + "_" + hostName + cfgExtn); if (webInfHostFile.isFile()) { //Print.logInfo("Servlet - Found at: " + webInfHostFile); return FileTools.toURL(webInfHostFile); } // Check for "/WEB-INF/webapp.conf" File webInfFile = new File(web_inf, cfgFileName); if (webInfFile.isFile()) { //Print.logInfo("Servlet - Found at: " + webInfFile); return FileTools.toURL(webInfFile); } Print.logWarn("Config file not found in Servlet: " + RTConfig.getServletClassName()); } else { Print.logWarn("Servlet is missing 'CONTEXT_PATH' [1]: " + RTConfig.getServletClassName()); } // continue } else { //Print.logWarn("Not a true Servlet ..."); // continue } /* check for config file in resources */ Class mainClass = RTConfig.getMainClass(); if (mainClass != null) { // NOTE: Checking a ClassLoader's resources will check the CLASSPATH, which may also // check the current directory (directory from which this JVM was started). This is // important to note if Tomcat happened be started with $GTS_HOME as the current // directory. //Print.logInfo("Searching Main class resoures ..."); //Print.logInfo("CLASSPATH: " + System.getProperty("java.class.path","?")); try { ClassLoader mainClassLoader = mainClass.getClassLoader(); if (mainClassLoader == null) { // bootstrap classloader mainClassLoader = ClassLoader.getSystemClassLoader(); // may still be null } if (mainClassLoader != null) { // Check for resource "default_.conf" URL cfgHostRes = mainClassLoader.getResource(cfgName + "_" + hostName + cfgExtn); if (cfgHostRes != null) { //Print.logInfo("MainClass - Found at: " + cfgHostRes); return cfgHostRes; } // Check for resource "default.conf" URL cfgRes = mainClassLoader.getResource(cfgFileName); if (cfgRes != null) { //Print.logInfo("MainClass - Found at: " + cfgRes); return cfgRes; } } else { Print.logWarn("System class loader is null"); // continue } } catch (Throwable t) { Print.logException("Error retrieving class loader", t); // continue } } else { Print.logInfo("Main class not found ..."); } // Check for "/[default|webapp]_.conf" File cfgDirHostFile = new File(rtCfgDir, cfgName + "_" + hostName + cfgExtn); if (cfgDirHostFile.isFile()) { return FileTools.toURL(cfgDirHostFile); } //Check for "/[default|webapp].conf" File cfgDirFile = new File(rtCfgDir, rtCfgFile.toString()); if (cfgDirFile.isFile()) { return FileTools.toURL(cfgDirFile); } /* no config file */ return null; } /** *** Returns true if the specified file exists as a resource to the current main JVM class *** @param file The file to check *** @return True if the file was found as a resource in the current main class **/ /* protected static boolean _resourceExists(File file) { if (file == null) { return false; } Class mainClass = RTConfig.getMainClass(); Print.logInfo("MainClass: " + mainClass); URL cfgRes = (mainClass != null)? mainClass.getClassLoader().getResource(file.toString()) : null; if (cfgRes != null) { Print.logInfo("ConfigFile found as resource: " + file); return true; } else { Print.logInfo("ConfigFile NOT found as resource: " + file); return false; } } */ // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Reloads all runtime config properties **/ public static synchronized void reload() { /* clear init flags */ if (_didStartupInit == 0) { Print.logWarn("Calling 'reload' when initialization was never called in the first place"); } else { Print.logInfo("Reloading RTConfig ..."); } _didStartupInit = 0; /* reset */ // note: this 'synchronized' method is calling '_startupInit', which is also synchronized. RTConfig._startupInit(_allowSysPropChange); } /** *** Runtime config initialization *** @param allowChangeSystemProperties True to allow System properties update, false for read-only **/ protected static synchronized void _startupInit(boolean allowChangeSystemProperties) { // Note: this method is synchronized /* check init */ if (_didStartupInit == 2) { // already initialized return; } else if (_didStartupInit == 1) { Print.logError("_startupInit' is already initializing!"); Print.logStackTrace("_startupInit' is already initializing!"); return; } _allowSysPropChange = allowChangeSystemProperties; _didStartupInit = 1; /* local properties */ RTProperties cmdLineProps = RTConfig.getCommandLineProperties(); RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); /* verbose? */ if (RTConfig.hasProperty(RTKey.RT_VERBOSE, false)) { RTConfig.verbose = RTConfig.getBoolean(RTKey.RT_VERBOSE, false); } if (RTConfig.hasProperty(RTKey.RT_QUIET, false)) { RTConfig.quiet = RTConfig.getBoolean(RTKey.RT_QUIET, false); if (RTConfig.quiet) { RTConfig.verbose = false; } } /* debug mode log level */ if (RTConfig.hasProperty(RTKey.DEBUG,false/*NoDefaults*/)) { // "debug" explicitly specified RTProperties debugRTP = getPropertiesForKey(RTKey.DEBUG, false/*NoDefaults*/); //Print.logError("Found '-debug': " + debugRTP.getBoolean(RTKey.DEBUG,false)); if (!RTConfig.hasProperty(RTKey.DEBUG_MODE,false/*NoDefaults*/)) { // "debugMode" not specified, set to match "debug" boolean debug = debugRTP.getBoolean(RTKey.DEBUG,false); //Print.logError("Setting '-debugMode': " + debug); debugRTP.setProperty(RTKey.DEBUG_MODE, debug); // set at same location as "debugMode" } else { // "debugMode" also explicitly specified, set "debug" to match boolean debug = RTConfig.getBoolean(RTKey.DEBUG_MODE,true,false); //Print.logError("Also Found '-debugMode', setting '-debug': " + debug); debugRTP.setProperty(RTKey.DEBUG, debug); } } if (RTConfig.getBoolean(RTKey.DEBUG_MODE)) { // "-debugMode" specified on command-line, set implied logging level to DEBUG if ((cmdLineProps != null) && !cmdLineProps.hasProperty(RTKey.LOG_LEVEL)) { cmdLineProps.setString(RTKey.LOG_LEVEL,"debug"); } Print.setLogLevel(Print.LOG_DEBUG); } /* config file/URL */ _foundConfigFile = null; _foundConfigURL = RTConfig.getConfigURL(); /* RuntimeConstant defaults */ // context name if ((cmdLineProps != null) && !RTConfig.hasContextName()) { String ctxName = cmdLineProps.getString(RTKey.CONTEXT_NAME,cmdLineProps.getString(RTKey.RT_CONTEXT_NAME,null)); if (!StringTools.isBlank(ctxName)) { RTConfig.setContextName(ctxName); } } // context path if ((cmdLineProps != null) && !RTConfig.hasContextPath()) { String ctxPath = cmdLineProps.getString(RTKey.CONTEXT_PATH,cmdLineProps.getString(RTKey.RT_CONTEXT_PATH,null)); if (!StringTools.isBlank(ctxPath)) { RTConfig.setContextPath(ctxPath); } } // main command class/jar if (!constantProps.hasProperty(RTKey.MAIN_COMMAND)) { // java.class.path=/gts/build/lib/file.jar // sun.java.command="/gts/build/lib/file.jar ..." String sun_java_command = System.getProperty("sun.java.command",null); String java_class_path = System.getProperty("java.class.path",null); String cmds[] = StringTools.split(sun_java_command, ' '); String path[] = StringTools.split(java_class_path , File.pathSeparatorChar); String mainCmd = (cmds.length > 0)? cmds[0] : ""; constantProps.setProperty(RTKey.MAIN_COMMAND, mainCmd); //Print.logInfo("Main Command: " + mainCmd); } // main jar if (!constantProps.hasProperty(RTKey.MAIN_JAR)) { // java.class.path=/gts/build/lib/file.jar String sun_java_command = System.getProperty("sun.java.command",null); String java_class_path = System.getProperty("java.class.path",null); String cmds[] = StringTools.split(sun_java_command, ' '); String path[] = StringTools.split(java_class_path, File.pathSeparatorChar); String mainJar = null; //Print.logInfo("Cmds: " + StringTools.join(cmds," | ")); //Print.logInfo("Path: " + StringTools.join(path," | ")); if ((cmds.length > 0) && StringTools.endsWithIgnoreCase(cmds[0],".jar")) { // this means that the jars manifest contains the name of the entry point mainJar = cmds[0]; } else if ((path.length == 1) && StringTools.endsWithIgnoreCase(path[0],".jar")) { // a single jar in the class path, this is the likely jar file mainJar = path[0]; } else { // either not a main jar, or we can't determine which jar the main class came from mainJar = ""; // unknown } constantProps.setProperty(RTKey.MAIN_JAR, mainJar); //Print.logInfo("Main Jar: " + mainJar); } // main class if (!constantProps.hasProperty(RTKey.MAIN_CLASS)) { Class mainClass = RTConfig.getMainClass(); // may be null if (mainClass != null) { constantProps.setProperty(RTKey.MAIN_CLASS, mainClass); // sets the actual class // Context name if (!RTConfig.hasContextName()) { // skip if already set by servlet context // extract parent package name String mainClassStr = StringTools.className(mainClass); //Print.logInfo("MainClass: " + mainClassStr); int c = mainClassStr.lastIndexOf("."); if (c >= 0) { String pkgName = mainClassStr.substring(0,c); // "x.y.z.Main" ==> "x.y.z" int p = pkgName.lastIndexOf("."); if (p >= 0) { // extract parent directory package name ("x.y.z.Main" ==> "z") String ctxName = pkgName.substring(p+1); RTConfig.setContextName(ctxName); } else { // single directory package name ("z.Main" ==> "z") RTConfig.setContextName(pkgName); } } else { // apparently the runtime class has no package name ("Main" ==> "Main") RTConfig.setContextName(mainClassStr); } } } } // default context path if (!RTConfig.hasContextPath() && (_foundConfigURL != null) && _foundConfigURL.getProtocol().equalsIgnoreCase("file")) { // skip if already set by servlet context try { File cfgFile = FileTools.toFile(_foundConfigURL); String contextPath = null; try { contextPath = cfgFile.getCanonicalFile().getParent(); } catch (IOException ioe) { contextPath = cfgFile.getParent(); } RTConfig.setContextPath(contextPath); } catch (URISyntaxException use) { Print.logException("Unable to convert URL to File: " + _foundConfigURL, use); } } // host name if (!constantProps.hasProperty(RTKey.HOST_NAME)) { try { String hostName = InetAddress.getLocalHost().getHostName(); InetAddress hostIP = InetAddress.getByName(hostName); String hostIPStr = (hostIP != null)? hostIP.toString() : ""; int h = hostIPStr.indexOf("/"); if (h >= 0) { hostIPStr = hostIPStr.substring(h+1); } constantProps.setProperty(RTKey.HOST_NAME, hostName ); constantProps.setProperty(RTKey.HOST_IP , hostIPStr); } catch (UnknownHostException uhe) { Print.logException("Error obtaining local host name (name not specified in '/etc/hosts'?)", uhe); } } // OS type if (!constantProps.hasProperty(RTKey.OS_TYPE)) { int osType = OSTools.getOSType(); constantProps.setProperty(RTKey.OS_TYPE , OSTools.getOSTypeName(osType,false)); constantProps.setProperty(RTKey.OS_SUBTYPE, OSTools.getOSTypeName(osType,true )); } // Process ID if (!constantProps.hasProperty(RTKey.PROCESS_ID)) { int pid = OSTools.getProcessID(); constantProps.setProperty(RTKey.PROCESS_ID, pid); if ((cmdLineProps != null) && cmdLineProps.hasProperty(RTKey.RT_PID_FILE)) { File pidFile = cmdLineProps.getFile(RTKey.RT_PID_FILE,null); if (pidFile != null) { boolean ok = OSTools.writePidFile(pidFile, true/*overwrite*/); if (ok) { //Print.logInfo("PID file written: " + pidFile); } else { Print.logError("Unable to create PID file: " + pidFile); } } } } /* System properties */ Properties propMap = null; if (_allowSysPropChange) { try { propMap = System.getProperties(); } catch (SecurityException se) { // SecurityException, AccessControlException Print.sysPrintln("ERROR: Attempting to call 'System.getProperties()': " + se); } } else { propMap = new Properties(); for (Iterator i = RTKey.getRuntimeKeyIterator(); i.hasNext();) { String key = (String)i.next(); try { String val = System.getProperty(key, null); if (val != null) { propMap.setProperty(key, val); } } catch (SecurityException se) { // SecurityException, AccessControlException Print.sysPrintln("Attempting to get System property '" + key + "': " + se); } } } CFG_PROPERTIES[SYSTEM_PROPS] = new RTProperties(propMap); /* environment variables */ if (RTConfig.getEnvironmentVariablesEnabled()) { try { Map envMap = System.getenv(); //for (String k:envMap.keySet()) {String v = envMap.get(k);Print.logInfo("Env: "+k+"==>"+v);} CFG_PROPERTIES[ENVIRONMENT] = new RTProperties(envMap); //CFG_PROPERTIES[ENVIRONMENT].setAllowBlankValues(false); } catch (Throwable th) { // security error? CFG_PROPERTIES[ENVIRONMENT] = null; } } /* load config file/URL */ if (_foundConfigURL != null) { CFG_PROPERTIES[CONFIG_FILE] = new RTProperties(_foundConfigURL); if (RTConfig.verbose) { Print.logInfo("Loaded config URL: " + _foundConfigURL); } } else { //String cfgDir = RTConfig.getFile(RTKey.CONFIG_FILE_DIR); //String cfgFile = RTConfig.getFile(RTKey.CONFIG_FILE); CFG_PROPERTIES[CONFIG_FILE] = new RTProperties(); // must be non-null if (RTConfig.verbose) { Print.logWarn("No config file was found"); } } CFG_PROPERTIES[CONFIG_FILE].setKeyReplacementMode(RTProperties.KEY_REPLACEMENT_GLOBAL); /* initialize http proxy */ // http.proxyHost // http.proxyPort // http.nonProxyHosts String proxyHost = RTConfig.getString(RTKey.HTTP_PROXY_HOST); int proxyPort = RTConfig.getInt (RTKey.HTTP_PROXY_PORT); if ((proxyHost != null) && (proxyPort > 1024)) { String port = String.valueOf(proxyPort); //Properties sysProp = System.getProperties(); //sysProp.put("proxySet" , "true"); // < jdk 1.3 //sysProp.put("proxyHost", proxyHost); // < jdk 1.3 //sysProp.put("proxyPort", port); // < jdk 1.3 //sysProp.put("http.proxyHost", proxyHost); // >= jdk 1.3 //sysProp.put("http.proxyPort", port); // >= jdk 1.3 //sysProp.put("firewallSet", "true"); // MS JVM //sysProp.put("firewallHost", proxyHost); // MS JVM //sysProp.put("firewallPort", port); // MS JVM System.setProperty("proxySet" , "true"); // < jdk 1.3 System.setProperty("proxyHost", proxyHost); // < jdk 1.3 System.setProperty("proxyPort", port); // < jdk 1.3 System.setProperty("http.proxyHost", proxyHost); // >= jdk 1.3 System.setProperty("http.proxyPort", port); // >= jdk 1.3 System.setProperty("firewallSet", "true"); // MS JVM System.setProperty("firewallHost", proxyHost); // MS JVM System.setProperty("firewallPort", port); // MS JVM } /* URLConnection timeouts */ // sun.net.client.defaultConnectTimeout // sun.net.client.defaultReadTimeout long urlConnectTimeout = RTConfig.getLong(RTKey.URL_CONNECT_TIMEOUT); if (urlConnectTimeout > 0) { String timeout = String.valueOf(urlConnectTimeout); //System.getProperties().put("sun.net.client.defaultConnectTimeout", timeout); System.setProperty("sun.net.client.defaultConnectTimeout", timeout); } long urlReadTimeout = RTConfig.getLong(RTKey.URL_READ_TIMEOUT); if (urlReadTimeout > 0) { String timeout = String.valueOf(urlReadTimeout); //System.getProperties().put("sun.net.client.defaultReadTimeout", timeout); System.setProperty("sun.net.client.defaultReadTimeout", timeout); } /* now initialized */ _didStartupInit = 2; //Print.logInfo("DebugMode: " + RTConfig.isDebugMode()); /* set all of the Print configuration */ String remLogging = RTConfig.getString(RTKey.LOG_REMOTE_LOGGING); if (!StringTools.isBlank(remLogging)) { Print.setRemoteLogging(remLogging); } Print.resetVars(); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets the resource location of the specified class *** @param C The class *** @return The resource URL **/ public static URL getClassResourceURL(Class C) { // file:/dir/gts/build/org/opengts/dir/ClassName.class // jar:file:/dir/gts/build/lib/myUtil.jar!/org/opengts/dir/ClassName.class /* no class */ if (C == null) { return null; } /* class loader */ ClassLoader CL = C.getClassLoader(); if (CL == null) { CL = ClassLoader.getSystemClassLoader(); // could still be null } /* no class loader */ if (CL == null) { return null; } /* return resource URL */ return CL.getResource(C.getName().replace('.','/')+".class"); } // ------------------------------------------------------------------------ /* public static Properties loadResourceProperties(String name) { try { ClassLoader cl = ClassLoader.getSystemClassLoader(); InputStream inpStream = cl.getResourceAsStream(name); if (inpStream != null) { Properties props = new Properties(); props.load(inpStream); return props; } else { return null; } } catch (Throwable t) { Print.logException("Loading properties: " + name, t); return null; } } */ // ------------------------------------------------------------------------ /* public static Properties loadManifestProperties(Class clzz) { // NOTE: Experimental! This currently does not work!!! DO NOT USE String manifestResource = "/META-INF/MANIFEST.MF"; try { ClassLoader cl = clzz.getClassLoader(); InputStream input = cl.getResourceAsStream(manifestResource); if (input == null) { throw new FileNotFoundException("MANIFEST not found"); } BufferedReader br = new BufferedReader(new InputStreamReader(input)); Properties props = new Properties(); for (;;) { String line = br.readLine(); if (line == null) { break; } int p = line.indexOf(':'); if (p > 0) { String key = line.substring(0,p).trim(); String val = line.substring(p+1).trim(); props.setProperty(key, val); } } return props; } catch (Throwable t) { Print.logException("Loading MANIFEST properties", t); return null; } } */ // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ public static void printAllProperties(boolean merge) { if (merge) { /* merge properties */ OrderedMap props = new OrderedMap(); for (int i = 0; i < CFG_PROPERTIES.length; i++) { if (CFG_PROPERTIES[i] != null) { String cpName = getConfigPropertiesIndexName(i); Map cp = CFG_PROPERTIES[i].getProperties(); for (Object _cpKey : cp.keySet()) { String cpKey = StringTools.trim(_cpKey); if (!props.containsKey(cpKey)) { // iff not already present String cpVal = StringTools.trim(cp.get(_cpKey)); props.put(cpKey, new String[] { cpName, cpVal }); } } } } /* sort */ java.util.List keyList = new Vector(props.keySet()); ListTools.sort(keyList,null); /* print */ Print.sysPrintln(""); for (String cpKey : keyList) { String v[] = props.get(cpKey); String cpName = v[0]; String cpVal = v[1]; StringBuffer sb = new StringBuffer(); sb.append("[").append(StringTools.leftAlign(cpName,7)).append("] "); sb.append(StringTools.leftAlign(cpKey,44)); sb.append("= "); sb.append(StringTools.leftAlign(cpVal,50)); Print.sysPrintln(sb.toString()); } } else { /* iterate through property layers */ for (int i = 0; i < CFG_PROPERTIES.length; i++) { if (CFG_PROPERTIES[i] != null) { RTProperties rtp = CFG_PROPERTIES[i]; String cpName = getConfigPropertiesIndexName(i); Print.sysPrintln(""); rtp.printProperties(cpName + ":"); } } } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Replaces ${key} variable references in the specified text *** with values from the runtime properties. Default key delimiters will be *** used. *** @param text The target String *** @return The string containing the replaced key variables *** @see StringTools#insertKeyValues **/ public static String insertKeyValues(String text) { return RTConfig._insertKeyValues(null/*mainKey*/, text, RTProperties.KEY_START_DELIMITER, RTProperties.KEY_END_DELIMITER, RTProperties.KEY_DFT_DELIMITER, null/*customMap*/, true); } /** *** Replaces ${key} variable references in the specified text *** with values from the runtime properties. Default key delimiters will *** be used *** @param text The target String *** @param customMap A custom map to try to get the key value from before *** checking RTConfig *** @return The string containing the replaced key variables *** @see StringTools#insertKeyValues **/ public static String insertKeyValues(String text, Map customMap) { return RTConfig._insertKeyValues(null/*mainKey*/, text, RTProperties.KEY_START_DELIMITER, RTProperties.KEY_END_DELIMITER, RTProperties.KEY_DFT_DELIMITER, customMap, true); } /** *** Replaces key variable references in the specified text *** with values from the runtime properties. Specified key delimiters will *** be used *** @param text The target String *** @param startDelim The pattern used to determine the start of a key variable *** @param endDelim The pattern used to determine the end of a key variable *** @param dftDelim The pattern used to delimit a default value for the key *** @return The string containing the replaced key variables *** @see StringTools#insertKeyValues **/ public static String insertKeyValues(String text, String startDelim, String endDelim, String dftDelim) { return RTConfig._insertKeyValues(null/*mainKey*/, text, startDelim, endDelim, dftDelim, null/*customMap*/, true); } /** *** Replaces ${key} variable references in the specified text *** with values from the runtime properties. Default key delimiters will be *** used. *** @param mainKey The main key *** @param text The target String *** @return The string containing the replaced key variables *** @see StringTools#insertKeyValues **/ public static String _insertKeyValues(Object mainKey, String text) { return RTConfig._insertKeyValues(mainKey, text, RTProperties.KEY_START_DELIMITER, RTProperties.KEY_END_DELIMITER, RTProperties.KEY_DFT_DELIMITER, null/*customMap*/, true); } /** *** Replaces key variable references in the specified text *** with values from the runtime properties. Specified key delimiters will *** be used *** @param mainKey The main key *** @param text The target String *** @param startDelim The pattern used to determine the start of a key variable *** @param endDelim The pattern used to determine the end of a key variable *** @param dftDelim The pattern used to delimit a default value for the key *** @param customMap A custom map to try to get the key value from before *** checking RTConfig *** @param rtOK True to check RTConfig properties, false otherwise *** @return The string containing the replaced key variables *** @see StringTools#insertKeyValues **/ private static String _insertKeyValues(final Object mainKey, final String text, String startDelim, String endDelim, final String dftDelim, final Map customMap, final boolean rtOK) { if (text != null) { // replacment call-back StringTools.KeyValueMap rm = new StringTools.KeyValueMap() { // ReplacementMap private Set thisKeySet = new HashSet(); private Set fullKeySet = new HashSet(); public String getKeyValue(String k, String argNotUsed, String dft) { // reset? if (k == null) { // a bit of a hack here to tell this map to reset the cached keys fullKeySet.addAll(thisKeySet); // prevent the same key from being processed in a recursive pass if (mainKey != null) { fullKeySet.add(mainKey); } thisKeySet.clear(); return null; } // parse key/default String key = k; // null; //String dft = null; //int dftNdx = StringTools.isBlank(dftDelim)? -1 : k.indexOf(dftDelim); // k.lastIndexOf(dftDelim); <-- last index? //if (dftNdx >= 0) { // dft = k.substring(dftNdx + dftDelim.length()); // leave default as-is (untrimmed) // key = k.substring(0,dftNdx).trim(); // trim key //} else { // key = k.trim(); // trim key //} // separate key:argument? // ... // return value if (fullKeySet.contains(key)) { return null; // recursive value } else { thisKeySet.add(key); String customVal = (customMap != null)? customMap.get(key) : null; if (rtOK) { String rtnVal = (customVal != null)? customVal : RTConfig._getString(key, dft, true/*dftOK*/); //if (rtnVal == null) {Print.logError("Key not found: '" + key + "' [" + text + "]");} return rtnVal; } else { return (customMap != null)? customVal : dft; } } } }; // iterate until the string doesn't change String s_old = text; for (int i = 0; i < RTProperties.KEY_MAX_RECURSION; i++) { rm.getKeyValue(null,null,null); // hack to reset the cached keys String s_new = StringTools.insertKeyValues(s_old, startDelim, endDelim, dftDelim, rm, false); if (s_new.equals(s_old)) { return s_new; } s_old = s_new; } return s_old; } else { return text; } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Returns a set of property keys which start with the specified String *** @param startsWith Searth string *** @return A set of property keys which start with the specified String **/ public static Set getPropertyKeys(String startsWith) { return getPropertyKeys(startsWith, true); } /** *** Returns a set of property keys which start with the specified String. *** (may return an empty list, but does not return null) *** @param startsWith Searth string *** @param inclDft True to include default keys *** @return A set of property keys which start with the specified String **/ public static Set getPropertyKeys(String startsWith, boolean inclDft) { OrderedSet keys = new OrderedSet(true); // retain original entries /* initialized? */ if (!isInitialized()) { // 'Print._println...' used here to eliminate possible recursion stack-overflow //Print._println(null, "ConfigFile not yet loaded"); //Thread.dumpStack(); // continue ... } /* temporary properties */ if (CFG_THREAD_TEMPORARY != null) { Stack rtpStack = CFG_THREAD_TEMPORARY.get(); if (rtpStack != null) { // back to front for (int r = rtpStack.size() - 1; r >= 0; r--) { RTProperties rtp = rtpStack.get(r); keys.addAll(rtp.getPropertyKeys(startsWith)); } } } /* property list stack */ for (int i = 0; i < CFG_PROPERTIES.length; i++) { RTProperties rtp = CFG_PROPERTIES[i]; if (rtp != null) { keys.addAll(rtp.getPropertyKeys(startsWith)); } } /* default properties */ if (inclDft) { RTProperties rtp = RTKey.getDefaultProperties(); if (rtp != null) { keys.addAll(rtp.getPropertyKeys(startsWith)); } } /* return set */ return keys; } /** *** Returns a new RTProeprties instance populated with all keys starting with *** the specified value *** @param startsWith Searth string *** @param inclDft True to include default keys *** @return The new RTProperties instance (never null) **/ public static RTProperties getProperties(String startsWith, boolean inclDft) { Set keys = RTConfig.getPropertyKeys(startsWith, inclDft); RTProperties rtProps = new RTProperties(); for (String k : keys) { rtProps.setProperty(k, RTConfig.getProperty(k,"",inclDft)); } return rtProps; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Returns true if there is a value associated with the specified key. *** Default values are also included. *** @param key The key *** @return if there is a value associated with the specified key **/ public static boolean hasProperty(String key) { return RTConfig.hasProperty(key, true); } /** *** Returns true if there is a value associated with the specified key. *** @param key The key *** @param dftOk True if default values count *** @return if there is a value associated with the specified key **/ public static boolean hasProperty(String key, boolean dftOk) { RTProperties rtp = getPropertiesForKey(key, dftOk); return (rtp != null); } /** *** Returns true if any of the keys in the specified string array have a *** value associated with them. Default values are also included. *** @param key The key *** @return if there is a value associated with any of the specified keys **/ public static boolean hasProperty(String key[]) { return RTConfig.hasProperty(key, true); } /** *** Returns true if any of the keys in the specified string array have a *** value associated with them. *** @param key The key *** @param dftOk True if default values count *** @return if there is a value associated with any of the specified keys **/ public static boolean hasProperty(String key[], boolean dftOk) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOk); if (rtp != null) { return true; } } } return false; } // ------------------------------------------------------------------------ /** *** Gets the property value of a key *** @param key The key to get the property value of *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key) { return RTConfig.getProperty(key, null, true); } /** *** Gets the property value of a key *** @param key The key list to get the property value of *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key[]) { return RTConfig.getProperty(key, null, true); } /** *** Gets the property value of a key *** @param key The key to get the property value of *** @param dft The default value to return if none found *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key, Object dft) { return RTConfig.getProperty(key, dft, false); } /** *** Gets the property value of a key *** @param key The key list to get the property value of *** @param dft The default value to return if none found *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key[], Object dft) { return RTConfig.getProperty(key, dft, false); } /** *** Gets the property value of a key *** @param key The key to get the property value of *** @param dft The default value to return if none found *** @param dftOk True to check defaults, if not found elsewhere *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key, Object dft, boolean dftOk) { RTProperties rtp = getPropertiesForKey(key, dftOk); return (rtp != null)? rtp.getProperty(key, dft) : dft; } /** *** Gets the property value of a key *** @param key The key list to get the property value of *** @param dft The default value to return if none found *** @param dftOk True to check defaults, if not found elsewhere *** @return The property value of the key *** @see RTProperties#getProperty **/ public static Object getProperty(String key[], Object dft, boolean dftOk) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOk); if (rtp != null) { Object obj = rtp._getProperty(key[i], dft); return (obj != null)? obj : dft; } } } return dft; } /** *** Sets the value for the specified key *** @param key The property key *** @param value The value to associate with the specified key **/ public static void setProperty(String key, Object value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setProperty(key, value); if ((key != null) && (value == null)) { getSystemProperties().removeProperty(key); } } // ------------------------------------------------------------------------ /** *** Adds the properties in the specified Properties to the config *** file properties *** @param props The Properties instance from which properties will be loaded **/ public static void setProperties(Properties props) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setProperties(props); } /** *** Adds the properties in the specified RTProperties to the config *** file properties *** @param rtprops The RTProperties instance from which properties will be loaded **/ public static void setProperties(RTProperties rtprops) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setProperties(rtprops); } // ------------------------------------------------------------------------ // Extract a Map containing a group of key/values from the config file properties /* public static Map extractMap(String keyEnd, String valEnd) { // TODO: should include keyEnd/valEnd from all properties RTProperties cfgProps = getConfigFileProperties(); return cfgProps.extractMap(keyEnd, valEnd); } */ // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets the String value for the specified key *** @param key The property key *** @param dft The default value return if the key is not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The String value, or 'dft' if the key is not found **/ public static String _getString(String key, String dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); if (rtp != null) { Object obj = rtp._getProperty(key, dft); return (obj != null)? obj.toString() : dft; } else { return dft; } } /** *** Gets a String value for one of the specified keys *** @param key The property keys *** @param dft The default value return if the key is not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The String value, or 'dft' if the key is not found **/ public static String _getString(String key[], String dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { Object obj = rtp._getProperty(key[i], dft); return (obj != null)? obj.toString() : dft; } } } return dft; } /** *** Gets a String value for one of the specified keys *** @param key The property key *** @return The String value, or 'null' if the key is not found **/ public static String getString(String key) { return getString(key, null, true); } /** *** Gets a String value for one of the specified keys *** @param key The property keys *** @return The String value, or 'null' if the key is not found **/ public static String getString(String key[]) { return getString(key, null, true); } /** *** Gets the String value for the specified key *** @param key The property key *** @param dft The default value return if the key is not found *** @return The String value, or 'dft' if the key is not found **/ public static String getString(String key, String dft) { return getString(key, dft, false); } /** *** Gets the String value for the specified key *** @param key The property key *** @param dft The default value return if the key is not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The String value, or 'dft' if the key is not found **/ public static String getString(String key, String dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getString(key, dft) : dft; } /** *** Gets a String value for one of the specified keys *** @param key The property keys *** @param dft The default value return if the key is not found *** @return The String value, or 'dft' if the key is not found **/ public static String getString(String key[], String dft) { return getString(key, dft, false); } /** *** Gets a String value for one of the specified keys *** @param key The property keys *** @param dft The default value return if the key is not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The String value, or 'dft' if the key is not found **/ public static String getString(String key[], String dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getString(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setString(String key, String value) { RTProperties cfgFileProps = getConfigFileProperties(); cfgFileProps.setString(key, value); } // ------------------------------------------------------------------------ /** *** Gets a string array property at the specified key *** @param key The key of the property *** @return The string array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static String[] getStringArray(String key) { return getStringArray(key, null, true); } /** *** Gets a string array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The string array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static String[] getStringArray(String key, String dft[]) { return getStringArray(key, dft, false); } /** *** Gets a string array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The string array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static String[] getStringArray(String key, String dft[], boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getStringArray(key, dft) : dft; } /** *** Gets a string array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The string array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static String[] getStringArray(String key[], String dft[]) { return getStringArray(key, dft, false); } /** *** Gets a string array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The string array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static String[] getStringArray(String key[], String dft[], boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getStringArray(key[i], dft); } } } return dft; } /** *** Sets the string array property value for the specified key *** @param key The property key *** @param val The property value to set. **/ public static void setStringArray(String key, String val[]) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setStringArray(key, val); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a Class property at the specified key *** @param key The key of the property *** @return The Class value of the property **/ public static Class getClass(String key) { return getClass(key, null, true); } /** *** Gets a Class property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The Class value of the property **/ public static Class getClass(String key, Class dft) { return getClass(key, dft, false); } /** *** Gets a Class property from a specified array of keys *** @param key A property key. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The Class value of the property **/ public static Class getClass(String key, Class dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getClass(key, dft) : dft; } /** *** Gets a Class property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The Class value of the property **/ public static Class getClass(String key[], Class dft) { return getClass(key, dft, false); } /** *** Gets a Class property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The Class value of the property **/ public static Class getClass(String key[], Class dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getClass(key[i], dft); } } } return dft; } /** *** Sets the Class property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setClass(String key, Class value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setClass(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a File property at the specified key *** @param key The key of the property *** @return The File value of the property **/ public static File getFile(String key) { return getFile(key, null, true); } // do not include this method, otherwise "getFile(file, null)" would be ambiguous //public File getFile(String key, String dft) /** *** Gets a File property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The File value of the property **/ public static File getFile(String key, File dft) { return getFile(key, dft, false); } /** *** Gets a File property from a specified array of keys *** @param key A property key. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The File value of the property **/ public static File getFile(String key, File dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getFile(key, dft) : dft; } /** *** Gets a File property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The File value of the property **/ public static File getFile(String key[], File dft) { return getFile(key, dft, false); } /** *** Gets a File property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The File value of the property **/ public static File getFile(String key[], File dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getFile(key[i], dft); } } } return dft; } /** *** Sets the File property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setFile(String key, File value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setFile(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a double property at the specified key *** @param key The key of the property *** @return The double value of the property **/ public static double getDouble(String key) { return getDouble(key, 0.0, true); } /** *** Gets a double property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The double value of the property **/ public static double getDouble(String key, double dft) { return getDouble(key, dft, false); } /** *** Gets a double property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The double value of the property **/ public static double getDouble(String key, double dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getDouble(key, dft) : dft; } /** *** Gets a dobule property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The double value of the property **/ public static double getDouble(String key[], double dft) { return getDouble(key, dft, false); } /** *** Gets a dobule property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The double value of the property **/ public static double getDouble(String key[], double dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getDouble(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setDouble(String key, double value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setDouble(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a float property at the specified key *** @param key The key of the property *** @return The float value of the property **/ public static float getFloat(String key) { return RTConfig.getFloat(key, 0.0F, true); } /** *** Gets a float property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The float value of the property **/ public static float getFloat(String key, float dft) { return RTConfig.getFloat(key, dft, false); } /** *** Gets a float property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The float value of the property **/ public static float getFloat(String key, float dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getFloat(key, dft) : dft; } /** *** Gets a float property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The float value of the property **/ public static float getFloat(String key[], float dft) { return RTConfig.getFloat(key, dft, false); } /** *** Gets a float property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The float value of the property **/ public static float getFloat(String key[], float dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getFloat(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setFloat(String key, float value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setFloat(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a BigInteger property at the specified key *** @param key The key of the property *** @return The BigInteger value of the property **/ public static BigInteger getBigInteger(String key) { return RTConfig.getBigInteger(key, BigInteger.ZERO, true); } /** *** Gets a BigInteger property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The BigInteger value of the property **/ public static BigInteger getBigInteger(String key, BigInteger dft) { return RTConfig.getBigInteger(key, dft, false); } /** *** Gets a BigInteger property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The BigInteger value of the property **/ public static BigInteger getBigInteger(String key, BigInteger dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getBigInteger(key, dft) : dft; } /** *** Gets a BigInteger property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The BigInteger value of the property **/ public static BigInteger getBigInteger(String key[], BigInteger dft) { return RTConfig.getBigInteger(key, dft, false); } /** *** Gets a BigInteger property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The BigInteger value of the property **/ public static BigInteger getBigInteger(String key[], BigInteger dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getBigInteger(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setBigInteger(String key, BigInteger value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setBigInteger(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a long property at the specified key *** @param key The key of the property *** @return The long value of the property **/ public static long getLong(String key) { return RTConfig.getLong(key, 0L, true); } /** *** Gets a long property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The long value of the property **/ public static long getLong(String key, long dft) { return RTConfig.getLong(key, dft, false); } /** *** Gets a long property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The long value of the property **/ public static long getLong(String key, long dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getLong(key, dft) : dft; } /** *** Gets a long property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The long value of the property **/ public static long getLong(String key[], long dft) { return RTConfig.getLong(key, dft, false); } /** *** Gets a long property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The long value of the property **/ public static long getLong(String key[], long dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getLong(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setLong(String key, long value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setLong(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a int property at the specified key *** @param key The key of the property *** @return The int value of the property **/ public static int getInt(String key) { return RTConfig.getInt(key, 0, true); } /** *** Gets a int property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The int value of the property **/ public static int getInt(String key, int dft) { return RTConfig.getInt(key, dft, false); } /** *** Gets a int property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The int value of the property **/ public static int getInt(String key, int dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getInt(key, dft) : dft; } /** *** Gets a int property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The int value of the property **/ public static int getInt(String key[], int dft) { return RTConfig.getInt(key, dft, false); } /** *** Gets a int property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The int value of the property **/ public static int getInt(String key[], int dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getInt(key[i], dft); } } } return dft; } /** *** Sets the property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setInt(String key, int value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setInt(key, value); } // ------------------------------------------------------------------------ /** *** Gets a int array property at the specified key *** @param key The key of the property *** @return The int array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static int[] getIntArray(String key) { return getIntArray(key, null, true); } /** *** Gets a int array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The int array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static int[] getIntArray(String key, int dft[]) { return getIntArray(key, dft, false); } /** *** Gets a int array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The int array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static int[] getIntArray(String key, int dft[], boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getIntArray(key, dft) : dft; } /** *** Gets a int array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The int array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static int[] getIntArray(String key[], int dft[]) { return getIntArray(key, dft, false); } /** *** Gets a int array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The int array value of the property **/ public static int[] getIntArray(String key[], int dft[], boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getIntArray(key[i], dft); } } } return dft; } /** *** Sets the int array property value for the specified key *** @param key The property key *** @param val The property value to set. **/ public static void setIntArray(String key, int val[]) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setIntArray(key, val); } // ------------------------------------------------------------------------ /** *** Gets a long array property at the specified key *** @param key The key of the property *** @return The long array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static long[] getLongArray(String key) { return getLongArray(key, null, true); } /** *** Gets a long array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The long array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static long[] getLongArray(String key, long dft[]) { return getLongArray(key, dft, false); } /** *** Gets a long array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The long array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static long[] getLongArray(String key, long dft[], boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getLongArray(key, dft) : dft; } /** *** Gets a long array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The long array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static long[] getLongArray(String key[], long dft[]) { return getLongArray(key, dft, false); } /** *** Gets a long array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The long array value of the property **/ public static long[] getLongArray(String key[], long dft[], boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getLongArray(key[i], dft); } } } return dft; } /** *** Sets the long array property value for the specified key *** @param key The property key *** @param val The property value to set. **/ public static void setLongArray(String key, long val[]) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setLongArray(key, val); } // ------------------------------------------------------------------------ /** *** Gets a double array property at the specified key *** @param key The key of the property *** @return The double array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static double[] getDoubleArray(String key) { return getDoubleArray(key, null, true); } /** *** Gets a double array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The double array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static double[] getDoubleArray(String key, double dft[]) { return getDoubleArray(key, dft, false); } /** *** Gets a double array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The double array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static double[] getDoubleArray(String key, double dft[], boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); return (rtp != null)? rtp.getDoubleArray(key, dft) : dft; } /** *** Gets a double array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The double array value of the property *** @see StringTools#parseArray(String s, char arrayDelim) **/ public static double[] getDoubleArray(String key[], double dft[]) { return getDoubleArray(key, dft, false); } /** *** Gets a double array property from a specified array of keys *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The double array value of the property **/ public static double[] getDoubleArray(String key[], double dft[], boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getDoubleArray(key[i], dft); } } } return dft; } /** *** Sets the long array property value for the specified key *** @param key The property key *** @param val The property value to set. **/ public static void setDoubleArray(String key, double val[]) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setDoubleArray(key, val); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Gets a boolean property at the specified key *** @param key The key of the property *** @return The boolean value of the property **/ public static boolean getBoolean(String key) { return getBoolean(key, hasProperty(key), true); } /** *** Gets a boolean property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @return The boolean value of the property **/ public static boolean getBoolean(String key, boolean dft) { return getBoolean(key, dft, false); } /** *** Gets a boolean property at the specified key *** @param key The key of the property *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The boolean value of the property **/ public static boolean getBoolean(String key, boolean dft, boolean dftOK) { RTProperties rtp = getPropertiesForKey(key, dftOK); if (rtp == null) { return dft; // no key, return default } else { String s = rtp.getString(key, ""); if ((s != null) && s.equals("")) { return rtp.getBoolean(key, true); // key with no argument } else { return rtp.getBoolean(key, dft); // key with argument, use dft if not parsable. } } //return (rtp != null)? rtp.getBoolean(key, dft) : dft; } /** *** Gets a boolean property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @return The boolean value of the property **/ public static boolean getBoolean(String key[], boolean dft) { return getBoolean(key, dft, false); } /** *** Gets a boolean property at the specified key *** @param key An array of property keys. The value of the first matching *** key will be returned. *** @param dft The default value to return if an entry was not found *** @param dftOK True to check defaults, if not found elsewhere *** @return The boolean value of the property **/ public static boolean getBoolean(String key[], boolean dft, boolean dftOK) { if (key != null) { for (int i = 0; i < key.length; i++) { RTProperties rtp = getPropertiesForKey(key[i], dftOK); if (rtp != null) { return rtp.getBoolean(key[i], dft); } } } return dft; } /** *** Sets the boolean property value for the specified key *** @param key The property key *** @param value The property value to set. **/ public static void setBoolean(String key, boolean value) { RTProperties cfgProps = getConfigFileProperties(); cfgProps.setBoolean(key, value); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets the administrative mode *** @param admin True to set administrative mode **/ public static void setAdminMode(boolean admin) { RTConfig.setBoolean(RTKey.ADMIN_MODE, admin); } /** *** Returns true if running in administrative mode *** @return True if running in administrative mode **/ public static boolean isAdminMode() { return RTConfig.getBoolean(RTKey.ADMIN_MODE); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets if debug mode is enabled or not *** @param debug True to enable debug mode **/ public static void setDebugMode(boolean debug) { RTConfig.setBoolean(RTKey.DEBUG_MODE, debug); } //private static int _debug_recursion = 0; /** *** Returns true if debug mode is enabled *** @return True if debug mode is enabled **/ public static boolean isDebugMode() { //if (_debug_recursion > 0) { Thread.dumpStack(); System.exit(0); } //try { _debug_recursion++; return !isInitialized() || getBoolean(RTKey.DEBUG_MODE); //} finally { _debug_recursion--; } } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets if test mode is enabled *** @param test True to enabled test mode **/ public static void setTestMode(boolean test) { setBoolean(RTKey.TEST_MODE, test); } /** *** Returns true if test mode is enabled *** @return True if test mode is enabled **/ public static boolean isTestMode() { return getBoolean(RTKey.TEST_MODE); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets the RTKey.CONTEXT_NAME property *** Typically this is set to the name of the parent package directory *** (ie. as in "c" in the class "a.b.c.Main"), but this can be set to other values, *** depending on where it is used. *** @param name The CONTEXT_NAME value. **/ public static void setContextName(String name) { RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); constantProps.setProperty(RTKey.CONTEXT_NAME, StringTools.trim(name)); } /** *** Gets the RTKey.CONTEXT_NAME property value.
*** Typically this returns the name of the parent package directory *** (ie. as in "c" in the class "a.b.c.Main"), but may return other values, *** depending on where it is used. *** @param dftName The default path to return if CONTEXT_NAME is undefined/blank *** @return The CONTEXT_NAME String, or the default value if undefined/blank. **/ public static String getContextName(String dftName) { RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); String ctxName = constantProps.getString(RTKey.CONTEXT_NAME, null); return StringTools.blankDefault(ctxName, dftName); } /** *** Gets the RTKey.CONTEXT_NAME property value.
*** Typically this returns the name of the parent package directory *** (ie. as in "c" in the class "a.b.c.Main"), but may return other values, *** depending on where it is used. *** @return The CONTEXT_NAME String, or null if undefined/blank. **/ public static String getContextName() { return RTConfig.getContextName(null); } /** *** Returns true if the RTKey.CONTEXT_NAME property is defined and non-blank *** @return True if the RTKey.CONTEXT_NAME property is defined and non-blank **/ public static boolean hasContextName() { return !StringTools.isBlank(RTConfig.getContextName(null)); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Sets the RTKey.CONTEXT_PATH property value. *** @param path The CONTEXT_PATH value. **/ public static void setContextPath(String path) { RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); constantProps.setProperty(RTKey.CONTEXT_PATH, StringTools.trim(path)); } /** *** Gets the RTKey.CONTEXT_PATH property value. *** @param dftPath The default path to return if CONTEXT_PATH is undefined/blank *** @return The CONTEXT_PATH String, or the default value if undefined/blank. **/ public static String getContextPath(String dftPath) { RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); String ctxName = constantProps.getString(RTKey.CONTEXT_PATH, null); return StringTools.blankDefault(ctxName, dftPath); } /** *** Gets the RTKey.CONTEXT_PATH property value. *** @return The CONTEXT_PATH String, or null if undefined/blank. **/ public static String getContextPath() { return RTConfig.getContextPath(null); } /** *** Returns true if the RTKey.CONTEXT_PATH property is defined and non-blank *** @return True if the RTKey.CONTEXT_PATH property is defined and non-blank **/ public static boolean hasContextPath() { return !StringTools.isBlank(RTConfig.getContextPath(null)); } /** *** Returns the Servlet context path. Returns null if the current context is not *** a Servlet, or if the context path has not been defined. *** @return The servlet context path File instance **/ public static File getServletContextPath() { if (RTConfig.isWebApp()) { String ctxPath = RTConfig.getContextPath(); if (!StringTools.isBlank(ctxPath)) { File ctxPathFile = new File(ctxPath); if (ctxPathFile.isDirectory()) { return ctxPathFile; } else { Print.logWarn("Servlet 'CONTEXT_PATH' is not a directory [2]: " + ctxPath); } } else { Print.logWarn("Servlet is missing 'CONTEXT_PATH' [2]: " + RTConfig.getServletClassName()); } } return null; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static Boolean isRunningAsWebApp = null; /** *** Sets if this instance is running as a webapp *** @param webapp True if this instance is running as a webapp **/ public static void setWebApp(boolean webapp) { RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); constantProps.setProperty(RTKey.IS_WEBAPP, webapp); isRunningAsWebApp = null; // <== to bypass Boolean check } /** *** Returns true if this instance is running as a webapp *** @return True if this instance is running as a webapp **/ public static boolean isWebApp() { /* already know where we are running? */ if (isRunningAsWebApp != null) { return isRunningAsWebApp.booleanValue(); } /* "isWebApp" explicitly defined? */ RTProperties constantProps = RTConfig.getRuntimeConstantProperties(); if (constantProps.hasProperty(RTKey.IS_WEBAPP)) { return constantProps.getBoolean(RTKey.IS_WEBAPP); } /* check invocation stack */ isRunningAsWebApp = new Boolean(_isWebApp_2()); return isRunningAsWebApp.booleanValue(); } private static String WebAppClassNames[] = { "javax.servlet.http.HttpServlet", // as long as the servlet didn't override 'service' "org.apache.catalina.core.ApplicationFilterChain" }; protected static boolean _isWebApp_1() { // We should also check the invocation stack // A typical stack-trace segment for a servlet is as follows: // ... // at com.example.war.DataMessage.doPost(DataMessage.java:46) // at javax.servlet.http.HttpServlet.service(HttpServlet.java:760) // at javax.servlet.http.HttpServlet.service(HttpServlet.java:853) // at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:247) // at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:193) // at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:256) // ... // Possible search Strings would be: // - "javax.servlet.http.HttpServlet" (assuming 'service' was not overridden) // - "org.apache.catalina.core.ApplicationFilterChain" (only valid for Tomcat) Throwable t = new Throwable(); t.fillInStackTrace(); //t.printStackTrace(); StackTraceElement stackFrame[] = t.getStackTrace(); for (int i = 0; i < stackFrame.length; i++) { String cn = stackFrame[i].getClassName(); for (int w = 0; w < WebAppClassNames.length; w++) { if (cn.equalsIgnoreCase(WebAppClassNames[w])) { return true; } } } return false; } protected static boolean _isWebApp_2() { return (RTConfig.getServletClass() != null); } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static boolean Main_init = false; private static Class Main_class = null; /** *** Gets the main entry point class *** @return The main entry point class, or null if the main entry point class *** could not be obtained. **/ public static Class getMainClass() { if (!Main_init) { Main_init = true; if (OSTools.hasGetCallerClass()) { Class lastClz = null; for (int sf = 2; ; sf++) { Class clz = OSTools.getCallerClass(sf); if (clz == null) { break; } lastClz = clz; } Main_class = lastClz; } else { Print.logError("Not running with the Sun Microsystems version of Java."); Print.logError("Cannot obtain main class."); } } return Main_class; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ private static String SERVLET_CLASS = "javax.servlet.Servlet"; // GenericServlet private static boolean Servlet_init = false; private static Class Servlet_class = null; /** *** Gets the servelet class if this application is running as a servelet *** @return The servelet class if this application is running as a servelet **/ public static Class getServletClass() { /* init for Servlet class */ if (!Servlet_init) { try { Servlet_class = Class.forName(SERVLET_CLASS); } catch (Throwable t) { // class not found? //Print.logWarn("Not a servlet - running as application?"); } Servlet_init = true; } /* find Servlet in invocation stack */ if (Servlet_class != null) { for (int sf = 2; ; sf++) { Class clz = OSTools.getCallerClass(sf); if (clz == null) { break; } if (Servlet_class.isAssignableFrom(clz)) { return clz; } } } /* not found */ return null; } /** *** Returns the Servlet class name *** @return The Servlet class name **/ public static String getServletClassName() { Class sc = RTConfig.getServletClass(); return (sc != null)? StringTools.className(sc) : ""; } // ------------------------------------------------------------------------ // ------------------------------------------------------------------------ /** *** Command-line entry point (testing/debugging purposes) *** @param argv The command-line arguments **/ public static void main(String argv[]) { //Print.logInfo("Before RTConfig was initialized ..."); RTConfig.setCommandLineArgs(argv); //RTConfig.getCommandLineProperties().printProperties(""); Print.logDebug("DebugMode is true"); /* test */ if (RTConfig.hasProperty("test")) { Print.sysPrintln("Value = " + RTConfig.getString("value",null)); String s = StringTools.blankDefault(RTConfig.getString("test",null),"Test String: ${value=a:b:c}"); Print.sysPrintln("before " + s); String r = RTConfig.insertKeyValues(s); Print.sysPrintln("after " + r); System.exit(0); } /* return key/value */ if (RTConfig.hasProperty("key")) { String key = RTConfig.getString("key"); String val = RTConfig.getString(key,""); Print.sysPrintln(""); Print.sysPrintln("%s=%s",key,val); Print.sysPrintln(""); System.exit(0); } /* list */ if (RTConfig.hasProperty("list")) { Print.sysPrintln("Context Name: " + RTConfig.getContextName()); Print.sysPrintln("Context Path: " + RTConfig.getContextPath()); Print.sysPrintln(""); boolean merge = RTConfig.getString("list","").startsWith("m"); RTConfig.printAllProperties(merge); System.exit(0); } /* reload test */ if (RTConfig.getBoolean("reload",false)) { Print.sysPrintln(""); Print.sysPrintln("Starting Reload ..."); RTConfig.reload(); Print.sysPrintln("Done Reloading ..."); System.exit(0); } /* merge */ if(RTConfig.hasProperty("merge")) { // bin/exeJava ...RTConfig -merge=FROM.CONF -into=TO.CONF // merge source File mergeFile = RTConfig.getFile("merge",null); if (!FileTools.isFile(mergeFile)) { Print.sysPrintln("ERROR - 'merge' file does not exist: " + mergeFile); System.exit(1); } // merge destination File intoFile = RTConfig.getFile("into" ,null); if (!FileTools.isFile(intoFile)) { Print.sysPrintln("ERROR - 'into' file does not exist: " + intoFile); System.exit(1); } // loop through source properties and apply to destination RTProperties mergeP = new RTProperties(); try { mergeP.setIncludesEnabled(false); mergeP.setProperties(mergeFile, true); mergeP.saveProperties(intoFile,true/*merge*/); } catch (IOException ioe) { Print.logException("Unable to save properties",ioe); System.exit(1); } System.exit(0); } /* Thread local temporary properties test */ /* * / final String SETLABEL = "label"; final String GETLABEL = "userAgent"; RTProperties tempProps = new RTProperties(); tempProps.setString(SETLABEL,"Main Hello World"); Print.logInfo("Main Label = " + RTConfig.getString(GETLABEL)); RTConfig.pushTemporaryProperties(tempProps); Print.logInfo("Main Label = " + RTConfig.getString(GETLABEL)); (new Thread() { public void run() { RTProperties tp = new RTProperties(); tp.setString(SETLABEL,"Thread Universal"); RTConfig.pushTemporaryProperties(tp); Print.logInfo("Thread Label = " + RTConfig.getString(GETLABEL)); for (int i = 0; i < 10; i++) { Print.logInfo("Thread Label = " + RTConfig.getString(GETLABEL)); try { Thread.sleep(900L); } catch (Throwable th) {} } Print.logInfo("Thread done ..."); } }).start(); for (int i = 0; i < 10; i++) { Print.logInfo("Main Label = " + RTConfig.getString(GETLABEL)); try { Thread.sleep(1000L); } catch (Throwable th) {} } RTConfig.popTemporaryProperties(tempProps); Print.logInfo("Main Label = " + RTConfig.getString(GETLABEL)); /* */ //Print.logInfo("String test = " + RTConfig.insertKeyValues(RTConfig.getString("test","???"))); //Print.logInfo("Double test = " + RTConfig.getDouble("test",0.0)); //Print.logInfo("Long test = " + RTConfig.getLong("test",0L)); //Print.logFatal("DebugMode [false] = " + RTConfig.getBoolean(RTKey.DEBUG_MODE,false)); //Print.logError("DebugMode [false] = " + RTConfig.getBoolean(RTKey.DEBUG_MODE,false)); //Print.logWarn ("DebugMode [true ] = " + RTConfig.getBoolean(RTKey.DEBUG_MODE,true)); //Print.logInfo ("DebugMode [undef] = " + RTConfig.getBoolean(RTKey.DEBUG_MODE)); //Print.logDebug("DebugMode [undef] = " + RTConfig.getBoolean(RTKey.DEBUG_MODE)); } }