package com.digi.config.util;

import java.awt.Color;
import java.awt.Font;
import java.io.*;
import java.util.*;
import java.net.*;
import java.applet.*;


/**
 * <p>ConfigSettings reads and parses the content of a user defined
 *  configuration file and provides a set of query functions to retrieve
 *  these configuration information.
 * <p>The default configuration file pathname is <b>config.ini</b> in the
 *  classpath.
 * <h3>Environment Configuration File Definitions</h3>
 * <ol>
 * <li>Comment
 * <pre>
 *      Syntax :    //
 * </pre>
 * <ul>
 * <li>Comment is prefixed by "//" and can be anywhere in a line.
 * <li>All text after the "//" to the end of the line is treated as comment.
 * </ul>
 * <li>Section Name
 * <pre>
 *      Syntax :    [section_name]
 * </pre>
 * <ul>
 * <li>Section name associates a group of tags of similar functions.
 * </ul>
 * <li>Tag
 * <pre>
 *      Syntax :    tag  = value
 * </pre>
 * <ul>
 * <li>Tag is used to associate value to a name.
 * <li>Value is a text string.
 * <li>All leading and trailing white space characters for tags and
 *     replacement text are ignored.
 * <li>Only the first '=' character is significant and is used for
 *           the tag value assignment.
 * </ul>
 * <li>Tag Substitution
 * <pre>
 *      Syntax :    $([[section_name]:]tag)
 * </pre>
 * <ul>
 * <li>Text enclosed by "$(" and ")" is used as tag to search for replacement
 *     text and substitutes in the input text.
 * <li>Nested tag substitution is not supported but multiple
 *     tag substitutions is allowed. For example
 *     <tt>"Tag1 = $(Tag2) follows by $(Tag3)"</tt>
 * <li>If no section_name is defined, an "unnamed" section is used.
 * <li>If no substitition text is found, empty string is replaced.
 * <li>If no matching ')' is found for the "$(", no action is taken and input
 *      text remains as is. For example <tt>"$(tag1 $(tag2)"</tt>
 *      - try to find a tag with name <tt>"tag1 $(tag2"</tt>.
 * </ul>
 * </ol>
 * This is also an observable and sends notifications to the registered observers,
 * passing a modified settings object.
 */
public class ConfigSettings extends Observable {

    /**
     * Environment configuration file name used in the current application.
     */
    private String configFileName=System.getProperty("ConfigFileName","config.ini");

    private static ConfigSettings theInstance=null; // The only instance

    /**
     * Constant to use when dealing with configuration settings in the System
     * category.
     * NOTE: this actually points to the System Properties.
     */
    public final static String CATEGORY_SYSTEM="System";

    /**
     * Constant to use when dealing with general configuration settings
     */
    public final static String CATEGORY_CFG="General";

    /* This maintains a hashtable of vector2 objects */

    private Hashtable ivSectionTable=new Hashtable();

    /* Vector holding all the default value finders */

    private Vector ivDefValFunction=new Vector();


    private ModifiedSettings ivModSettings=null; // Holds the modified settings sent out to listeners

    /** Ini file is first searched in class path . If not found, it is created in the path
       whereever the tool is run. Look for the class com.digi.util.ConfigSettings.
       Get its full path name and create the file in the directory where com directory exists*/
    private String iniFileName=null;


    //=====================================================================
    // Static methods
    //=====================================================================

    /**
     * This method returns the only instance of the configsettings object
     * <p>
     * @return ConfigSettings
     */
    public static ConfigSettings getInstance() {
        if (theInstance==null) {
            theInstance=new ConfigSettings();
        }

        return theInstance;
    }


    //=====================================================================
    // Instance Methods
    //=====================================================================

    /**
     * Constructor
     * <p>
     */
    private ConfigSettings() {

        // Load the ini file if it is available
        try {
            load_profile();
        } catch (Exception e) {
            System.out.println("Error loading configuration profile: ");
            e.printStackTrace();
        }
        addDefaultValueFinderListener(new DefaultConfigSettings());
    }

