将行为添加到业务对象

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 开发非托管事务应用 › 定义并实施业务对象行为 › 将行为添加到业务对象

创建行为定义 /DMO/I_TRAVEL_U

使用 ADT 中的创建向导创建行为定义。使用根视图实体(/DMO/I_Travel_M))上的上下文菜单时,可以直接为完整的业务对象层次结构创建新的行为定义。在向导中,选择实施类型 非托管 。

记住

通过创建行为定义,引用的根实体及其构成(子实体)将获得事务字符。因此,行为定义是在当前编程模型的上下文中实施业务对象概念。必须在同一行为定义中指定具体业务对象的所有支持的事务操作。

定义差旅业务对象的交易行为

它包含一个抬头信息和两个实体行为定义:一个用于根实体,一个用于子实体 - 对应于业务对象的组合树。请注意,对于构成树的每个实体,最多可以在行为定义中定义一次事务行为。必须在同一行为定义中指定具体业务对象节点的所有支持的事务操作(由关键字 DEFINE BEHAVIOR FOR ... 引入)。

有关行为定义抬头的详细语法描述,请参阅 CDS BDL - CDS 行为定义抬头(ABAP 关键字文档)。

有关实体行为定义的详细语法描述,请参阅 CDS BDL - 实体行为定义(ABAP 关键字文档)。

根据预期,由于我们将在新应用中集成历史业务逻辑,因此抬头指定业务对象合同提供者的非托管实施类型。对于此实施类型,作为应用程序开发人员,您必须实施业务对象本身的基本组件。在这种情况下,必须在相应的行为定义中指定所有所需操作(create、update、delete 或任何应用程序特定操作),并在 ABAP 中手动实施这些操作。

我们的差旅业务对象参考基础 CDS 数据模型,由根实体 /DMO/I_Travel_U 表示。根实体的行为只能在指定的行为池 /DMO/BP_TRAVEL_U 中实施。

静态字段控制在行为定义中定义。在我们的场景中,由用于创建差旅实例的功能模块提取关键字段 TravelID 的值。因此,字段不得由最终用户在 UI 上编辑。同样,将字段 TotalPrice 设置为只读。总价格不是通过功能模块中相关预订的价格和预订费计算的。在此场景中,总价可由最终用户编辑。

必填字段为 AgencyID、CustomerID、BeginDate 和 EndDate。这些字段包含差旅实例的必填信息。有关字段控制的详细信息,请参阅实例功能控制。

业务对象根节点的事务处理由标准操作 create 、 update 和 delete 以及实例相关操作 set_status_booked 确定。使用此操作,最终用户可以将所选差旅实例的状态设置为已预订。示例中的操作会影响具有相同实体类型的输出实例,并且一个输入实例仅与一个输出实例相关。因此,使用预定义类型 $self 和基数 [1] 定义输出参数。在我们的场景中,添加 _Booking 关联时,只能为特定差旅实例创建预订子节点的新实例。关键字 {create;} 声明此关联已启用创建,确切意味着相关预订的实例可以由差旅实例创建。

为通过关联工序创建定义动态工序控制。这意味着,仅当相应差旅实例未设置为预订或取消时才能创建新预订。有关字段控制的详细信息,请参阅功能控制。

数据库表字段的名称与 CDS 数据模型名称的名称不同。因此,我们为 CDS 数据模型中的每个字段指定映射合同。要相应地映射控制结构,请为数据库表定义控制结构 /dmo/s_booking_intx。有关详细信息,请参阅使用类型和控制映射。

etag master 字段确保多个用户对数据的事务访问,同时避免已修改数据的不一致和意外更改。每个 MODIFY 都使用 etag 字段(在本例中为时戳)进行记录,以确保数据一致性。建议使用字段特征 readonly 在行为定义中将相应 ETag 字段指定为只读。有关更多信息,请参阅乐观并发控制。

lock master 可防止多个用户并行修改数据库中的数据并确保数据一致性。有关详细信息,请参阅悲观并发控制(锁定)。

authorization master 定义如何以及何时可以访问 RAP 业务对象。严格模式要求为业务对象定义权限。使用附加项 none,不执行任何权限检查。这是演示应用程序,因此不使用附加项。在实际场景中不建议使用此方法,这会违反最佳实践。有关详细信息,请参阅权限控制。

late numbering 定义仅在将实例保存到数据库之前分配主 ID 值。对于延迟编号,必须实施方法 ADJUST NUMBERS。有关详细信息,请参阅非管理的内部延迟编号。

TRAVEL 业务对象的子节点是指由 /DMO/I_Booking_U 的子实体表示的预订的相应数据模型。只能在指定的行为池 /DMO/BP_BOOKING_U 中实施子实体的行为。差旅业务对象的预订子节点的事务处理由标准操作 update 和 delete 确定。预订实例的创建由 create by association 处理,这意味着预订只能创建为其差旅父项的子节点。

展开以下代码示例以查看行为定义的源代码 /DMO/I_Travel_U。

示例代码

unmanaged implementation in class /DMO/BP_TRAVEL_U unique;
strict(2);

// behavior defintion for the TRAVEL root entity
define behavior for /DMO/I_Travel_U alias Travel
implementation in class /DMO/BP_TRAVEL_U unique
etag master LastChangedAt
lock master
authorization master ( none )
late numbering

{
  field ( readonly ) TravelID, LastChangedAt;
  field ( mandatory ) AgencyID, CustomerID, BeginDate, EndDate;

  create;
  update;
  delete;

  action ( features : instance ) set_status_booked result [1] $self;

  association _Booking { create (features: instance); }

  mapping for /dmo/travel control /dmo/s_travel_intx
  {
    AgencyID      = agency_id;
    BeginDate     = begin_date;
    BookingFee    = booking_fee;
    CurrencyCode  = currency_code;
    CustomerID    = customer_id;
    EndDate       = end_date;
    LastChangedAt = lastchangedat;
    Memo          = description;
    Status        = status;
    TotalPrice    = total_price;
    TravelID      = travel_id;
  }
}

// behavior definition for the BOOKING child entity
define behavior for /DMO/I_Booking_U alias Booking
implementation in class /DMO/BP_BOOKING_U unique
etag dependent by _Travel
lock dependent by _Travel
authorization dependent by _Travel
late numbering

{
  field ( readonly ) TravelID, BookingID;
  field ( mandatory ) BookingDate, CustomerID, AirlineID, ConnectionID, FlightDate;

  update;
  delete;

  association _BookSupplement { create; }
  association _Travel;

  mapping for /dmo/booking control /dmo/s_booking_intx
  {
    AirlineID    = carrier_id;
    BookingDate  = booking_date;
    BookingID    = booking_id;
    ConnectionID = connection_id;
    CurrencyCode = currency_code;
    CustomerID   = customer_id;
    FlightDate   = flight_date;
    FlightPrice  = flight_price;
    TravelID     = travel_id;
  }

}