锁定实施

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 并发控制 › 悲观并发控制(锁定) › 锁定实施

如果在行为定义中为业务对象定义了锁定机制,则必须确保为修改操作设置锁定。

管理的场景

缺省情况下,为实施类型为 managed 的业务对象启用锁定机制。行为定义的模板随附至少一个锁主实体的定义,锁机制的实施由托管的业务对象框架提供。

如果为被管理业务对象定义非托管锁,则必须实施 method FOR LOCK,就像在非托管场景中一样。然后在运行时调用。

备注

在具有客户端相关数据库表,但将其他数据库表中的客户端无关字段连接到 CDS 视图的场景中,托管业务对象运行时会锁定特定于客户端的实例。这意味着仅锁定客户端相关数据库表中的字段。如果还要锁定与客户端无关的字段,则必须实施 unmanaged lock。

非托管场景

就像非托管场景中的任何其他操作一样,锁必须由应用程序开发人员实施。要启用锁定,必须实现 method FOR LOCK。

有关完整示例,请参阅实施 LOCK 操作。

<method> FOR LOCK

根据行为定义中指定的锁定属性实施实体锁定。

在调用更改 (MODIFY) 操作(例如 FOR LOCK)之前,协调框架会自动调用 update 方法。

<method> FOR LOCK

在行为定义中,您可以通过将哪些实体定义为 lock master 来确定支持直接锁定的实体。

备注

业务对象的根节点当前仅支持 lock master 的定义。

此外,您可以将实体定义为 lock dependent。此状态可以分配给实体,具体取决于父实体或根实体的锁定状态。lock dependent 的规范包含关联,通过该关联,运行时会自动确定在发生相关实体的变更请求时执行 method FOR LOCK 的相应 lock master。

行为定义中预定义 LOCK 方法的声明如下:

METHODS lock_method FOR LOCK
  [IMPORTING] lock_import_parameter FOR LOCK entity.

关键字 IMPORTING 可以在导入参数之前指定。可自由选择导入参数 lock_import_parameter 的名称。

占位符 entity 指的是实体的名称(例如 CDS 视图)或行为定义中定义的别名。

导入参数

导入表的行类型提供以下数据:

  • 标识字段

    在相关 CDS 视图中指定为键值的所有元素。

备注

编译器生成的结构 %CID 、 %CID_REF 和 %PID 在锁定上下文中不相关,因为锁定仅影响持久(非临时)实例。

更改参数

LOCK 方法还提供隐式 CHANGING 参数 failed 和 reported。

  • failed 参数用于记录锁失败时的原因。

  • reported 参数用于存储有关失败原因的消息。

可以选择在 LOCK 方法中显式声明这些参数,如下所示:

METHODS lock_method FOR LOCK
  IMPORTING lock_import_parameter FOR LOCK entity
  CHANGING failed   TYPE DATA
           reported TYPE DATA.

实施 method FOR LOCK

RAP 锁定机制需要锁对象的实例化。锁对象是 ABAP 字典对象,可用于入队和取消排队锁定请求。

锁对象的 enqueue 方法在全局锁表中写入条目并锁定所需的实体实例。

实施 LOCK 操作中提供了有关如何实施 method FOR LOCK 的示例。