    /**
     * This method adds a defaultvalue finder listener.
     * <p>
     * @param def the default value finder class
     */
    public void addDefaultValueFinderListener(DefaultValueFinder def) {
        ivDefValFunction.addElement(def);
    }

    /**
     * Returns environment configuration file pathname.
     * @return the configuration file name
     */
    public String getConfigFileName() {
        return configFileName;
    }



    /**
     * Returns value of specified ProfileProperty as a string. Returns null if section/tag is not found.
     * 
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @return                Replacement text of the input tag
     */
    public String getProfileProperty(String section, String tag) {
        return getProfileProperty(section,tag,null,null);
    }

    /**
     * Returns value of specified ProfileProperty as a string. Returns null if section/tag is not found.
     * Caller specifies both a primary and fallback set of section/tag pairs. The search order is:
     * <ol>
     *   <li>primary section/tag ini entry</li>
     *   <li>fallback section/tag ini entry</li>
     *   <li>primary section/tag defaultValueFinder</li>
     *   <li>fallback section/tag defaultValueFinder</li>
     * </ol>
     * 
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @param fallbackSection  Second section name in the profile to look for
     * @param fallbackTag      Second tag name to look for
     * @return                 Replacement text of the input tag
     */
    public String getProfileProperty(String section, String tag, String fallbackSection, String fallbackTag) {
        String retStr=null;
        // Try looking up the primary section/tag item in the ini file
        if (section.equals(CATEGORY_SYSTEM)) {
            // If this is the SYSTEM section, pull it from the System properties
            retStr = System.getProperty(tag);
        } else {
            // otherwise look it up in the table
            Vector2 v=(Vector2)ivSectionTable.get(section);
            if (v!=null) {
                retStr=(String)v.get(tag);
            }
        }

        if ((retStr==null) && (fallbackSection!=null)) {
            // Didn't find the primary section/tag, look for the fallback in the ini file
            if (fallbackSection.equals(CATEGORY_SYSTEM)) {
                // If this is the SYSTEM section, pull it from the System properties
                retStr = System.getProperty(fallbackTag);
            } else {
                // otherwise look it up in the table
                Vector2 v=(Vector2)ivSectionTable.get(fallbackSection);
                if (v!=null) {
                    retStr=(String)v.get(fallbackTag);
                }
            }
        }

        if (retStr==null) {
            // didn't find primary or fallback section/tag in ini file... check default value finders for primary section/tag
            Enumeration e=ivDefValFunction.elements();
            while ((retStr==null)&&(e.hasMoreElements())) {
                retStr=((DefaultValueFinder)e.nextElement()).getDefaultValue(section, tag);
            }
        }

        if ((retStr==null) && (fallbackSection!=null)) {
            // last chance, check default value finders for fallback section/tag
            Enumeration e=ivDefValFunction.elements();
            while ((retStr==null)&&(e.hasMoreElements())) {
                retStr=((DefaultValueFinder)e.nextElement()).getDefaultValue(fallbackSection, fallbackTag);
            }
        }

        return retStr;
    }


    /**
     * Returns the Profile Property as a String. Returns value of <i>defRetVal</i> if section/tag not found.
     * 
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @param defRetVal       Default return String if none is found.
     * @return                Replacement text of the input tag
     */
    public String getProfileProperty(String section, String tag, String defRetVal) {
        String retValue=getProfileProperty(section, tag);
        return(retValue!=null?retValue:defRetVal);
    }

    /**
     * Returns the Profile Property as a boolean. Returns value of false if section/tag not found.
     * 
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @return                boolean value of property
     */
    public boolean getBooleanProfileProperty(String section, String tag) {
        return getBooleanProfileProperty(section,tag,null,null);
    }

