IRDBAccessSvc.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/

 
#ifndef RDBACCESSSVC_IRDBACCESSSVC_H
#define RDBACCESSSVC_IRDBACCESSSVC_H
 
#include "GaudiKernel/IInterface.h"
 
 
#include "CoralBase/AttributeList.h"
#include "CoralBase/Attribute.h"
 
#include <string>
#include <string_view>
#include <memory>
 
class IRDBRecordset;
class IRDBQuery;
 
typedef std::shared_ptr<IRDBRecordset> IRDBRecordset_ptr;
 
typedef coral::AttributeList RDBTagDetails;

 
class IRDBAccessSvc : virtual public IInterface 
{
  // Special friends who need to call connect()/disconnect() methods
  friend class GeoModelSvc;
  friend class SourceCompAlg;
  friend class TrigRDBManager;
 
 public:

  DeclareInterfaceID(IRDBAccessSvc, 1 , 0);

  virtual IRDBRecordset_ptr getRecordsetPtr(std::string_view node,
                        std::string_view tag,
                        std::string_view tag2node="",
                        std::string_view connName = "ATLASDD") = 0;

  virtual std::string getChildTag(const std::string& childNode,
                  const std::string& parentTag,
                  const std::string& parentNode,
                  const std::string& connName = "ATLASDD") = 0;
 
 
  // 
  // ------------------------ WARNING! ----------------------------
  // --- Following method should be used for special cases only ---
  // --------------------------------------------------------------
  //
  // 1. After calling this function call IRDBQuery::execute() in order
  //    to fetch data from database
  // 2. Navigate the cursor, get the data and store it into custom
  //    structures. 
  //        * The Cursor is NOT BIDIRECTIONAL
  //
 
  virtual std::unique_ptr<IRDBQuery> getQuery(const std::string& node,
                          const std::string& tag,
                          const std::string& tag2node="",
                          const std::string& connName = "ATLASDD") = 0;

  virtual void getTagDetails(RDBTagDetails& tagDetails,
                             const std::string& tag,
                             const std::string& connName = "ATLASDD") = 0;
 
 protected:
  virtual bool connect(std::string_view connName = "ATLASDD") = 0;

  virtual bool disconnect(std::string_view connName = "ATLASDD") = 0;

  virtual bool shutdown(std::string_view connName = "ATLASDD") = 0;
 
};
 
#endif