likes
comments
collection
share

关于 SAP UI5 OData V4 模型的 refresh 方法

作者站长头像
站长
· 阅读数 21

SAP UI5 OData V4 模型包括下列三种绑定实例:

  • List Binding
  • Context Binding
  • Property Binding

无论哪种类型的数据绑定实例,其创建的数据服务请求,这些绑定实例都会设计一个缓存,来存储数据服务响应的数据。 如果可以从此缓存中提供数据,这些绑定实例不会再次发送数据服务请求。

应用开发人员可以使用 refresh 方法删除绝对绑定的缓存。 该方法还删除了绝对绑定的子绑定的缓存。

调用刷新方法时,绑定及其子绑定不得有待处理的属性更改,即所谓的 pending property changes.

在删除缓存之前,使用绑定的 hasPendingChanges 方法检查是否存在这种类型的更改。

一个例子:

onRefreshSelectedSalesOrder : function () {
    // within a sap.m.Table bound to a OData V4 list binding get the OData V4 context for the selected entity
    var oSalesOrderContext = this.byId("SalesOrders").getSelectedItem().getBindingContext();
      
    if (!oSalesOrderContext.hasPendingChanges()) {
        oSalesOrderContext.refresh();
    }
},

更新一个 entity 后,它可能不再匹配加载实体的集合的 query 选项,特别是 $filter。 您可以决定刷新列表绑定的上下文是否应忽略查询选项:通过将参数 bAllowRemoval 设置为 true,可以从集合的列表绑定中删除相应的上下文。

需要注意的是,对列表的更改(如不同的排序顺序)需要刷新整个列表。

下面是一个例子。这个应用里的 Table 控件,应用了一个过滤器,以仅显示生命周期状态为 New 的销售订单。确认销售订单时,其状态将更改为 In Process,不再匹配过滤器。 此销售订单随后会被刷新,并将在 bAllowRemoval 标志设置为 true 时,从列表中删除。

上述逻辑的代码如下:

oAction.execute("confirmSalesOrderActionGroup").then(function () {
    oConfirmedSalesOrderContext.refresh(undefined, true); // bAllowRemoval = true
});

在 XML 视图里使用绝对路径绑定,并且指定额外 query option 的例子:

<Table items="{
 path : '/SalesOrderList',
 parameters : {
  $expand : 'SO_2_BP',
  $select : 'BuyerName,CurrencyCode,GrossAmount,Note,SalesOrderID'
 }}">
 ...
 <items>  
  <ColumnListItem>
   <cells> 
    <Text text="{SalesOrderID}"/> 
    <Text text="{SO_2_BP/CompanyName}"/>
    <Text text="{BillingStatus}"/> 
   </cells>
  </ColumnListItem>

 </items>
</Table>

<Table items="{
 path : 'SO_2_SOITEM',
 parameters : {
    $select: "DeliveryDate,GrossAmount,SalesOrderID"
 }
>
...
</Table>

上面的示例显示了一个绝对列表绑定:使用 $expand 和 $select 查询选项作为绑定参数将表的项目聚合绑定到 /SalesOrderList。 这些列使用路径 SalesOrderID、SO_2_BP/CompanyName 和 BillingStatus 定义相对绑定,并将绝对列表绑定作为父绑定。

上图 XML 视图里第二个 table 控件,即显示行项目的表格控件,使用相对绑定的语法。 由于它定义了参数,一旦它接收到它的绑定上下文,它就会触发它自己的数据服务请求。