X DevAPI 用户指南  / 第 9 章 使用结果集  /  9.1 结果集类

9.1 结果集类

所有数据库操作都返回一个结果。返回的结果类型取决于执行的操作。下表概述了返回的不同类型的结果。

结果类

归还者

提供

Result

add().execute(), insert().execute(), ...

affectedRows, lastInsertId, 警告

SqlResult

session.sql()

affectedRows, lastInsertId, 警告, 获取的数据集

DocResult

find().execute()

获取的数据集

RowResult

select.execute()

获取的数据集

下面的类图给出了结果处理的基本概述。

图 9.1 结果 - 类图

在以下函数中，方括号表示项目列表。 这可以是目标语言中任何适当的列表类型（数组、集合等）。 BaseResults 类包含以下函数：getWarningsCount(): int 和 getWarnings(): Warning[]。 这是诊断功能。 Result类包含以下函数：getAffectedItemsCount():int、getLastInsertID():int、getLastDocumentID():UUID_String，是数据变化信息函数。 DocResult 类包含以下函数：fetchOne(): DbDoc 和fetchAll(): DbDoc[]，它们是文档访问函数。 RowResult 类包含以下函数：fetchOne(): Row 和 fetchAll(): Row[]，它们是行访问函数。 getColumnCount()：int、getColumns()：Column[] 和 getColumnNames()：String[]。 这是列访问功能。 SqlResult 类包含以下函数：getAffectedItemsCount()：int、getLastInsertId()：int、hasData()：boolean 和 nextResult()：boolean。 最后一个函数返回多个数据集。