FOR LOCK

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › 业务对象提供者 API › 处理器类 › 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 的示例。