锁定实施
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 的示例。