api/ru.sydis.api.types/DpQueryResult

DpQueryResult

data class DpQueryResult(val rowNames: List<String>, val columnNames: List<String>, val data: List<List<ProtoValue>>)

Представляет результат выполнения запроса в виде двумерной таблицы:

строки идентифицируются по именам (rowNames),
столбцы идентифицируются по именам (columnNames),
данные хранятся как матрица значений ProtoValue.

Первый элемент каждой строки в исходном proto-сообщении интерпретируется как имя строки

Все методы доступа безопасны: при некорректных индексах или отсутствующих именах возвращается null.

Constructors

DpQueryResult

constructor(rowNames: List<String>, columnNames: List<String>, data: List<List<ProtoValue>>)

Types

Companion

object Companion

Компаньон-объект для создания экземпляров DpQueryResult из proto-сообщений.

RowView

data class RowView(val name: String, val values: Map<String, ProtoValue>)

Представление одной строки с именем и значениями по столбцам.

Properties

columnCount

val columnCount: Int

Количество столбцов в таблице.

columnNames

val columnNames: List<String>

Список имён столбцов (заголовки данных).

data

val data: List<List<ProtoValue>>

Двумерный список значений (rowCount × columnCount), без имён строк и столбцов.

isEmpty

val isEmpty: Boolean

Возвращает true, если таблица не содержит данных (0 строк или 0 столбцов).

isNotEmpty

val isNotEmpty: Boolean

Возвращает true, если таблица содержит хотя бы одну строку и один столбец.

isValid

val isValid: Boolean

Проверяет согласованность структуры:

rowCount

val rowCount: Int

Количество строк в таблице.

rowNames

val rowNames: List<String>

Список имён строк (обычно — ключи или идентификаторы).

shape

val shape: Pair<Int, Int>

Размер таблицы в формате (число строк, число столбцов).

Functions

asRowViews

fun asRowViews(): Sequence<DpQueryResult.RowView>

Преобразует таблицу в последовательность представлений строк (RowView).

getCell

fun getCell(rowIndex: Int, colIndex: Int): ProtoValue?

Возвращает значение ячейки в виде ProtoValue по заданным индексам.

fun getCell(rowName: String, colName: String): ProtoValue?

Возвращает значение ячейки в виде ProtoValue по имени строки и столбца.

getColumn

fun getColumn(colIndex: Int): Sequence<ProtoValue>?

Возвращает столбец данных по индексу в виде Sequence.

fun getColumn(colName: String): Sequence<ProtoValue>?

Возвращает столбец данных по имени в виде Sequence.

getColumnValues

fun getColumnValues(colIndex: Int): Sequence<Any>?

Возвращает десериализованный столбец по индексу в виде Sequence.

fun getColumnValues(colName: String): Sequence<Any>?

Возвращает десериализованный столбец по имени в виде Sequence.

getRow

fun getRow(rowIndex: Int): Sequence<ProtoValue>?

Возвращает десериализованную строку по индексу в виде Sequence.

fun getRow(rowName: String): Sequence<ProtoValue>?

Возвращает строку данных по имени в виде Sequence.

getRowValues

fun getRowValues(rowIndex: Int): Sequence<Any>?

Возвращает десериализованную строку по индексу в виде Sequence.

fun getRowValues(rowName: String): Sequence<Any>?

Возвращает десериализованную строку по имени в виде Sequence.

getValue

fun getValue(rowIndex: Int, colIndex: Int): Any?

Возвращает десериализованное значение ячейки как Any по заданным индексам.

fun getValue(rowName: String, colName: String): Any?

Возвращает десериализованное значение ячейки по имени строки и столбца.

toNestedMap

fun toNestedMap(): Map<String, Map<String, Any>>

Преобразует таблицу в вложенный словарь: [rowName] → [colName] → значение.

toTableString

fun toTableString(maxWidth: Int = 30): String

Формирует человекочитаемое строковое представление таблицы в виде ASCII-таблицы.