ossimDynamicLibrary Class Reference

#include <ossimDynamicLibrary.h>

Inheritance diagram for ossimDynamicLibrary:

Public Member Functions
	ossimDynamicLibrary ()
	ossimDynamicLibrary (const ossimString &name)
virtual	~ossimDynamicLibrary ()
bool	isLoaded () const
bool	load (const ossimString &name)
bool	load ()
void	unload ()
void *	getSymbol (const ossimString &name) const
const ossimString &	getName () const
Public Member Functions inherited from ossimReferenced
	ossimReferenced ()
	ossimReferenced (const ossimReferenced &)
ossimReferenced &	operator= (const ossimReferenced &)
void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...
void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...
void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...
int	referenceCount () const

Protected Attributes
void *	theLibrary
ossimString	theLibraryName

Additional Inherited Members
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Detailed Description

Definition at line 27 of file ossimDynamicLibrary.h.

Constructor & Destructor Documentation

ossimDynamicLibrary() [1/2]

ossimDynamicLibrary::ossimDynamicLibrary

(

)

Definition at line 19 of file ossimDynamicLibrary.cpp.

   :theLibrary(0)
{
}

ossimDynamicLibrary() [2/2]

ossimDynamicLibrary::ossimDynamicLibrary

(

const ossimString &

name

)

Definition at line 24 of file ossimDynamicLibrary.cpp.

References load().

{
   load(name);
}

~ossimDynamicLibrary()

ossimDynamicLibrary::~ossimDynamicLibrary ( )

virtual

Definition at line 29 of file ossimDynamicLibrary.cpp.

References unload().

{
   unload();
}

Member Function Documentation

getName()

const ossimString& ossimDynamicLibrary::getName ( ) const

inline

Definition at line 48 of file ossimDynamicLibrary.h.

Referenced by ossimSharedPluginRegistry::isLoaded(), and ossimSharedPluginRegistry::printAllPluginInformation().

   {
      return theLibraryName;
   }

getSymbol()

void * ossimDynamicLibrary::getSymbol

(

const ossimString &

name

)

const

Definition at line 93 of file ossimDynamicLibrary.cpp.

References ossimString::c_str(), isLoaded(), and theLibrary.

Referenced by ossimPluginLibrary::finalize(), ossimPluginLibrary::initialize(), and ossimSharedPluginRegistry::registerPlugin().

{
   if(isLoaded())
   {
#if defined(__WIN32__) || defined(_WIN32)
      return (void*)GetProcAddress( (HINSTANCE)theLibrary, name.c_str());
#else
      return dlsym(theLibrary, name.c_str());
#endif
   }

   return (void*)0;
}

isLoaded()

bool ossimDynamicLibrary::isLoaded ( ) const

inline

Definition at line 34 of file ossimDynamicLibrary.h.

Referenced by ossimPluginLibrary::getDescription(), getSymbol(), ossimPluginLibrary::initialize(), load(), and unload().

{ return theLibrary != 0; }

load() [1/2]

bool ossimDynamicLibrary::load

(

const ossimString &

name

)

Definition at line 39 of file ossimDynamicLibrary.cpp.

References ossimString::c_str(), ossimString::empty(), ossimFilename::isFile(), isLoaded(), ossimNotify(), ossimNotifyLevel_WARN, theLibrary, theLibraryName, and ossimString::trim().

Referenced by ossimSharedPluginRegistry::registerPlugin().

{
   ossimFilename libraryName = name.trim();
   if(libraryName.empty()||!libraryName.isFile())
      return false;
   
#  if defined(__WIN32__) || defined(_WIN32)
   theLibrary = LoadLibrary(libraryName.c_str());
#  else 
   //theLibrary = dlopen(libraryName.c_str(), RTLD_LAZY|RTLD_LOCAL);
   // Use of RTLD_GLOBAL fixes CSM3 plugin with MSP loading CSM plugins, but requires unique
   // variable and method names in all *PluginInit.cpp code.
   theLibrary = dlopen(libraryName.c_str(), RTLD_LAZY|RTLD_GLOBAL);
#endif

   if (isLoaded())
   {
      theLibraryName = libraryName;
   }
   else
   {
      ossimNotify(ossimNotifyLevel_WARN)<<"ossimDynamicLibrary:"<<__LINE__
            << "  Failed to load library:  " << name << std::endl;
#if !defined(__WIN32__) && !defined(_WIN32)
      ossimNotify(ossimNotifyLevel_WARN) << dlerror() << std::endl;
#endif
   }

   if (traceDebug())
   {
      if (isLoaded())
      {
         ossimNotify(ossimNotifyLevel_DEBUG)<<"ossimDynamicLibrary:"<<__LINE__
               << "  Loaded library:  " << name << std::endl;
      }
   }
   
   return isLoaded();
}

load() [2/2]

bool ossimDynamicLibrary::load

(

)

Definition at line 34 of file ossimDynamicLibrary.cpp.

References theLibraryName.

Referenced by ossimPluginLibrary::initialize(), and ossimDynamicLibrary().

{
   return load(theLibraryName);
}

unload()

void ossimDynamicLibrary::unload

(

)

Definition at line 79 of file ossimDynamicLibrary.cpp.

References isLoaded(), and theLibrary.

Referenced by ossimPluginLibrary::finalize(), and ~ossimDynamicLibrary().

{
   if(isLoaded())
   {
#if defined(__WIN32__) || defined(_WIN32)
      FreeLibrary(theLibrary);
// #else HAVE_DLFCN_H
#else
      dlclose(theLibrary);
#endif
      theLibrary = 0;
   }
}

Member Data Documentation

theLibrary

void* ossimDynamicLibrary::theLibrary

protected

Definition at line 58 of file ossimDynamicLibrary.h.

Referenced by getSymbol(), load(), and unload().

theLibraryName

ossimString ossimDynamicLibrary::theLibraryName

protected

Definition at line 60 of file ossimDynamicLibrary.h.

Referenced by load().

---

The documentation for this class was generated from the following files:

• ossimDynamicLibrary.h
• ossimDynamicLibrary.cpp