【开源库学习】libodb库学习（十）

🕗 发布于 2024-07-23 11:27 开源学习 ODB 数据库

11 会话

会话是应用程序的工作单元，可能包含多个数据库事务。在这个版本的ODB中，会话只是一个对象缓存。在未来的版本中，它可能会提供额外的功能，例如延迟数据库操作和自动对象状态更改跟踪。如第11.2节“自定义会话”稍后所述，也可以提供提供这些或其他功能的自定义会话实现。
会话支持是可选的，可以使用db Session pragma根据每个对象启用或禁用，例如：

#pragma db object session
class person
{
  ...
};

我们还可以在命名空间级别启用或禁用一组对象的会话支持：

#pragma db namespace session
namespace accounting
{
  #pragma db object                // Session support is enabled.
  class employee
  {
    ...
  };

  #pragma db object session(false) // Session support is disabled.
  class employer
  {
    ...
  };
}

最后，我们可以传递--generate session ODB编译器选项，以默认启用会话支持。使用此选项，将为所有持久类启用会话支持，但使用db session显式禁用的类除外。具有相同效果的此方法的另一种方法是启用全局命名空间的会话支持：

#pragma db namespace() session

应用程序中的每个执行线程一次只能有一个活动会话。会话是通过创建odb::session 类的实例来启动的，当该实例被销毁时，会话会自动终止。您需要包含<odb/session.hxx>头文件，以便在您的应用程序中使用此类。例如：

#include <odb/database.hxx>
#include <odb/session.hxx>
#include <odb/transaction.hxx>

using namespace odb::core;

{
  session s;

  // First transaction.
  //
  {
    transaction t (db.begin ());
    ...
    t.commit ();
  }

  // Second transaction.
  //
  {
    transaction t (db.begin ());
    ...
    t.commit ();
  }

  // Session 's' is terminated here.
}

session 类具有以下接口：

namespace odb
{
  class session
  {
  public:
    session (bool make_current = true);
    ~session ();

    // Copying or assignment of sessions is not supported.
    //
  private:
    session (const session&);
    session& operator= (const session&);

    // Current session interface.
    //
  public:
    static session&
    current ();

    static bool
    has_current ();

    static void
    current (session&);

    static void
    reset_current ();

    static session*
    current_pointer ();

    static void
    current_pointer (session*);

    // Object cache interface.
    //
  public:
    template <typename T>
    struct cache_position {...};

    template <typename T>
    cache_position<T>
    cache_insert (database&,
                  const object_traits<T>::id_type&,
                  const object_traits<T>::pointer_type&);

    template <typename T>
    object_traits<T>::pointer_type
    cache_find (database&, const object_traits<T>::id_type&) const;

    template <typename T>
    void
    cache_erase (const cache_position<T>&);

    template <typename T>
    void
    cache_erase (database&, const object_traits<T>::id_type&);
  };
}

会话构造函数创建一个新会话，如果make_current参数为true，则将其设置为该线程的当前会话。如果我们试图让一个会话成为当前会话，而这个线程已经有另一个会话生效，那么构造函数会抛出odb::already_in_session 异常。如果此会话是当前会话，析构函数将清除此线程的当前会话。
静态 current() 访问器返回此线程的当前活动会话。如果没有活动会话，此函数将抛出odb::not_in_session异常。我们可以使用 has_current()静态函数检查此线程中是否有有效的会话。
static current()修饰符允许我们为此线程设置当前会话。reset_current() 静态函数清除当前会话。这两个函数允许更高级的用例，例如在同一线程上复用两个或多个会话。
静态current_pointer()重载函数提供了相同的功能，但使用了指针。具体来说，current_pointer()访问器可用于测试是否存在当前会话，并通过一次调用获得指向所有会话的指针。
我们通常不直接使用对象缓存接口。然而，在某些情况下，它可能很有用，例如，找出对象是否已经加载。请注意，在调用cache_insert()、cache_find()或cache_erase()的第二个版本时，您需要显式指定模板参数（对象类型）。也可以直接访问底层缓存数据结构。例如，如果您想迭代缓存中存储的对象，这可能很有用。有关此直接访问的更多详细信息，请参阅ODB运行时头文件。

11.1 对象缓存