    /**
     * Returns the Profile Property as a boolean. Returns value of false if section/tag not found.
     * Caller specifies both a primary and fallback set of section/tag pairs. The search order is:
     * <ol>
     *   <li>primary section/tag ini entry</li>
     *   <li>fallback section/tag ini entry</li>
     *   <li>primary section/tag defaultValueFinder</li>
     *   <li>fallback section/tag defaultValueFinder</li>
     * </ol>
     * 
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @param fallbackSection  Second section name in the profile to look for
     * @param fallbackTag      Second tag name to look for
     * @return                 boolean value of property
     */
    public boolean getBooleanProfileProperty(String section, String tag, String fallbackSection, String fallbackTag) {
        return Boolean.valueOf(getProfileProperty(section,tag,fallbackSection,fallbackTag)).booleanValue();
    }

    /**
     * Returns the Profile property as integer. Returns value of -1 if section/tag not found.
     * 
     * @param section  Section of the property
     * @param tag       Key of the property
     * @return integer value
     */
    public int getIntegerProfileProperty(String section, String tag) {
        return getIntegerProfileProperty(section,tag,null,null);
    }

    /**
     * Returns the Profile property as integer. Returns value of -1 if section/tag not found.
     * Caller specifies both a primary and fallback set of section/tag pairs. The search order is:
     * <ol>
     *   <li>primary section/tag ini entry</li>
     *   <li>fallback section/tag ini entry</li>
     *   <li>primary section/tag defaultValueFinder</li>
     *   <li>fallback section/tag defaultValueFinder</li>
     * </ol>
     * 
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @param fallbackSection  Second section name in the profile to look for
     * @param fallbackTag      Second tag name to look for
     * @return integer value
     */
    public int getIntegerProfileProperty(String section, String tag, String fallbackSection, String fallbackTag) {
        try {
            return Integer.parseInt(getProfileProperty(section,tag,fallbackSection,fallbackTag));
        } catch (NumberFormatException e) {
            return -1;
        }
    }

    /**
     * Returns the Profile property as a color. Returns null if the section/tag is not found.
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @return Color           Color
     */
    public Color getColorProfileProperty(String section, String tag) {
        return getColorProfileProperty(section,tag,null,null);
    }


    /**
     * Returns the Profile property as a color. Returns null if the section/tag is not found.
     * Caller specifies both a primary and fallback set of section/tag pairs. The search order is:
     * <ol>
     *   <li>primary section/tag ini entry</li>
     *   <li>fallback section/tag ini entry</li>
     *   <li>primary section/tag defaultValueFinder</li>
     *   <li>fallback section/tag defaultValueFinder</li>
     * </ol>
     * 
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @param fallbackSection  Second section name in the profile to look for
     * @param fallbackTag      Second tag name to look for
     * @return Color          Color
     */
    public Color getColorProfileProperty(String section, String tag, String fallbackSection, String fallbackTag) {
        String clr=getProfileProperty(section,tag,fallbackSection,fallbackTag);
        Color c=null;
        int r             =0;   
        int g             =0;
        int b             =0;
        int a             =255;
        if (clr!=null) {
            StringTokenizer st=new StringTokenizer(clr, ", ", false);
            try {
                r=Integer.parseInt(st.nextToken());
                g=Integer.parseInt(st.nextToken());
                b=Integer.parseInt(st.nextToken());
                if (st.hasMoreTokens()) {
                    a=Integer.parseInt(st.nextToken());
                }
                c=new Color(r, g, b, a);
            } catch (Exception e) {
                SystemLog.debug("Error loading color '"+tag+"' from profile",e);
            }
        }
        return c;
    }


    /**
     * Returns the Profile property as a font. Returns null if the section/tag is not found.
     * 
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @return font
     */
    public Font getFontProfileProperty(String section, String tag) {
        return getFontProfileProperty(section,tag,null,null);
    }


