9.1 Result Set Classes — MySQL Connectors 1.0

9.1 Классы наборов результатов

Все операции с базой данных возвращают результат. Тип возвращаемого результата зависит от выполненной операции. Различные типы результатов описаны в следующей таблице.

Таблица 9.1 Классы результатов и предоставляемая ими информация

Таблица 9.1 Классы результатов и предоставляемая ими информация
Класс результата	Возвращается операциями	Предоставляет
`Result`	`add().execute()`, `insert().execute()`, `modify().execute()`, `update().execute()` , `remove().execute()`, `delete().execute()`	Количество строк, затронутых операцией, автоматически сгенерированные идентификаторы документов, значения последнего автоматически сгенерированного `AUTO INCREMENT` столбца или сообщения об ошибках, в зависимости от операции, для которой возвращается `Result`.
`SqlResult`	`session.sql().execute()`	Количество строк, затронутых операцией, автоматически сгенерированные идентификаторы документов, значения последнего автоматически сгенерированного `AUTO INCREMENT` столбца, сообщения об ошибках или извлеченный набор данных, в зависимости от операции, для которой возвращается `SqlResult`.
`DocResult`	`find().execute()`	Извлеченный набор данных
`RowResult`	`select.execute()`	Извлеченный набор данных

Следующая диаграмма классов предоставляет общее представление о классах результатов и их функциях.

Рисунок 9.1 Классы результатов

In the following functions, square brackets indicate a list of items. This can be any appropriate list type in the target language (an array, a collection, and so on). The BaseResults class contains the following functions: getWarnings(): Warning[] and getWarningsCount(): int, which are diagnostics functions. The Result class contains the following functions: getAffectedItemsCount(): int, getAutoIncrementValue(): int, getGeneratedIds(): String[], which are data change information functions. The DocResult class contains the following functions: fetchAll(): Document[] and fetchOne(): Document, which are document access functions. The RowResult class contains the following functions: fetchAll(): Row[], fetchOne(): Row, getColumns(): Column[], and nextResult(): boolean. The SqlResult class contains the following functions: hasData(): boolean, getAffectedItemsCount(): int, and getAutoIncrementValue(): int.