ossimPreferences.cpp

Go to the documentation of this file.

//*******************************************************************
//
// License:  See top level LICENSE.txt file.
// 
// DESCRIPTION:
//   Contains implementation of class ossimPreferences. This class provides
//   a static keywordlist for global preferences. Objects needing access to
//   application-wide global parameters shall do so through this class.
//
// SOFTWARE HISTORY:
//>
//   23Apr2001  Oscar Kramer (okramer@imagelinks.com)
//              Initial coding.
//<
//*****************************************************************************

#include <cstdlib> /* for getenv() */

#include <ossim/base/ossimPreferences.h>
#include <ossim/base/ossimNotify.h>

//RTTI_DEF1(ossimPreferences, "ossimPreferences" , ossimObject)

//***
// Define Trace flags for use within this file:
//***
#include <ossim/base/ossimTrace.h>
static ossimTrace traceExec  ("ossimPreferences:exec");
static ossimTrace traceDebug ("ossimPreferences:debug");

static const char* PREF_FILE_ENV_VAR_NAME = "OSSIM_PREFS_FILE";

ossimPreferences* ossimPreferences::theInstance = NULL;

ossimPreferences::ossimPreferences()
{
   theKWL.setExpandEnvVarsFlag( true );
   loadPreferences();
}

ossimPreferences::~ossimPreferences()
{
        theInstance = NULL;
}

/*!****************************************************************************
 * METHOD: ossimPreferences::instance()
 *  
 *  This is the method by which run-time objects access this singleton instance
 *  
 *****************************************************************************/
ossimPreferences* ossimPreferences::instance()
{
   if (theInstance)
      return theInstance;

   theInstance = new ossimPreferences();

   return theInstance;
}

/*!****************************************************************************
 * METHOD: loadPreferences()
 *  
 *  Loads the preferences file specified in the runtime environment.
 *  
 *****************************************************************************/
bool ossimPreferences::loadPreferences()
{
   static const char MODULE[] = "ossimPreferences::loadPreferences()";
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE << " entering...\n";
   }

   bool parsed_ok = false;
   
   char* pref_filename = getenv(PREF_FILE_ENV_VAR_NAME);

   //std::cout << "ossimPreferences::loadPreferences() ======== " << ossimString(pref_filename) << "\n";
   if (pref_filename)
   {
      thePrefFilename = pref_filename;
      parsed_ok = theKWL.addFile(pref_filename);

      if (!parsed_ok)
      {
        if(traceDebug())
        {
          ossimNotify(ossimNotifyLevel_WARN)
            << "WARNING: " << MODULE
            << ", an error was encountered loading the prefererences "
            << "file at \"" << thePrefFilename << "\" as specified by the "
            << "environment variable \"" << PREF_FILE_ENV_VAR_NAME << "\"."
            << "Preferences were not loaded.\n";
          
        }
      }
   }
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE << "returning...\n";
   }
   return parsed_ok;
}

/*!****************************************************************************
 * METHOD: loadPreferences(filename)
 *  
 *  Loads the preferences file specified in the arg.
 *  
 *****************************************************************************/
bool ossimPreferences::loadPreferences(const ossimFilename& pathname)
{
   static const char MODULE[] = "ossimPreferences::loadPreferences(filename)";
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE << ", entering...\n";
   }

   bool parsed_ok;

   theKWL.clear();
   theInstanceIsModified = true;
   
   thePrefFilename = pathname;
   parsed_ok = theKWL.addFile(pathname);

   if (!parsed_ok)
   {
      ossimNotify(ossimNotifyLevel_WARN)
         << "WARNING: " << MODULE
         << ", an error was encountered loading the prefererences "
         << "file at \"" << pathname << "\". Preferences were not "
         << "loaded.\n";
   }

   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE<< ", returning...\n";
   }
   
   return parsed_ok;
}

/*!****************************************************************************
 * METHOD: ossimPreferences::savePreferences()
 *  
 *  Saves KWL to the current filename.
 *  
 *****************************************************************************/
bool ossimPreferences::savePreferences() const
{
   static const char MODULE[] = "ossimPreferences::savePreferences()";
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE << ", entering...\n";
   }
   
   bool success = true;
   
   if (theInstanceIsModified)
   {
      theKWL.write(thePrefFilename);
      theInstanceIsModified = false;
   }

   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG:" << MODULE << ", returning...\n";
   }
   
   return success;
}

/*!****************************************************************************
 * METHOD: ossimPreferences::savePreferences(filename)
 *  
 *  Saves KWL to the specified filename.
 *  
 *****************************************************************************/
bool ossimPreferences::savePreferences(const ossimFilename& pathname)
{
   static const char MODULE[] = "ossimPreferences::savePreferences()";
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: "<< MODULE << ", entering...\n";
   }
   
   bool success = true;
   
   theKWL.write(pathname);

   thePrefFilename = pathname;
   theInstanceIsModified = false;
   
   if (traceExec())
   {
      ossimNotify(ossimNotifyLevel_DEBUG)
         << "DEBUG: " << MODULE << ", returning...\n";
   }
   
   return success;
}

void ossimPreferences::addPreference(const char* key, const char* value)
{
   theKWL.add(key, value, true);
   theInstanceIsModified = true;
}

void ossimPreferences::addPreferences(const ossimKeywordlist& kwl,
                                      const char* prefix,
                                      bool stripPrefix)
{
   theKWL.add(kwl, prefix, stripPrefix);
   theInstanceIsModified = true;
}

ossimFilename ossimPreferences::getPreferencesFilename() const
{
   return thePrefFilename;
}