    /**
     * Returns the Profile property as a color. Returns null if the section/tag is not found.
     * Caller specifies both a primary and fallback set of section/tag pairs. The search order is:
     * <ol>
     *   <li>primary section/tag ini entry</li>
     *   <li>fallback section/tag ini entry</li>
     *   <li>primary section/tag defaultValueFinder</li>
     *   <li>fallback section/tag defaultValueFinder</li>
     * </ol>
     * 
     * @param section          First section name in the profile to look for
     * @param tag              First tag name to look for
     * @param fallbackSection  Second section name in the profile to look for
     * @param fallbackTag      Second tag name to look for
     * @return font
     */
    public Font getFontProfileProperty(String section, String tag, String fallbackSection, String fallbackTag) {
        String options=getProfileProperty(section,tag,fallbackSection,fallbackTag);
        Font f=null;
        String name;   
        int size=16;
        int style=0;
        if (options!=null) {
            StringTokenizer st=new StringTokenizer(options, ", ", false);
            try {
                name=st.nextToken();
                if (st.hasMoreTokens()) {
                    size=Integer.parseInt(st.nextToken());
                }
                if (st.hasMoreTokens()) {
                    style=Integer.parseInt(st.nextToken());
                }
                f = new Font(name, style, size);
            } catch (Exception e) {
                SystemLog.debug("Error loading font '"+tag+"' from profile",e);
            }
        }
        return f;
    }



    /**
     * Sets value of the specified tag. This method
     * returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @param value           Value to set
     */
    public synchronized void setProfileProperty(String section, String tag,
                                                String value) {
        // If this is the SYSTEM section, push it out to the System properties
        if (section.equals(CATEGORY_SYSTEM)) {
            System.setProperty(tag, value);
            return;
        }

        // Otherwise put the update into the table
        String preValue=getProfileProperty(section, tag);
        String retStr  =null;
        Vector2 v      =(Vector2)ivSectionTable.get(section);
        if (v==null) {
            //create vector
            v=new Vector2();
            ivSectionTable.put(section, v);
        } else { //To avoid duplicate remove the already existing one
            int keyIdx=v.keyIndexOf(tag);
            if (keyIdx!=-1) {
                v.removeElementAt(keyIdx);
            }
        }
        v.put(tag, value);
        if ((preValue==null)||(!preValue.equals(value)))
        // Value has changed
        {
            if (ivModSettings==null) {
                ivModSettings=new ModifiedSettings();
            }
            Hashtable modSection=(Hashtable)ivModSettings.getSections();
            Hashtable sectionHt=(Hashtable)modSection.get(section);
            if (sectionHt==null) {
                sectionHt=new Hashtable();
                modSection.put(section, sectionHt);
            }
            sectionHt.put(tag, value);
        }
    }

    /**
     * Sets value of the specified tag. This method
     * returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @param value           Value to set
     */
    public void setBooleanProfileProperty(String section, String tag,
                                          boolean value) {
        Boolean b=new Boolean(value);
        setProfileProperty(section, tag, b.toString());
    }

    /**
     * Sets value of the specified tag. This method
     *  returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @param c                        Color to set
     */
    public void setColorProfileProperty(String section, String tag, Color c) {
        StringWriter sw=new StringWriter();
        PrintWriter pw=new PrintWriter(sw);
        pw.print(c.getRed()+"," +c.getGreen()+"," +c.getBlue());
        setProfileProperty(section, tag, sw.getBuffer().toString());
    }

    /**
     * Sets value of the specified tag. This method
     *  returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @param value           Value to set
     */
    public void setIntegerProfileProperty(String section,
                                          String tag, int value) {
        Integer b=new Integer(value);
        setProfileProperty(section, tag, b.toString());
    }



    /**
     * This method saves the config settings to the file
     * <p>
     */
    public synchronized void save_profile() throws IOException {
        // If ini file has not been created yet, determine where it should go
        if (iniFileName==null) {
            iniFileName=PathLocater.getDefaultSaveFileName(configFileName);
        }
        //System.out.println("Saving config settings to '"+iniFileName+"'");
        PathLocater.createPathToFile(iniFileName);
        PrintWriter pw=new PrintWriter(new FileWriter(iniFileName), true);
        list(pw);
        setChanged();
        if (ivModSettings!=null)
        // If there were no changes ivModSettings will be null
        {
            notifyObservers(ivModSettings);
            ivModSettings.getSections().clear();
        }
    }

