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%')