BaseHolder.h

Go to the documentation of this file.

#ifndef DataFormats_Common_BaseHolder_h
#define DataFormats_Common_BaseHolder_h

#include "DataFormats/Common/interface/CMS_CLASS_VERSION.h"
#include "DataFormats/Common/interface/EDProductGetter.h"

#include <memory>
#include <string>

namespace edm {
  class ProductID;

  namespace reftobase {
    class RefHolderBase;
    template<typename T> class BaseVectorHolder;
    class RefVectorHolderBase;

    //------------------------------------------------------------------
    // Class template BaseHolder<T>
    //
    // BaseHolder<T> is an abstract base class that manages a single
    // edm::Ref to an element of type T in a collection in the Event;
    // the purpose of this abstraction is to hide the type of the
    // collection from code that can not know about that type.
    //
    //------------------------------------------------------------------
    template <typename T>
    class BaseHolder {
    public:
      BaseHolder();
      virtual ~BaseHolder();
      virtual BaseHolder<T>* clone() const = 0;

      void swap(BaseHolder&);

      // Return the address of the element to which the hidden Ref
      // refers.
      virtual T const* getPtr() const = 0;

      // Return the ProductID of the collection to which the hidden
      // Ref refers.
      virtual ProductID id() const = 0;
      virtual size_t key() const = 0;
      // Check to see if the Ref hidden in 'rhs' is equal to the Ref
      // hidden in 'this'. They can not be equal if they are of
      // different types. Note that the equality test also returns
      // false if dynamic type of 'rhs' is different from the dynamic
      // type of 'this', *even when the hiddens Refs are actually
      // equivalent*.
      virtual bool isEqualTo(BaseHolder<T> const& rhs) const = 0;

      // If the type of Ref I contain matches the type contained in
      // 'fillme', set the Ref in 'fillme' equal to mine and return
      // true. If not, write the name of the type I really contain to
      // msg, and return false.
      virtual bool fillRefIfMyTypeMatches(RefHolderBase& fillme,
                                          std::string& msg) const = 0;
      virtual std::unique_ptr<RefHolderBase> holder() const = 0;

      virtual std::unique_ptr<BaseVectorHolder<T> > makeVectorHolder() const = 0;

      virtual EDProductGetter const* productGetter() const = 0;

      virtual bool isAvailable() const = 0;

      virtual bool isTransient() const = 0;

      //Used by ROOT storage
      CMS_CLASS_VERSION(10)

    protected:
      // We want the following called only by derived classes.
      BaseHolder(BaseHolder const& other);
      BaseHolder& operator=(BaseHolder const& rhs);

    private:
    };

    //------------------------------------------------------------------
    // Implementation of BaseHolder<T>
    //------------------------------------------------------------------

    template <typename T>
    BaseHolder<T>::BaseHolder() {
    }

    template <typename T>
    BaseHolder<T>::BaseHolder(BaseHolder const& /*other*/) {
      // Nothing to do.
    }

    template <typename T>
    BaseHolder<T>&
    BaseHolder<T>::operator=(BaseHolder<T> const& /*other*/) {
      // No data to assign.
      return *this;
    }

    template <typename T>
    BaseHolder<T>::~BaseHolder() {
      // nothing to do.
    }

    template <typename T>
    void
    BaseHolder<T>::swap(BaseHolder<T>& /*other*/) {
      // nothing to do.
    }

    // Free swap function
    template <typename T>
    inline
    void
    swap(BaseHolder<T>& lhs, BaseHolder<T>& rhs) {
      lhs.swap(rhs);
    }
  }
}

#endif