    /**
     * List properties, for debugging.
     * @param out             Output Stream
     */
    public void list(PrintWriter out) {
        //Time Stamp
        out.println("// " +new Date());
        //Print keys without section first
        Vector2 noSection=(Vector2)ivSectionTable.get("");
        if (noSection!=null) {
            int cnt=noSection.size();
            for (int idx=0; idx<cnt; ++idx) {
                try {
                    String key=(String)noSection.keyElementAt(idx);
                    String val=(String)noSection.valueElementAt(idx);
                    out.println(key+"=" +val);
                } catch (ArrayIndexOutOfBoundsException e) {
                    /* ignore exception; this should never happen */
                }
            }
        }
        Enumeration ek=ivSectionTable.keys();
        Enumeration ev=ivSectionTable.elements();
        while (ek.hasMoreElements()) {
            String section=(String)ek.nextElement();
            if (!section.equals("")) {
                out.println("[" +section+"]");
                Vector2 v=(Vector2)ev.nextElement();
                int cntt=v.size();
                for (int idx=0; idx<cntt; ++idx) {
                    try {
                        String key=(String)v.keyElementAt(idx);
                        String val=(String)v.valueElementAt(idx);
                        out.println("  " +key+"=" +val);
                    } catch (ArrayIndexOutOfBoundsException e) {
                        /* ignore exception; this should never happen */
                    }
                }
            }
        }
    }

    /**
     * Locates the configuration profile and returns a BufferedReader to it.
     * 
     * If the profile file is not found, then null is returned.
     */
    public synchronized BufferedReader openProfile() {
        System.out.println("Locating profile: "+configFileName);
        InputStream is = null;
        // First try loading the profile from the local file system
        try {
            System.out.println("Checking local filesystem: ");
            iniFileName=PathLocater.getDefaultSaveFileName(configFileName);
            System.out.println("   look for file "+iniFileName);
            return new BufferedReader(new FileReader(iniFileName));
        } catch (FileNotFoundException e) {
        } catch (Exception e2) {
            e2.printStackTrace();
        }

        // Next try loading the profile from the device's web file system
        try {
            if (PathLocater.getDocumentBase()!=null) {
                System.out.println("Checking device web filesystem: ");
                URL iniFileUrl = new URL(PathLocater.getDocumentBase(), configFileName);
                System.out.println("   look for file "+iniFileUrl);
                return new BufferedReader(new InputStreamReader(iniFileUrl.openStream()));
            }
        } catch (IOException e) {
        } catch (Exception e2) {
            e2.printStackTrace();
        }

        // Next, try loading the profile from the jar file
        try {
            System.out.println("Checking jar filesystem: ");
            URL iniFileUrl = this.getClass().getResource(configFileName);
            System.out.println("   look for file "+iniFileUrl);
            if (iniFileUrl!=null) {
                return new BufferedReader(new InputStreamReader(iniFileUrl.openStream()));
            }
        } catch (Exception e2) {
            e2.printStackTrace();
        }

        System.out.println("profile not found. Using defaults.");
        return null;
    }


