/// <summary>
///  Интерфейс контекста операции с базой данных.
/// </summary>
//! Класс не предназначен для динамических объектов
class t_db_operation_context
{
 public:
  /// <summary>
  ///  Получение указателя на низкоуровневую транзакцию операции
  /// </summary>
  //! \return
  //!  Может быть NULL
  virtual t_db_transaction* get_transaction()=0;
  
  /// <summary>
  ///  Получение сервисного объекта
  /// </summary>
  //! \param[in] rguidService
  //! \return
  //!  NULL, если сервис с таким идентификатором не доступен
  virtual t_db_object_ptr get_service(REFGUID rguidService)=0;
};//class t_db_operation_context

/// <summary>
///  Контекст операции с базой данных
/// </summary>
class t_ibp_operation_context:public db_obj::t_db_operation_context
{
 private:
  typedef t_ibp_operation_context              self_type;
  
  t_ibp_operation_context(const self_type&);
  self_type& operator = (const self_type&);
 
 public:
  t_ibp_operation_context(){;}
  
  //interface ------------------------------------------------------------
  
  /// <summary>
  ///  Получение ibp-транзакции в рамках которой выполняется операция
  /// </summary>
  //! \return
  //!  Can be NULL
  virtual t_ibp_transaction* ibp_transaction()=0;
  
  /// <summary>
  ///  Получение ibp-команды для которой выполняется операция
  /// </summary>
  //! \return
  //!  Can be NULL
  virtual t_ibp_command* ibp_command()=0;
};//class t_ibp_operation_context

/// <summary>
///  Реализация IBP-контекста для операций с базой данных
/// </summary>
//! 
//! \attention
//!  Методы интерфейса t_db_operation могут вызываться асинхронно.
class t_ibp_operation_context_std
 :public t_ibp_operation_context,
  public IBP_DEF_DB_INTERFACE_IMPL_STATIC(db_obj::t_db_operation)
{
 private:
  typedef t_ibp_operation_context_std       self_type;
  
  t_ibp_operation_context_std(const self_type&);
  self_type& operator = (const self_type&);
 
 public: //typedefs ------------------------------------------------------
  /// <summary>
  ///  Сигнальный тип, используемый для конструирования контекста для
  ///  операции получения метаданных
  /// </summary>
  struct for_meta_op{};
  
  class tag_attach_to_command;

 public:
  /// <summary>
  ///  Конструктор инициализации
  /// </summary>
  //! \param[in] transaction
  //! \param[in] command
  t_ibp_operation_context_std(t_ibp_transaction*  transaction,
                              t_ibp_command*      command);
  
  /// <summary>
  ///  Конструктор инициализации
  /// </summary>
  //! \param[in] transaction
  //! \param[in] command
  //! \param[in] pSession
  //!  Not NULL. Используется для создания временной транзакции
  //! \param[in] op_flags
  t_ibp_operation_context_std(t_ibp_transaction*  transaction,
                              t_ibp_command*      command,
                              TIBPSession*        pSession,
                              TIBP_OperationFlags op_flags);
  
  /// <summary>
  ///  Конструктор инициализации контекста для получения метаданных
  /// </summary>
  //! \param[in] tag
  //! \param[in] transaction
  //! \param[in] pSession
  t_ibp_operation_context_std(for_meta_op         tag,
                              t_ibp_transaction*  transaction,
                              TIBPSession*        pSession);
  /// <summary>
  ///  Деструктор
  /// </summary>
 ~t_ibp_operation_context_std();
  
  //interface ------------------------------------------------------------
  
  /// <summary>
  ///  Завершение работы. Выполняем коммит автоматической транзакции.
  /// </summary>
  void complete();

  /// <summary>
  ///  Установка новой команды
  /// </summary>
  //! \param[in] command
  //!  Can be NULL
  //!
  //! \attention
  //!  Если command!=NULL, то контекст не должен быть привязан к другой команде.
  void set_ibp_command(t_ibp_command* command);

  //t_db_operation interface ---------------------------------------------

  /// <summary>
  ///  Отмена операции. Вызывается асинхронно.
  /// </summary>
  virtual void cancel();//abstract

  //t_db_operation_context interface -------------------------------------
  
  /// <summary>
  ///  Получение указателя на низкоуровневую транзакцию операции
  /// </summary>
  //! \return
  //!  Может быть NULL
  virtual t_db_transaction* get_transaction();//abstract
  
  /// <summary>
  ///  Запрос сервисного объекта
  /// </summary>
  //! \param[in] rguidService
  //!  Идентификатор сервиса
  //! \return
  //!  NULL, если сервис с запрошенным идентификатором не доступен.
  virtual t_db_object_ptr get_service(REFGUID rguidService);//abstract

  //t_ibp_operation_context interface ------------------------------------
  
  /// <summary>
  ///  Получение ibp-транзакции в рамках которой выполняется операция
  /// </summary>
  //! \return
  //!  Can be NULL
  virtual t_ibp_transaction* ibp_transaction();
  
  /// <summary>
  ///  Получение ibp-команды для которой выполняется операция
  /// </summary>
  //! \return
  //!  Can be NULL
  virtual t_ibp_command* ibp_command();

 private: //typedefs -----------------------------------------------------
  typedef t_db_service_descr                                   svc_descr_type;
  typedef t_db_service_descr::tag_less                         svc_descr_less_type;
  
  typedef t_db_memory_allocator                                allocator_type;
  
  typedef t_tree_avl<svc_descr_type,
                     svc_descr_less_type,
                     allocator_type>                           services_type;
  
 private:
  typedef structure::t_multi_thread_traits                     thread_traits;
  typedef thread_traits::guard_type                            guard_type;
  typedef thread_traits::lock_guard_type                       lock_guard_type;

 private:
  //! \brief Указатель на связанную ibp-транзакцию
  t_ibp_transaction_ptr const m_transaction;
  
  //! \brief Указатель на связанную ibp-команду
  t_ibp_command_ptr          m_command;
 
  TIBPSessionCPtr      const m_cspSession;
  
  TIBP_OperationFlags  const m_op_flags;

 private:
  //! \brief Кэш сервисов.
  services_type m_services;

 private:
  //! \brief Блокировщик временной транзакции
  t_ibp_auto_transaction_locker m_TmpTrans;

 private:
  //! \brief Защита указателя на текущую операцию
  guard_type m_cur_op_guard;

  //! \brief Сигнал отмены операции
  thread_traits::int_type m_cancel_flag;

  //! \brief Текущая операция
  //! \todo  Заменить на t_db_operation_ptr
  t_ibp_command_ptr m_cur_op;
};//class t_ibp_operation_context_std

/// <summary>
///  Base class for smart interface.
/// </summary>
template<class tag_thread_traits>
class COMP_CONF_DECLSPEC_NOVTABLE t_basic_smart_interface
{
 public: //typedefs ------------------------------------------------------
  typedef tag_thread_traits                           thread_traits;
  typedef typename thread_traits::int_type            cnt_ref_type;

 public:
  virtual cnt_ref_type add_ref()=0;
  virtual cnt_ref_type release()=0;
};//class t_basic_smart_interface