EDProductGetter.h

Go to the documentation of this file.

#ifndef DataFormats_Common_EDProductGetter_h
#define DataFormats_Common_EDProductGetter_h
// -*- C++ -*-
//
// Class  :     EDProductGetter
//
//
// Original Author:  Chris Jones
//         Created:  Tue Nov  1 15:06:31 EST 2005
//

// user include files

// system include files
#include <string>
#include <vector>

// forward declarations

namespace edm {

  class ProductID;
  class WrapperBase;

  class EDProductGetter {
  public:
    EDProductGetter();
    virtual ~EDProductGetter();

    EDProductGetter(EDProductGetter const&) = delete;  // stop default

    EDProductGetter const& operator=(EDProductGetter const&) = delete;  // stop default

    // ---------- const member functions ---------------------
    virtual WrapperBase const* getIt(ProductID const&) const = 0;

    // getThinnedProduct assumes getIt was already called and failed to find
    // the product. The input key is the index of the desired element in the
    // container identified by ProductID (which cannot be found).
    // If the return value is not null, then the desired element was found
    // in a thinned container and key is modified to be the index into
    // that thinned container. If the desired element is not found, then
    // nullptr is returned.
    virtual WrapperBase const* getThinnedProduct(ProductID const&, unsigned int& key) const = 0;

    // getThinnedProducts assumes getIt was already called and failed to find
    // the product. The input keys are the indexes into the container identified
    // by ProductID (which cannot be found). On input the WrapperBase pointers
    // must all be set to nullptr (except when the function calls itself
    // recursively where non-null pointers mark already found elements).
    // Thinned containers derived from the product are searched to see
    // if they contain the desired elements. For each that is
    // found, the corresponding WrapperBase pointer is set and the key
    // is modified to be the key into the container where the element
    // was found. The WrapperBase pointers might or might not all point
    // to the same thinned container.
    virtual void getThinnedProducts(ProductID const& pid,
                                    std::vector<WrapperBase const*>& foundContainers,
                                    std::vector<unsigned int>& keys) const = 0;

    unsigned int transitionIndex() const { return transitionIndex_(); }

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

    static EDProductGetter const* switchProductGetter(EDProductGetter const*);
    static void assignEDProductGetter(EDProductGetter const*&);

  private:
    virtual unsigned int transitionIndex_() const = 0;

    // ---------- member data --------------------------------
  };

  EDProductGetter const* mustBeNonZero(EDProductGetter const* prodGetter,
                                       std::string refType,
                                       ProductID const& productID);
}  // namespace edm
#endif