会话是一个对象缓存。每次通过调用 database::persist()函数（第3.8节，“使对象持久化”）使启用会话的对象持久化，通过调用database::load()或database::load()函数加载（第3.9节，“加载持久对象”），或通过迭代查询结果加载（第4.4节，“查询结果”），指向持久对象的指针（以规范对象指针的形式）（第3.3节，“对象和视图指针”）都会存储在会话中。只要会话有效，任何后续加载同一对象的调用都将返回缓存的实例。当使用 database::erase() 函数从数据库中删除对象的状态时（第3.11节，“删除持久对象”），缓存的对象指针将从会话中删除。例如：

shared_ptr<person> p (new person ("John", "Doe"));

session s;
transaction t (db.begin ());

unsigned long id (db.persist (p));            // p is cached in s.
shared_ptr<person> p1 (db.load<person> (id)); // p1 same as p.

t.commit ();

每个对象的缓存策略取决于对象指针的类型（第6.5节，“使用自定义智能指针”）。具有唯一指针（如std::auto_ptr或std::unique_ptr）作为对象指针的对象永远不会被缓存，因为不可能有两个这样的指针指向同一个对象。当一个对象通过指针持久化或作为动态分配的实例加载时，具有原始指针和共享指针作为对象指针的对象会被缓存。如果一个对象被持久化为引用或加载到预分配的实例中，则只有当其对象指针是原始指针时，该对象才会被缓存。
还要注意，当我们将一个对象持久化为常量引用或常量指针时，会话会将这样的对象缓存为unrestricted（非const）。如果被持久化的对象实际上是作为const创建的，并且后来在会话缓存中被发现并用作非const，这可能会导致未定义的行为。因此，在使用会话时，建议将所有持久对象创建为非const实例。以下代码片段说明了这一点：

void save (database& db, shared_ptr<const person> p)
{
  transaction t (db.begin ());
  db.persist (p); // Persisted as const pointer.
  t.commit ();
}

session s;

shared_ptr<const person> p1 (new const person ("John", "Doe"));
unsigned long id1 (save (db, p1)); // p1 is cached in s as non-const.

{
  transaction t (db.begin ());
  shared_ptr<person> p (db.load<person> (id1)); // p == p1
  p->age (30); // Undefined behavior since p1 was created const.
  t.commit ();
}

shared_ptr<const person> p2 (new person ("Jane", "Doe"));
unsigned long id2 (save (db, p2)); // p2 is cached in s as non-const.

{
  transaction t (db.begin ());
  shared_ptr<person> p (db.load<person> (id2)); // p == p2
  p->age (30); // Ok, since p2 was not created const.
  t.commit ();
}

11.2 自定义会话

ODB可以使用自定义会话实现，而不是默认的odb::session。应用程序提供自己的会话可能有多种原因。例如，应用程序可能已经包含对象缓存或注册表的概念，ODB可以重复使用。自定义会话还可以提供其他功能，例如自动更改跟踪、延迟数据库操作或对象驱逐。最后，odb::session使用的每线程会话方法可能并不适用于所有应用程序。例如，有些可能需要一个可以在多个线程之间共享的线程安全会话。有关通过保留对象的原始副本来实现自动更改跟踪的自定义会话的示例，请参阅odb-tests中的common/session/custom测试。
要使用自定义会话，我们需要使用--session-type ODB编译器命令行选项指定其类型。我们还需要将其定义包含在生成的头文件中。这可以通过--hxx-prologue选项来实现。例如，如果我们的自定义会话名为app::session，并且在app/session.hxx头文件中定义，那么相应的ODB编译器选项如下：

odb --hxx-prologue "#include \"app/session.hxx\"" \
--session-type ::app::session ...

自定义会话应提供以下接口：

class custom_session
{
public:
  template <typename T>
  struct cache_position
  {
    ...
  };

  // Cache management functions.
  //
  template <typename T>
  static cache_position<T>
  _cache_insert (odb::database&,
                 const typename odb::object_traits<T>::id_type&,
                 const typename odb::object_traits<T>::pointer_type&);

  template <typename T>
  static typename odb::object_traits<T>::pointer_type
  _cache_find (odb::database&,
               const typename odb::object_traits<T>::id_type&);

  template <typename T>
  static void
  _cache_erase (const cache_position<T>&);

  // Notification functions.
  //
  template <typename T>
  static void
  _cache_persist (const cache_position<T>&);

  template <typename T>
  static void
  _cache_load (const cache_position<T>&);

  template <typename T>
  static void
  _cache_update (odb::database&, const T& obj);

  template <typename T>
  static void
  _cache_erase (odb::database&,
                const typename odb::object_traits<T>::id_type&);
};

