結(jié)果集

結(jié)果集是指用戶(hù)調(diào)用關(guān)系型數(shù)據(jù)庫(kù)查詢(xún)接口之后返回的結(jié)果集合，提供了多種靈活的數(shù)據(jù)訪問(wèn)方式，以便用戶(hù)獲取各項(xiàng)數(shù)據(jù)。

說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 7開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

使用說(shuō)明

需要通過(guò)[RdbStore.query()]獲取resultSet對(duì)象。

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

提供通過(guò)查詢(xún)數(shù)據(jù)庫(kù)生成的數(shù)據(jù)庫(kù)結(jié)果集的訪問(wèn)方法。

屬性

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedDataManager.RelationalStore.Core。

getColumnIndex

getColumnIndex(columnName: string): number

根據(jù)指定的列名獲取列索引。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

根據(jù)指定的列索引獲取列名。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

goTo

goTo(offset:number): boolean

向前或向后轉(zhuǎn)至結(jié)果集的指定行，相對(duì)于其當(dāng)前位置偏移。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

轉(zhuǎn)到結(jié)果集的指定行。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

轉(zhuǎn)到結(jié)果集的第一行。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

示例：

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

轉(zhuǎn)到結(jié)果集的最后一行。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

示例：

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

轉(zhuǎn)到結(jié)果集的下一行。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

示例：

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

轉(zhuǎn)到結(jié)果集的上一行。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

返回值：

示例：

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

以字節(jié)數(shù)組的形式獲取當(dāng)前行中指定列的值。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

getString

getString(columnIndex: number): string

以字符串形式獲取當(dāng)前行中指定列的值。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

getLong

getLong(columnIndex: number): number

以Long形式獲取當(dāng)前行中指定列的值。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

getDouble

getDouble(columnIndex: number): number

以double形式獲取當(dāng)前行中指定列的值。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

isColumnNull

isColumnNull(columnIndex: number): boolean

檢查當(dāng)前行中指定列的值是否為null。

系統(tǒng)能力： SystemCapability.DistributedDataManager.RelationalStore.Core。

參數(shù)：

返回值：

示例：

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

close

close(): void

關(guān)閉結(jié)果集。

系統(tǒng)能力： 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')
})

審核編輯 黃宇