    /**
     * Loads configuration file contents into the ConfigSettings object.
     * @exception FileNotFoundException   File not found
     * @exception IOException             File read or close error
     */
    public synchronized void load_profile() throws IOException {
        
        BufferedReader s = openProfile();
        if (s==null) {
            return;
        }


//        BufferedReader s=null;
//        s=new BufferedReader((new FileReader(iniFileName));
        String line;
        // create a vector2 object for the default section.
        String section_prefix="";
        Vector2 curSection=new Vector2();
        ivSectionTable.put(section_prefix, curSection);
        try {
            while ((line=s.readLine())!=null) {
                line=line.trim();
                // check for blank line
                if (line.length()==0) {
                    continue;
                }

                // Looking for comment
                int comment=line.indexOf("//");
                if (comment!=-1) {
                    // read next line if comment start from beginning (comment == 0 )
                    // or the line only contain '//' (line.length == 2)
                    if (comment==0||line.length()==2) {
                        continue;
                    }

                    // get rid of the all the trailing comment and trim the result text
                    line=(line.substring(0, comment)).trim();
                    if (line.length()==0) {
                        continue;
                    }
                }
                // Perform tag substitutions
                int srchPosn=line.indexOf('=');
                int macPosnStart=line.indexOf("$(", srchPosn);
                int macPosnEnd;
                // repeat substitution until no "$(" is found
                while (macPosnStart!=-1) {
                    macPosnEnd=line.indexOf(')', macPosnStart);
                    if (macPosnEnd!=-1) {
                        // found $(macro) - extract section.tag names from macro
                        String macName=
                        (line.substring(macPosnStart+2,
                                        macPosnEnd)).trim();
                        String sectName="";
                        int sectEnd=macName.indexOf(':');
                        if (sectEnd!=-1) {
                            sectName=(macName.substring(0,
                                                        sectEnd)).trim();
                            macName=(macName.substring(sectEnd+1)).trim();
                        }
                        String subStr=getProfileProperty(sectName,
                                                         macName);
                        if (subStr==null) {
                            subStr="";
                        }
                        // substitution found
                        line=line.substring(0, macPosnStart)+subStr+
                             line.substring(macPosnEnd+1);
                    } else {
                        // found $( with no matching )
                        srchPosn=macPosnStart+2;
                    }
                    macPosnStart=line.indexOf("$(", srchPosn);
                }
                // Check if line is a section defintion
                if (line.charAt(0)=='[') {
                    // process section text
                    int section_end=line.indexOf(']');
                    if (section_end==-1) {
                        // Invalid Section definition ; ill formed section name
                        return;
                    }
                    // all text after the ']' is ignored
                    section_prefix=(line.substring(1, section_end)).trim();
                    //If the section is already there, then use it else create new section
                    if ((curSection=(Vector2)
                         ivSectionTable.get("section_prefix"))==null) {
                        curSection=new Vector2();
                        ivSectionTable.put(section_prefix, curSection);
                    }
                    continue;
                }
                String key;
                String txt;
                int assign_sign=line.indexOf('=');
                if (assign_sign==-1) {
                    // No replace text tag
                    key=line;
                    txt="";
                } else {
                    key=(line.substring(0, assign_sign)).trim();
                    txt=(line.substring(assign_sign+1)).trim();
                }
                // trim String delimiter at beginning and end of text string
                int txtLength=txt.length();
                if (txtLength>1&&txt.charAt(0)=='"' &&
                    txt.charAt(txtLength-1)=='"') {
                    // white spaces within the '"' delimiter are significant
                    //  **** DON'T trim. ****
                    txt=txt.substring(1, txtLength-1);
                }
                // Put key into Vector2 table - make sure no duplicate key in Vector2
                int keyIdx=curSection.keyIndexOf(key);
                if (keyIdx!=-1) {
                    curSection.removeElementAt(keyIdx);
                }
                curSection.put(key, txt);
            }
        } catch (IOException io) {
            throw io;
        }
        try {
            s.close();
        } catch (IOException io) {
            throw io;
        }
    }


    //=============================================================
    // Static helper methods
    //=============================================================


