PluginFactoryBase.h

Go to the documentation of this file.

#ifndef FWCore_PluginManager_PluginFactoryBase_h
#define FWCore_PluginManager_PluginFactoryBase_h
// -*- C++ -*-
//
// Package:     PluginManager
// Class  :     PluginFactoryBase
// 
//
// Original Author:  Chris Jones
//         Created:  Wed Apr  4 12:24:44 EDT 2007
// $Id: PluginFactoryBase.h,v 1.8 2013/01/20 17:12:17 chrjones Exp $
//

// system include files
#include <string>
#include <vector>
#include <map>
#include "FWCore/Utilities/interface/Signal.h"
// user include files
#include "FWCore/PluginManager/interface/PluginInfo.h"

// forward declarations
namespace edmplugin {
class PluginFactoryBase
{

   public:
      PluginFactoryBase() {}
      virtual ~PluginFactoryBase();

      typedef std::vector<std::pair<void*, std::string> > PMakers;
      typedef std::map<std::string, PMakers > Plugins;

      // ---------- const member functions ---------------------

      virtual std::vector<PluginInfo> available() const;

      virtual const std::string& category() const = 0;
      
      mutable edm::signalslot::Signal<void(const std::string&, const PluginInfo&)> newPluginAdded_;

      // ---------- static member functions --------------------

      // ---------- member functions ---------------------------

   protected:
      void finishedConstruction();
      
      void newPlugin(const std::string& iName);

      //since each inheriting class has its own Container type to hold their PMakers
      // this function allows them to share the same code when doing the lookup
      // this routine will throw an exception if iName is unknown therefore the return value is always valid
      Plugins::const_iterator findPMaker(const std::string& iName) const;

      //similar to findPMaker but will return 'end()' if iName is known
      Plugins::const_iterator tryToFindPMaker(const std::string& iName) const;
      
      void fillInfo(const PMakers &makers,
                    PluginInfo& iInfo,
                    std::vector<PluginInfo>& iReturn ) const;

      void fillAvailable(std::vector<PluginInfo>& iReturn) const;

      void registerPMaker(void* iPMaker, const std::string& iName);
      
      Plugins m_plugins;
      
   private:
      PluginFactoryBase(const PluginFactoryBase&); // stop default

      const PluginFactoryBase& operator=(const PluginFactoryBase&); // stop default

      void checkProperLoadable(const std::string& iName, const std::string& iLoadedFrom) const;
      // ---------- member data --------------------------------

};

}
#endif