ServiceRegistry/interface/ServiceRegistry.h

0001 #ifndef ServiceRegistry_ServiceRegistry_h
0002 #define ServiceRegistry_ServiceRegistry_h
0003 // -*- C++ -*-
0004 //
0005 // Package:     ServiceRegistry
0006 // Class  :     ServiceRegistry
0007 //
0008 /**\class ServiceRegistry ServiceRegistry.h FWCore/ServiceRegistry/interface/ServiceRegistry.h
0009
0010  Description: Manages the 'thread specific' instance of Services
0011
0012  Usage:
0013     <usage>
0014
0015 */
0016 //
0017 // Original Author:  Chris Jones
0018 //         Created:  Mon Sep  5 13:33:00 EDT 2005
0019 //
0020
0021 // user include files
0022 #include "FWCore/ParameterSet/interface/ParameterSet.h"
0023 #include "FWCore/ServiceRegistry/interface/ServiceLegacy.h"
0024 #include "FWCore/ServiceRegistry/interface/ServiceToken.h"
0025 #include "FWCore/ServiceRegistry/interface/ServicesManager.h"
0026 #include "FWCore/Utilities/interface/TypeDemangler.h"
0027
0028 // system include files
0029 #include <vector>
0030
0031 // forward declarations
0032 namespace edm {
0033   class FwkImpl;
0034   namespace serviceregistry {
0035     template <typename T>
0036     class ServiceWrapper;
0037   }
0038
0039   class ServiceRegistry {
0040   public:
0041     class Operate {
0042     public:
0043       Operate(ServiceToken const& iToken) : oldToken_(ServiceRegistry::instance().setContext(iToken)) {}
0044       Operate(Operate const&) = delete;                   //stop default
0045       Operate const& operator=(Operate const&) = delete;  //stop default
0046       ~Operate() { ServiceRegistry::instance().unsetContext(oldToken_); }
0047
0048       //override operator new to stop use on heap?
0049     private:
0050       ServiceToken oldToken_;
0051     };
0052
0053     friend class edm::FwkImpl;
0054     friend int main(int argc, char* argv[]);
0055     friend class Operate;
0056
0057     ServiceRegistry(ServiceRegistry const&) = delete;                   // stop default
0058     ServiceRegistry const& operator=(ServiceRegistry const&) = delete;  // stop default
0059     virtual ~ServiceRegistry();
0060
0061     // ---------- const member functions ---------------------
0062     template <typename T>
0063     T& get() const {
0064       if (nullptr == manager_.get()) {
0065         auto demangled = typeDemangle(typeid(T).name());
0066         Exception::throwThis(errors::NotFound,
0067                              "No ServiceRegistry has been set for this thread. Tried to get a Service ",
0068                              demangled.c_str());
0069       }
0070       return manager_->template get<T>();
0071     }
0072
0073     template <typename T>
0074     bool isAvailable() const {
0075       if (nullptr == manager_.get()) {
0076         auto demangled = typeDemangle(typeid(T).name());
0077         Exception::throwThis(errors::NotFound,
0078                              "No ServiceRegistry has been set for this thread. Tried to ask availability of a Service ",
0079                              demangled.c_str());
0080       }
0081       return manager_->template isAvailable<T>();
0082     }
0083     /** The token can be passed to another thread in order to have the
0084          same services available in the other thread.
0085          */
0086     ServiceToken presentToken() const;
0087     // ---------- static member functions --------------------
0088     static ServiceRegistry& instance();
0089
0090     // ---------- member functions ---------------------------
0091
0092     static ServiceToken createServicesFromConfig(std::unique_ptr<ParameterSet> params);
0093
0094   public:  // Made public (temporarily) at the request of Emilio Meschi.
0095     static ServiceToken createSet(std::vector<ParameterSet>&);
0096     static ServiceToken createSet(std::vector<ParameterSet>&, ServiceToken, serviceregistry::ServiceLegacy);
0097     /// create a service token that holds the service defined by iService
0098     template <typename T>
0099     static ServiceToken createContaining(std::unique_ptr<T> iService) {
0100       std::vector<edm::ParameterSet> config;
0101       auto manager = std::make_shared<serviceregistry::ServicesManager>(config);
0102       auto wrapper = std::make_shared<serviceregistry::ServiceWrapper<T> >(std::move(iService));
0103       manager->put(wrapper);
0104       return manager;
0105     }
0106     template <typename T>
0107     static ServiceToken createContaining(std::unique_ptr<T> iService,
0108                                          ServiceToken iToken,
0109                                          bool iOverrideIfServiceInToken) {
0110       std::vector<edm::ParameterSet> config;
0111       auto manager =
0112           std::make_shared<serviceregistry::ServicesManager>(iToken, serviceregistry::kOverlapIsError, config);
0113       auto wrapper = std::make_shared<serviceregistry::ServiceWrapper<T> >(std::move(iService));
0114       manager->put(wrapper, iOverrideIfServiceInToken);
0115       return manager;
0116     }
0117     /// create a service token that holds the service held by iWrapper
0118     template <typename T>
0119     static ServiceToken createContaining(std::shared_ptr<serviceregistry::ServiceWrapper<T> > iWrapper) {
0120       std::vector<edm::ParameterSet> config;
0121       auto manager = std::make_shared<serviceregistry::ServicesManager>(config);
0122       manager->put(iWrapper);
0123       return manager;
0124     }
0125     template <typename T>
0126     static ServiceToken createContaining(std::shared_ptr<serviceregistry::ServiceWrapper<T> > iWrapper,
0127                                          ServiceToken iToken,
0128                                          serviceregistry::ServiceLegacy iLegacy) {
0129       std::vector<edm::ParameterSet> config;
0130       auto manager = std::make_shared<serviceregistry::ServicesManager>(iToken, iLegacy, config);
0131       manager->put(iWrapper);
0132       return manager;
0133     }
0134
0135   private:
0136     //returns old token
0137     ServiceToken setContext(ServiceToken const& iNewToken);
0138     void unsetContext(ServiceToken const& iOldToken);
0139
0140     ServiceRegistry();
0141
0142     // ---------- member data --------------------------------
0143     std::shared_ptr<serviceregistry::ServicesManager> manager_;
0144   };
0145 }  // namespace edm
0146
0147 #endif