    /**
     * Gets boolean value of the specified key in the specified category. This method
     * returns false if the value associated with the category/key is not actually a
     * boolean value.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, a MissingResourceException is thrown.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static boolean getBoolean(String category, String key) {
        return getInstance().getBooleanProfileProperty(category, key);
    }

    /**
     * Gets boolean value of the specified key in the specified category. This method
     * returns false if the value associated with the category/key is not actually a
     * boolean value.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, a MissingResourceException is thrown.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static boolean getBoolean(String category, String key, String fallbackSection, String fallbackTag) {
        return getInstance().getBooleanProfileProperty(category, key, fallbackSection, fallbackTag);
    }

    /**
     * Sets the boolean value of the specified key in the specified category. If the key
     * already exists in this category, the provided value will replace the existing value.
     *
     * @param category  is the name of the setting category into which the key/value pair is
     *                  inserted.  If it does not exist, it will be created.
     * @param key       is the name of the key to the value within the category
     * @param value     is the boolean value to be inserted into the ConfigSettings
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     */
    public static void setBoolean(String category, String key, boolean value) {
        getInstance().setBooleanProfileProperty(category, key, value);
    }

    /**
     * Gets integer value of the specified key in the specified category.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, false is returned.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     * @throws NumberFormatException if the requested value is not actually an integer.
     */
    public static int getInteger(String category, String key) {
        return getInstance().getIntegerProfileProperty(category, key);
    }

    /**
     * Gets integer value of the specified key in the specified category.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, false is returned.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     * @throws NumberFormatException if the requested value is not actually an integer.
     */
    public static int getInteger(String category, String key, String fallbackSection, String fallbackTag) {
        return getInstance().getIntegerProfileProperty(category, key, fallbackSection, fallbackTag);
    }

    /**
     * Sets the integer value of the specified key in the specified category. If the key
     * already exists in this category, the provided value will replace the existing value.
     *
     * @param category  is the name of the setting category into which the key/value pair is
     *                  inserted.  If it does not exist, it will be created.
     * @param key       is the name of the key to the value within the category
     * @param value     is the integer value to be inserted into the ConfigSettings
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     */
    public static void setInteger(String category, String key, int value) {
        getInstance().setIntegerProfileProperty(category, key, value);
    }


    /**
     * Gets font value of the specified tag. This method
     * returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @return font
     */
    public static Font getFont(String section, String tag) {
        return getInstance().getFontProfileProperty(section,tag,null,null);
    }

    /**
     * Gets font value of the specified tag. This method
     * returns null if the tag is not found.
     * @param section         Section name in the profile
     * @param tag             Tag name
     * @return font
     */
    public static Font getFont(String section, String tag, String fallbackSection, String fallbackTag) {
        return getInstance().getFontProfileProperty(section,tag,fallbackSection,fallbackTag);
    }

    /**
     * Gets color value of the specified key in the specified category. This method
     * returns false if the value associated with the category/key is not actually a
     * color value.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, a MissingResourceException is thrown.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static Color getColor(String category, String key) {
        return getInstance().getColorProfileProperty(category, key);
    }

    /**
     * Gets color value of the specified key in the specified category. This method
     * returns false if the value associated with the category/key is not actually a
     * color value.
     * <p>
     * The logic will first look for the value by searching the specified category in the
     * ConfigSettings for the specified key.  If either the category or the key cannot be found,
     * the logic will perform the same search in the DefaultConfigSettings.  If a value is still
     * not found, a MissingResourceException is thrown.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          <code>true</code> if and only if the value associated with
     *                  the category/key is true.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static Color getColor(String category, String key, String fallbackSection, String fallbackTag) {
        return getInstance().getColorProfileProperty(category, key, fallbackSection, fallbackTag);
    }

    /**
     * Sets the color value of the specified key in the specified category. If the key
     * already exists in this category, the provided value will replace the existing value.
     *
     * @param category  is the name of the setting category into which the key/value pair is
     *                  inserted.  If it does not exist, it will be created.
     * @param key       is the name of the key to the value within the category
     * @param value     is the color value to be inserted into the ConfigSettings
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     */
    public static void setColor(String category, String key, Color value) {
        getInstance().setColorProfileProperty(category, key, value);
    }

