OpenHarmony关系型数据库查询结果呈现

1 ResultSet(结果集)

ResultSet(结果集)是OpenHarmony关系型数据库提供查询数据表返回结果的方法，提供了多种灵活的数据访问方式，以便于开发者获取各项数据，ResultSet属性如表1-1所示，ResultSet方法如表1-2所示。

表1-1 ResultSet属性

名称	类型	必填	说明
columnNames	Array<string>	是	结果集中所有列的名称
columnCount	number	是	结果集中的列数
rowCount	number	是	结果集中的行数
rowIndex	number	是	结果集当前行的索引
isAtFirstRow	boolean	是	结果集是否位于第一行
isAtLastRow	boolean	是	结果集是否位于最后一行
isEnded	boolean	是	结果集是否位于最后一行之后
isStarted	boolean	是	指针是否移动过
isClosed	boolean	是	当前结果集是否关闭

表1-2 ResultSet方法

名称	描述
getColumnIndex(columnName: string): number	根据指定的列名获取列索引 columnName: 结果集中指定列的名称 number: 返回指定列的索引
getColumnName(columnIndex: number): string	根据指定的列索引获取列名 columnIndex: 结果集中指定列的索引 string: 返回指定列的名称
goTo(offset: number): boolean	向前或向后转至结果集的指定行，相对于当前行位置偏移 offset: 表示相对于当前行位置偏移量 boolean：操作成功，则为true，否则为false
goToRow(position: number): boolean	转到结果集的指定行 position: 表示要移动到的指定位置 boolean: 操作成功，则为true，否则为false
goToFirstRow(): boolean	转到结果集的第一行 boolean: 操作成功，则为true，否则为false
goToLastRow(): boolean	转到结果集的最后一行 boolean: 操作成功，则为true，否则为false
goToNextRow(): boolean	转到结果集的下一行 boolean: 操作成功，则为true，否则为false
goToPreviousRow(): boolean	转到结果集上一行 boolean: 操作成功，则为true，否则为false
getBlob(columnIndex: number): Uint8Array	以字节数组的形式获取当前行中指定列的值 指定的列索引，从0开始 Uint8Array: 以字节数组的形式返回指定列的值
getString(columnIndex: number): string	以字符串形式获取当前行中指定列的值 columnIndex: 指定的列索引，从0开始 string: 以字符串形式返回指定列的值
getLong(columnIndex: number): number	以Long形式获取当前行中指定列的值 columnIndex: 指定的列索引，从0开始 number: 以Long形式返回指定列的值。该接口支持的数据范围是：Number.MIN_SAFE_INTEGER~Number.MAX_SAFE_INTEGER，若超出该范围，则建议使用getDouble
getDouble(columnIndex: number): number	以double形式获取当前行中指定列的值 columnIndex: 指定的列索引，从0开始 number: 以double形式返回指定列的值
isColumnNull(columnIndex: number): boolean	检查当前行中指定列的值是否为null columnIndex: 指定的列索引，从0开始 boolean: 当前行中指定列的值为null，则返回true，否则为false
close(): void	关闭结果集

2 流程

3 步骤

3.1 获取ResultSet结果集

通过RdbStore实例的query()或querySql()方法获得ResultSet结果集。

let predicates = new relationalStore.RdbPredicates(this.tableName);
let result = await this.rdbStore.query(predicates, columns);

3.2 自定义返回结果类

自定义TableResultSet类用于前台展示。

export class TableResultSet {
    private total: number;                 // 总条数
    private data: any;                     // 数据表数据

    setTotal(total: number) {
        this.total = total;
    }

    setData(data: any) {
        this.data = data;
    }
}

3.3 结果集转返回结果

ResultSet并不能直接用来展示，通过ResultSet提供的各类方法获取需要的信息。

  private resultToObject(result: relationalStore.ResultSet) {
    let trs = new TableResultSet();
    trs.setData(result.rowCount);
    let data: Array<any> = [];
    let count = result.rowCount;
    if (count === 0 || typeof count === 'string') {
      trs.setData([]);
    } else {
      // 从数据第一行开始读取
      result.goToFirstRow();
      for (let j = 0; j < count; j++) {
        let temp: any = {};
        for (let i = 0; i < this.fields.length; i++) {
          let field = this.fields[i];
          if (field.type === 'INTEGER' || field.type === 'integer') {
            temp[field.name] = result.getLong(result.getColumnIndex(field.name));
          } else if (field.type === 'REAL' || field.type === 'real') {
            temp[field.name] = result.getDouble(result.getColumnIndex(field.name));
          } else if (field.type === 'TEXT' || field.type === 'text') {
            temp[field.name] = result.getString(result.getColumnIndex(field.name));
          } else if (field.type === 'BLOB' || field.type === 'blob') {
            temp[field.name] = result.getBlob(result.getColumnIndex(field.name));
          }
        }
        data.push(temp);
        result.goToNextRow();
      }
      trs.setData(data);
    }
    return trs;
  }

4 呈现结果

• 使用断点调试方式

• 使用日志调试方式

Log.info(TAG, `Query of ${this.tableName} table data succeeded. data: ` + JSON.stringify(result));

• 页面显示

// 显示表名称
Text(TableConstants.T_ACCOUNT_NAME)
  .fontSize(18)
  .fontWeight(700)
  .width('90%').height(54)
Column({space: 5}) {
  if (this.result !== null) {
    // 显示表字段
    GridRow({
      columns: TableConstants.T_ACCOUNT_FIELDS.length,
      direction: GridRowDirection.Row
    }) {
      ForEach(this.result.fields, (field) => {
        GridCol() {
          Text(field)
            .width("100%").height(54)
            .fontSize(16)
            .textAlign(TextAlign.Center)
        }
        .colStyle()
      })
    }
    .width('90%').height(54)
    .backgroundColor(0xE5E5E5)
    // 显示表数据
    ForEach(this.result.data, (item) => {
      GridRow({
        columns: TableConstants.T_ACCOUNT_FIELDS.length,
        direction: GridRowDirection.Row
      }) {
        ForEach(TableConstants.T_ACCOUNT_FIELDS, (field) => {
          GridCol() {
            this.Label(item[field.name].toString())
          }
          .colStyle()
        })
      }
      .width('90%').height(54)
      .backgroundColor(0xF5F5F5)
    }, temp => temp.toString())
  }
}
.width('100%')