edmplugin::PluginCapabilities Class Reference

#include <PluginCapabilities.h>

Inheritance diagram for edmplugin::PluginCapabilities:

Public Member Functions
virtual std::vector< PluginInfo >	available () const
	return info about all plugins which are already available in the program More...
virtual const std::string &	category () const
	returns the name of the category to which this plugin factory belongs More...
void	load (const std::string &iName)
bool	tryToFind (const SharedLibrary &iLoadable)
	Check to see if any capabilities are in the file, returns 'true' if found. More...
bool	tryToLoad (const std::string &iName)
virtual	~PluginCapabilities ()
Public Member Functions inherited from edmplugin::PluginFactoryBase
	PluginFactoryBase ()
virtual	~PluginFactoryBase ()

Static Public Member Functions
static PluginCapabilities *	get ()

Private Member Functions
const PluginCapabilities &	operator= (const PluginCapabilities &)
	PluginCapabilities ()
	PluginCapabilities (const PluginCapabilities &)

Private Attributes
std::map< std::string, boost::filesystem::path >	classToLoadable_

Friends
class	DummyFriend

Additional Inherited Members
Public Types inherited from edmplugin::PluginFactoryBase
typedef tbb::concurrent_unordered_map < std::string, PMakers >	Plugins
typedef tbb::concurrent_vector < PluginMakerInfo >	PMakers
Public Attributes inherited from edmplugin::PluginFactoryBase
edm::signalslot::Signal< void(const std::string &, const PluginInfo &)>	newPluginAdded_
	signal containing plugin category, and plugin info for newly added plugin More...
Protected Member Functions inherited from edmplugin::PluginFactoryBase
void	fillAvailable (std::vector< PluginInfo > &iReturn) const
void	fillInfo (const PMakers &makers, PluginInfo &iInfo, std::vector< PluginInfo > &iReturn) const
void *	findPMaker (const std::string &iName) const
void	finishedConstruction ()
void	newPlugin (const std::string &iName)
void	registerPMaker (void *iPMaker, const std::string &iName)
void *	tryToFindPMaker (const std::string &iName) const

Detailed Description

Definition at line 32 of file PluginCapabilities.h.

Constructor & Destructor Documentation

PluginCapabilities::~PluginCapabilities ( )

virtual

Definition at line 43 of file PluginCapabilities.cc.

{
}

PluginCapabilities::PluginCapabilities ( )

private

Definition at line 33 of file PluginCapabilities.cc.

References edmplugin::PluginFactoryBase::finishedConstruction().

{
  finishedConstruction();
}

edmplugin::PluginCapabilities::PluginCapabilities ( const PluginCapabilities &  )

private

Member Function Documentation

std::vector< PluginInfo > PluginCapabilities::available ( ) const

virtual

return info about all plugins which are already available in the program

Reimplemented from edmplugin::PluginFactoryBase.

Definition at line 138 of file PluginCapabilities.cc.

References classToLoadable_, info(), benchmark_cfg::infos, edmplugin::PluginInfo::loadable_, and edmplugin::PluginInfo::name_.

{
  PluginInfo info;
  std::vector<PluginInfo> infos;
  infos.reserve(classToLoadable_.size());
  
  for(std::map<std::string, boost::filesystem::path>::const_iterator it = classToLoadable_.begin();
      it != classToLoadable_.end();
      ++it) {
    info.name_ = it->first;
    info.loadable_ = it->second;
    infos.push_back(info);
  }
  return infos;
}

const std::string & PluginCapabilities::category ( ) const

virtual

returns the name of the category to which this plugin factory belongs

Implements edmplugin::PluginFactoryBase.

Definition at line 155 of file PluginCapabilities.cc.

References AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by load(), tryToFind(), and tryToLoad().

{
  static const std::string s_cat("Capability");
  return s_cat;
}

PluginCapabilities * PluginCapabilities::get ( )

static