    /**
     * Gets value of the specified key within the specified category in the ConfigSettings.
     * If a value is not found, the same search will be repeated in the DefaultConfigSettings.
     * If a value is still not found, a MissingResourceException will be thrown.  An exception
     * to this search order occurs when the category = 'System'.  In that case, only the System
     * properties are searched.
     *
     * NOTE: the category and key parameters are case sensitive.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          the String associated with the specified category/key.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static String getProperty(String category, String key) {
        if ((category==null)||(key==null)) {
            throw new IllegalArgumentException("Category and Key are MANDATORY parameters");
        }
        String retValue=getInstance().getProfileProperty(category, key);
        if (retValue==null) {
            throw new MissingResourceException("Value not found for category: " +
                                               category+" and key: " +key, category, key);
        }
        return retValue;
    } //end getProperty

    /**
     * Gets value of the specified key within the specified category in the ConfigSettings.
     * If a value is not found, the same search will be repeated in the DefaultConfigSettings.
     * If a value is still not found, a MissingResourceException will be thrown.  An exception
     * to this search order occurs when the category = 'System'.  In that case, only the System
     * properties are searched.
     *
     * NOTE: the category and key parameters are case sensitive.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @return          the String associated with the specified category/key.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static String getProperty(String category, String key, String fallbackSection, String fallbackTag) {
        if ((category==null)||(key==null)) {
            throw new IllegalArgumentException("Category and Key are MANDATORY parameters");
        }
        String retValue=getInstance().getProfileProperty(category, key, fallbackSection, fallbackTag);
        if (retValue==null) {
            throw new MissingResourceException("Value not found for category: " +
                                               category+" and key: " +key, category, key);
        }
        return retValue;
    } //end getProperty

    /**
     * Gets value of the specified key within the specified category in the ConfigSettings.
     * If a value is not found, the same search will be repeated in the DefaultConfigSettings.
     * If a value is still not found, the provided dftRetValue will be returned.  An exception
     * to this search order occurs when the category = 'System'.  In that case, only the System
     * properties are searched (but the provided dftRetValue is still returned if a value is
     * not found in the System Properties).
     *
     * NOTE: the category and key parameters are case sensitive.  It is suggested that callers
     * always use the constants provided by this class when specifying the category.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @param dftRetValue is the default return String if a value for the specified category/key
     *                  is not found in the configSettings.
     * @return          the String associated with the specified category/key.  If one is not
     *                  found in the configSettings, the provided default value will be returned.
     *
     * @throws IllegalArgumentException if the category or key values are either not
     *         provided or are empty Strings.
     * @throws MissingResourceException if a value for the specified category/key is
     *         not found.
     */
    public static String getProperty(String category, String key,
                                     String dftRetValue) {
        String retValue=null;
        try {
            retValue=getProperty(category, key);
        } catch (MissingResourceException mre) {
            retValue=dftRetValue;
        }

        return retValue;
    }

    /**
     * Sets the provided value under the specified key within the specified category in the ConfigSettings.
     * If the key/value already exists in the specified category, the value will be replaced.  If the
     * specified category does not already exist, it will be created.
     *
     * NOTE: the category and key parameters are case sensitive.  It is strongly suggested that the
     * constants for the categories provided by this class are used when specifying the category parameter.
     *
     * NOTE: values placed in the <code>System</code> or <code>CFG</code> categories
     * will <strong>NOT</strong> be persisted between restarts of this application.
     *
     * @param category  is the name of the setting category to search
     * @param key       is the name of the key to the value within the category
     * @param value     is the String value to be placed in the ConfigSettings
     *
     * @throws IllegalArgumentException if the category or key values are
     *         empty Strings.
     * @throws NullPointerException if the category, key or value are null.
     */
    public static void setProperty(String category, String key, String value) {
        if ((category.length()==0)||(key.length()==0)) {
            throw new IllegalArgumentException("Category and Key are MANDATORY parameters and must not be empty Strings");
        }
        getInstance().setProfileProperty(category, key, value);
    } //end setProperty


    /**
     * This method saves the config settings to the ini file
     * <p>
     */
    public static void save() throws IOException {
        getInstance().save_profile();
    }

}