鸿蒙开发接口数据管理：【data/rdb/resultSet (结果集)】

jf_46214456 2024-06-11 709

电子说

1.3w人已加入

描述

结果集

结果集是指用户调用关系型数据库查询接口之后返回的结果集合，提供了多种灵活的数据访问方式，以便用户获取各项数据。

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

使用说明

需要通过[RdbStore.query()]获取resultSet对象。

import dataRdb from '@ohos.data.rdb';
let predicates = new dataRdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("AGE", 18)
let promise = rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promise.then((resultSet) = > {
    console.log(TAG + "resultSet columnNames:" + resultSet.columnNames);
    console.log(TAG + "resultSet columnCount:" + resultSet.columnCount);})

ResultSet

提供通过查询数据库生成的数据库结果集的访问方法。

属性

系统能力： 以下各项对应的系统能力均为SystemCapability.DistributedDataManager.RelationalStore.Core。

名称参数类型必填说明
columnNamesArray是获取结果集中所有列的名称。
columnCountnumber是获取结果集中的列数。
rowCountnumber是获取结果集中的行数。
rowIndexnumber是获取结果集当前行的索引。
isAtFirstRowboolean是检查结果集是否位于第一行。
isAtLastRowboolean是检查结果集是否位于最后一行。
isEndedboolean是检查结果集是否位于最后一行之后。
isStartedboolean是检查指针是否移动过。
isClosedboolean是检查当前结果集是否关闭。

getColumnIndex

getColumnIndex(columnName: string): number

根据指定的列名获取列索引。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnNamestring是表示结果集中指定列的名称。

返回值：

类型说明
number返回指定列的索引。

示例：

resultSet.goToFirstRow()
const id = resultSet.getLong(resultSet.getColumnIndex("ID"))
const name = resultSet.getString(resultSet.getColumnIndex("NAME"))
const age = resultSet.getLong(resultSet.getColumnIndex("AGE"))
const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY"))

getColumnName

getColumnName(columnIndex: number): string

根据指定的列索引获取列名。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是表示结果集中指定列的索引。

返回值：

类型说明
string返回指定列的名称。

示例：

const id = resultSet.getColumnName(0)
const name = resultSet.getColumnName(1)
const age = resultSet.getColumnName(2)

goTo

goTo(offset:number): boolean

向前或向后转至结果集的指定行，相对于其当前位置偏移。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
offsetnumber是表示相对于当前位置的偏移量。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgoto = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoto = rdbStore.query(predicatesgoto, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoto.then((resultSet) {
    resultSet.goTo(1)
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

goToRow

goToRow(position: number): boolean

转到结果集的指定行。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
positionnumber是表示要移动到的指定位置。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgotorow = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygotorow = rdbStore.query(predicatesgotorow, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygotorow.then((resultSet) {
    resultSet.goToRow(5)
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

goToFirstRow

goToFirstRow(): boolean

转到结果集的第一行。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgoFirst = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoFirst = rdbStore.query(predicatesgoFirst, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoFirst.then((resultSet) {
    resultSet.goToFirstRow()
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

goToLastRow

goToLastRow(): boolean

转到结果集的最后一行。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgoLast = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoLast = rdbStore.query(predicatesgoLast, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoLast.then((resultSet) {
    resultSet.goToLastRow()
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

goToNextRow

goToNextRow(): boolean

转到结果集的下一行。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgoNext = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoNext = rdbStore.query(predicatesgoNext, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoNext.then((resultSet) {
    resultSet.goToNextRow()
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

goToPreviousRow

goToPreviousRow(): boolean

转到结果集的上一行。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

类型说明
boolean如果成功移动结果集，则为true；否则返回false。

示例：

let predicatesgoPrev = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoPrev = rdbStore.query(predicatesgoPrev, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoPrev.then((resultSet) {
    resultSet.goToPreviousRow()
    resultSet.close()
}).catch((err) = > {
    console.log('query failed')
})

getBlob

getBlob(columnIndex: number): Uint8Array

以字节数组的形式获取当前行中指定列的值。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是指定的列索引，从0开始。

返回值：

类型说明
Uint8Array以字节数组的形式返回指定列的值。

示例：

const codes = resultSet.getBlob(resultSet.getColumnIndex("CODES"))

getString

getString(columnIndex: number): string

以字符串形式获取当前行中指定列的值。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是指定的列索引，从0开始。

返回值：

类型说明
string以字符串形式返回指定列的值。

示例：

const name = resultSet.getString(resultSet.getColumnIndex("NAME"))

getLong

getLong(columnIndex: number): number

以Long形式获取当前行中指定列的值。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是指定的列索引，从0开始。

返回值：

类型说明
number以Long形式返回指定列的值。

示例：

const age = resultSet.getLong(resultSet.getColumnIndex("AGE"))

getDouble

getDouble(columnIndex: number): number

以double形式获取当前行中指定列的值。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是指定的列索引，从0开始。

返回值：

类型说明
number以double形式返回指定列的值。

示例：

const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY"))

isColumnNull

isColumnNull(columnIndex: number): boolean

检查当前行中指定列的值是否为null。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

参数：

参数名类型必填说明
columnIndexnumber是指定的列索引，从0开始。

返回值：

类型说明
boolean如果当前行中指定列的值为null，则返回true，否则返回false。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

鸿蒙

示例：

const isColumnNull = resultSet.isColumnNull(resultSet.getColumnIndex("CODES"))

close

close(): void

关闭结果集。

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

示例：

let predicatesClose = new dataRdb.RdbPredicates("EMPLOYEE")
let promiseClose = rdbStore.query(predicatesClose, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promiseClose.then((resultSet) {
    resultSet.close()
}).catch((err) = > {
    console.log('resultset close failed')
})

审核编辑 黄宇

打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分