Definition at line 165 of file PluginCapabilities.cc.

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), edm::ProductRegistryHelper::addToRegistry(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), edm::service::InitRootHandlers::InitRootHandlers(), edm::service::LoadAllDictionaries::LoadAllDictionaries(), edm::loadCap(), ora::ClassUtils::loadDictionary(), main(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

                        {
  [[cms::thread_safe]] static PluginCapabilities s_instance;
  return &s_instance;
}

void PluginCapabilities::load

(

const std::string &

iName

)

Definition at line 90 of file PluginCapabilities.cc.

References category(), classToLoadable_, edm::hlt::Exception, edmplugin::PluginManager::get(), edmplugin::PluginManager::load(), edmplugin::SharedLibrary::path(), and tryToFind().

Referenced by edm::service::InitRootHandlers::InitRootHandlers(), edm::service::LoadAllDictionaries::LoadAllDictionaries(), edm::loadCap(), and ora::ClassUtils::loadDictionary().

{
  if(classToLoadable_.end() == classToLoadable_.find(iName) ) {
    const SharedLibrary& lib = PluginManager::get()->load(category(),
                                                          iName);
    //read the items from the 'capabilities' symbol
    if(not tryToFind(lib) ) {
      throw cms::Exception("PluginNotFound")<<"The dictionary for class '"<<iName <<"' is supposed to be in file\n '"
      <<lib.path().string()<<"'\n but no dictionaries are in that file.\n"
      "It appears like the cache is wrong.  Please do 'EdmPluginRefresh "<<lib.path().string()<<"'.";
    }
    
    if(classToLoadable_.end() == classToLoadable_.find(iName)) {
      throw cms::Exception("PluginNotFound")<<"The dictionary for class '"<<iName<<"' is supposed to be in file\n '"
      <<lib.path().string()<<"'\n but was not found.\n"
      "It appears like the cache is wrong.  Please do 'EdmPluginRefresh "<<lib.path().string()<<"'.";
    }
  }
}

const PluginCapabilities& edmplugin::PluginCapabilities::operator= ( const PluginCapabilities &  )

private

bool PluginCapabilities::tryToFind

(

const SharedLibrary &

iLoadable

)

Check to see if any capabilities are in the file, returns 'true' if found.

Definition at line 63 of file PluginCapabilities.cc.

References category(), classToLoadable_, i, info(), edmplugin::PluginInfo::loadable_, mergeVDriftHistosByStation::name, edmplugin::PluginInfo::name_, cscdqm::h::names, edmplugin::PluginFactoryBase::newPluginAdded_, edmplugin::SharedLibrary::path(), findQualityFiles::size, AlCaHLTBitMon_QueryRunRegistry::string, and edmplugin::SharedLibrary::symbol().

Referenced by load(), main(), and tryToLoad().

{
  void* sym;
  if( not iLoadable.symbol("SEAL_CAPABILITIES",sym) ) {
    return false;
  }
  
  const char** names;
  int size;
  //reinterpret_cast<void (*)(const char**&,int&)>(sym)(names,size);
  reinterpret_cast<void (*)(const char**&,int&)>(reinterpret_cast<unsigned long>(sym))(names,size);

  PluginInfo info;
  for(int i=0; i < size; ++i) {
    std::string name(names[i]);
    classToLoadable_[name]=iLoadable.path();
    
    //NOTE: can't use newPlugin(name) to do the work since it assumes
    //  we haven't yet returned from PluginManager::load method
    info.name_ = name;
    info.loadable_ = iLoadable.path();
    this->newPluginAdded_(category(),info);
  }
  return true;
}

bool PluginCapabilities::tryToLoad

(

const std::string &

iName

)

Definition at line 111 of file PluginCapabilities.cc.

References category(), classToLoadable_, edm::hlt::Exception, edmplugin::PluginManager::get(), edmplugin::SharedLibrary::path(), tryToFind(), and edmplugin::PluginManager::tryToLoad().

Referenced by edm::ProductRegistryHelper::addToRegistry().

{
  if(classToLoadable_.end() == classToLoadable_.find(iName) ) {
    const SharedLibrary* lib = PluginManager::get()->tryToLoad(category(),
                                                          iName);
    if( 0 == lib) {
      return false;
    }
    //read the items from the 'capabilities' symbol
    if(not tryToFind(*lib) ) {
      throw cms::Exception("PluginNotFound")<<"The dictionary for class '"<<iName <<"' is supposed to be in file\n '"
      <<lib->path().string()<<"'\n but no dictionaries are in that file.\n"
      "It appears like the cache is wrong.  Please do 'EdmPluginRefresh "<<lib->path().string()<<"'.";
    }
    
    if(classToLoadable_.end() == classToLoadable_.find(iName)) {
      throw cms::Exception("PluginNotFound")<<"The dictionary for class '"<<iName<<"' is supposed to be in file\n '"
      <<lib->path().string()<<"'\n but was not found.\n"
      "It appears like the cache is wrong.  Please do 'EdmPluginRefresh "<<lib->path().string()<<"'.";
    }
  }
  return true;
}

Friends And Related Function Documentation

friend class DummyFriend

friend

Definition at line 34 of file PluginCapabilities.h.

Member Data Documentation

std::map<std::string, boost::filesystem::path> edmplugin::PluginCapabilities::classToLoadable_

private

Definition at line 61 of file PluginCapabilities.h.

Referenced by available(), load(), tryToFind(), and tryToLoad().