pluginManager.h

Go to the documentation of this file.

#ifndef BALL_PLUGIN_PLUGINMANAGER_H
#define BALL_PLUGIN_PLUGINMANAGER_H

#ifndef BALL_CONCEPT_PREFERENCESOBJECT_H
# include <BALL/CONCEPT/preferencesObject.h>
#endif

#include <QtCore/QString>
#include <QtCore/QHash>
#include <QtCore/QMutex>
#include <QtCore/QReadWriteLock>

#include <boost/shared_ptr.hpp>

#include <list>
#include <map>

class QPluginLoader;
class QObject;

namespace BALL
{
  class BALLPlugin;
  class PluginHandler;

  class BALL_EXPORT PluginManager
    : public PreferencesObject
  {
    
    public: 

      virtual ~PluginManager();

      static PluginManager& instance();

      void addPluginDirectory(const QString& dir, bool autoactivate = false);
      
      bool removePluginDirectory(const QString& dir);

      vector<QString> getPluginDirectories() const;

      BALLPlugin* loadPlugin(const QString& plugin_name);

      bool unloadPlugin(const QString& plugin);

      QObject* getPluginInstance(const QString& plugin);

      QObject* getPluginInstance(int pos);

      bool startPlugin(int plugin);

      bool startPlugin(const QString& plugin);

      bool startPlugin(BALLPlugin* plugin);

      bool stopPlugin(int plugin);

      bool stopPlugin(const QString& plugin);

      bool stopPlugin(BALLPlugin* plugin);

      void unloadAllPlugins();

      int getPluginCount() const;

      void registerHandler(PluginHandler* h);
  
      // needed for storing this classes' preferences
      virtual bool getValue(String&) const;
      virtual bool setValue(const String&);

    protected: 
      static const char* BETWEEN_PLUGINDIR_SEPERATOR;

      PluginManager();
      PluginManager(const PluginManager&);
      const PluginManager& operator=(const PluginManager&);

      std::map<QString, vector<BALLPlugin*> > loaded_plugin_dirs_;
      
      QHash<QString, QPluginLoader*> loaders_;
      std::list<PluginHandler*> handlers_;

      static boost::shared_ptr<PluginManager> manager_;

      //This mutex is used in the creation of the singleton
      static QMutex mutex_;
      //This mutex guards the handlers_ list
      mutable QReadWriteLock handler_mutex_;
      //This mutex guards the loaders_ list
      mutable QReadWriteLock loader_mutex_;
  };
}

#endif //BALL_PLUGIN_PLUGINMANAGER_H