JS SDK

数据引擎提供不跨网络，通过模型访问数据的 JS SDK。为开发者提供易用的访问数据的接口，通过接口访问 DBRest 的数据查询功能、插入/更新及删除功能。

• DbrestWrapper：提供类似 Jave 端的 DbrestWrapper 访问的接口，可以链式调用，使用方法与 Java 端类似
• DbrestFilter：DBRest 数据集过滤条件对象

使用前先添加引用

import {DbrestFilter, DbrestWrapper} from "$UI/wxsys/lib/base/dbrest";

构造方法

DbrestWrapper 接口是为用户提供一个易用的访问数据的接口，通过这个接口访问 DbRest 的查询数据、插入/更新数据、删除数据的方法。

方法：
    constructor(className, pageModel)
描述：
    创建 DbrestWrapper 对象，如果是跨服务访问，需要调用 setServiceName 设置服务名
参数：
    className：要访问的数据模型
    pageModel：组件所在页面的模型

例如：要访问主服务 main 下的订单主表 orderm 的数据，代码如下

  let dbrest = new DbrestWrapper("/main/orderm", this);

查询方法

例：查询订单主表orderm的全部数据、第一页10条数据和第一条数据

async onButton1Click(event{
  let dbrest = new DbrestWrapper("/main/orderm", this);
  let data1 = await dbrest.selectAll();
  console.log(data1);
  let data2 = await dbrest.selectPage(0,10);
  console.log(data2);
  let data3 = await dbrest.selectOne();
  console.log(data3);
}

过滤条件操作符

查询数据时，可以设置过滤条件，过滤条件的操作符见下表

例如：查询订单主表 orderm 订单编号 orderNo 等于1的数据

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.eq("orderNo","1");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：查询订单主表 orderm 订单状态 status 等于已完成且订单金额大于等于150的数据

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.eq("status","已完成").gte("totalMoney",150);
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：查询订单主表 orderm 订单状态 status 等于已完成或订单金额大于等于100的数据

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.eq("status","已完成").or(new DbrestFilter().gte("totalMoney",100));
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

排序方法

例如：查询订单主表 orderm，先按订单状态 status 排升序，再按订单金额 totalMoney 排降序

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.orderByAsc("status").orderByDesc("totalMoney");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

分组统计

例如：查询订单主表 orderm，按订单状态 status 分组，统计订单金额的合计

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("status,sum(totalMoney) as total").groupBy("status");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：查询订单主表 orderm，按订单状态 status 分组，统计订单金额的合计，取订单金额合计大于100的数据

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("status,sum(totalMoney) as total").groupBy("status").having("sum(totalMoney)=gte.100");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

关联查询

例如：通过订单主表 orderm 的客户 id 列左关联客户表的 id 列，查询出客户名称列

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("o.*,c.name");
  dbrest.setMainTableAlias("o").leftJoin("customer").alias("c").on("customerId.eq.id");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：通过订单主表 orderm 的项目 id 列左关联项目表的 id 列，且项目表的状态 status 等于1，查询出项目名称列

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("o.*,p.name").setMainTableAlias("o");
  dbrest.leftJoin("project").alias("p").on("projectId.eq.id").on("{{{1}}}.eq.status");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：通过订单主表 orderm 的客户 id 列左关联客户表的 id 列，再通过订单主表的项目 id 列左关联项目表的 id 列,查询出客户名称、项目名称列

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("o.*,c.name,p.name").setMainTableAlias("o");
  dbrest.leftJoin("customer").alias("c").on("customerId.eq.id");
  dbrest.leftJoin("project").alias("p").on("projectId.eq.id");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

例如：通过订单主表 orderm 的客户 id 列左关联客户表的 id 列，再通过客户表的项目 id 列左关联项目表的 id 列,查询出客户名称、项目名称列

async onButton11Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("o.*,c.name,p.name").setMainTableAlias("o");
  dbrest.leftJoin("customer").alias("c").on("customerId.eq.id");
  dbrest.setLeftAliasUsed("c").leftJoin("project").alias("p").on("projectId.eq.id");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

子查询

例如：使用子查询，查询订单明细中包括办公桌的订单，其中 dbrestSub.columns("orderm") 指的是订单明细表中的外键列

async onButton1Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  let dbrestSub = new DbrestWrapper("/main/orderd", this);
  dbrestSub.columns("orderm").eq("product","办公桌");
  dbrest.addSubQueryWrapper("subquery1", dbrestSub);
  dbrest.in("fid", DbrestWrapper.SubQueryPrefix + "subquery1");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

去重查询

例如：使用去重查询，查询订单主表中有哪些订单状态

async onButton8Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.columns("status").useDistinct();
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

统计方法

例如：计算订单主表订单金额列的合计以及订单主表的记录数

async onButton9Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.sumField("totalMoney").countField("fid");
  let data1 = await dbrest.selectAll();
  console.log(data1);
}

插入、更新、删除方法

例如：订单主表 orderm 插入一条记录

async onButton2Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  let data = await dbrest.insert({"fid":wx.UUID.createUUID(), "orderNo":"123","orderDate": new Date()});
  console.log(data);
}

例如：订单主表 orderm 修改一条记录

async onButton3Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  let data = await dbrest.upsert([{"fid":"CA10BE6CFDB000011C60DA901F605CC0", "orderNo":"33","orderDate": new Date()}]);
  console.log(data);
}

例如：订单主表 orderm 使用 deleteByCondition 方法删除订单编号 orderNo 等于123的记录

async onButton4Click(event/){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.eq("orderNo", "123");
  let data = await dbrest.deleteByCondition();
  console.log(data);
}

例如：订单主表 orderm 使用 delete 方法删除订单编号 orderNo 等于1的记录

async onButton5Click(event){
  let dbrest = new DbrestWrapper("/main/orderm", this);
  dbrest.eq("orderNo", "123");
  let data1 = await dbrest.selectAll()
  console.log(data1);
  let data2 = await dbrest.delete(data1);
  console.log(data2);
}

其它方法

例如：查询企业门户应用 entry 中 uaa 模块下的组织机构 orgs 表

async onButton6Click(event){
  let dbrest = new DbrestWrapper("/uaa/orgs", this);
  dbrest.setServiceName("entry");
  let data1 = await dbrest.selectPage(0,10);
  console.log("total:", dbrest.getTotal());
  console.log(data1);
}

使用 DbrestFilter 构造过滤条件

在数据组件的 setFilter 方法中，可以使用 DbrestFilter 构造过滤条件，支持链式调用，可以使用上面介绍的过滤条件操作符

例如：查询订单主表 orderm 的订单编号 orderNo 等于1的数据

使用 DbrestFilter 的写法如下：

    let data = this.comp("restData0");
    data.setFilter("dbrestFilter", new DbrestFilter().eq("orderNo", "1"));
    data.refreshData();

不使用 DbrestFilter 的写法如下：

    let data = this.comp("restData0");
    data.setFilter("dbrestFilter",[{name:"orderNo",value:"1",op:"eq"}]);
    data.refreshData();