cache_position类模板表示插入对象在缓存中的位置。它应该是默认的、可复制的、可分配的。默认构造函数应创建一个特殊的空/NULL位置。调用任何具有空/NULL位置的缓存管理或通知函数都将被忽略。
_cache_insert()函数应将对象添加到对象缓存中并返回其位置。_cache_find()函数在给定id的对象缓存中查找对象。如果找不到对象，则返回NULL指针。_cache_erase()缓存管理函数应将对象从缓存中删除。如果导致插入对象的数据库操作（例如加载）失败，则会调用它。另请注意，插入后，对象状态为未定义。您只能从下面讨论的通知函数之一访问对象状态（例如，复制或清除标记）。
通知函数分别在对象被持久化、加载、更新或擦除后调用。如果您的会话实现不需要某些通知，您仍然需要提供它们的功能，但是，您可以将它们的实现留空。
还要注意，所有缓存管理和通知功能都是静态的。这样做是为了允许对当前会话进行自定义。通常，非空实现执行的第一步是查找当前会话。

原文地址：https://blog.csdn.net/weixin_45125631/article/details/140600706

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：【linux】vim
下一篇：Linux基于CentOS7【yum】【vim】的基础学习,【普通用户提权】

Nuxt.js 应用中的 schema：beforeWrite 事件钩子详解
钩子为开发者提供了一个灵活的接口，以便在写入 JSON Schema 之前进行必要的修改和验证。这使得开发者可以在构建过程中插入自定义逻辑，有助于提高应用的稳定性和准确性。钩子允许开发者在 JSON
阅读更多2024-11-17
Python习题 249：判断两个单词为相同字母异序词
（编码题）编写一个函数，判断两个单词（字符串）中有相同的单词（字符），即相同字母异序词。
阅读更多2024-11-17
第四章：ArkTS 语句全解：从基础到高级的控制流与异常处理
本文详细介绍了 ArkTS 中的多种语句，这些语句对于构建程序逻辑、控制执行流程和处理异常至关重要。
阅读更多2024-11-17
Vue.js中computed的使用方法
在Vue.js中，computed 属性是基于它们的依赖进行缓存的响应式属性。这意味着只要computed属性依赖的源数据（如data中的属性）没有发生变化，多次访问computed属性会立即返回之前
阅读更多2024-11-17
【团标】《软件造价评估实施规程》（T-BSCEA002—2023）-标准解读系列14
而对于软件造价业务开展过程中，基准数据以及相关调整因子的选取判定、评估工作开展具体步骤环节、造价输出成果要求（如造价清单、造价报告）等，《软件造价评估实施规程》（T-BSCEA002—2023）则提供
阅读更多2024-11-17
效益登记册&效益管理计划
-全生命周期会update。集商业论证、组织战略计划和其他相关项目集自标。定义管理效益所需的角色和职责;
阅读更多2024-11-17
我手搓了个“自动生成标书”的开源大模型工具
最近我写开源商业文章明显更新少了，不是我不写文章了，而是开源商业化进展很顺利，我写文章的时间都被各种写标书占满了。作为一个开源原生的商业公司，白鲸开源公司的员工几乎都是程序员，而让这些开源贡献者写标书
阅读更多2024-11-17
奥迪股份如何通过升级至SAP S/4HANA实现财务与后勤的高效整合？
为了避免成本高昂的临时解决方案，奥迪公司希望将所有工厂后勤（后勤和生产的一部分）同时迁移到SAP S/4HANA，并集成到生产模板“Progress”中。随着多个项目的筹备，奥迪股份公司在 2023
阅读更多2024-11-17
linux逻辑卷练习
从新硬盘制作三个分区每个分区都 3GB大小，将三个分区只作为物理卷，通过这三个物理卷创建卷组通过卷组生成一个逻辑卷，大小为7G，再将逻辑卷调整到10G。物理卷（physical volume）：简
阅读更多2024-11-17
Vagrant 没了 VirtualBox 的话可以配 Qemu
之前一直是用 Vagrant 搭配 VirtualBox 在 Mac 下使用 Linux 虚拟机，因为不需要用到 Linux 桌面，用 Vagrant 操作虚拟机非常方便。有些尚未听说过，还有一些虽说
阅读更多2024-11-17

【开源库学习】libodb库学习（十）

11 会话

11.1 对象缓存

11.2 自定义会话

相关文章