ODk Test Framework (версия 2.5.2)/io.bitbucket.dsmoons.framework.odk.db/DbHelper/ExecuteQuery/forListAndGetFirst

forListAndGetFirst

fun <T : Any> forListAndGetFirst(sql: String, cls: Class<T>): T?

Метод выполняет запрос к БД. Работает аналогично методу forList, но возвращает только первый объект из списка.

Метод используется, например, с sql-запросами с оператором ORDER BY.

public Table getEntityByValue(String value) {
    var query = "SELECT * FROM table WHERE value = :value ORDER BY id DESC";
    var params = Map.of("value", value);
    return dbHelper.executeQuery
         .withParameters(params)
         .withMessage("Получение записи из таблицы")
         .forListAndGetFirst(query, Table.class);
}

public Table getEntityByValue(String value) {
    var query = "SELECT * FROM table WHERE value = '" + value + "' ORDER BY id DESC";
    return dbHelper.executeQuery
         .withMessage("Получение записи из таблицы")
         .forListAndGetFirst(query, Table.class);
}

Return

Объект класса T

Since

2.5.2

Parameters

Класс ответа

sql

Запрос

cls

Класс ответа T. Может быть record, POJO, Kotlin Data Class или другой, описывающий структуру таблицы в БД

fun <T : Any> forListAndGetFirst(sql: String, cls: KClass<T>): T?

Метод выполняет запрос к БД. Работает аналогично методу forList, но возвращает только первый объект из списка.

Метод используется, например, с sql-запросами с оператором ORDER BY.

fun getEntityByValue(value: String): Table? {
    val query = "SELECT * FROM table WHERE value = '$value' ORDER BY id DESC"
    return dbHelper.executeQuery
         .withMessage("Получение записи из таблицы")
         .forListAndGetFirst(query, Table::class)
}

Return

Объект класса T

Since

2.5.2

Parameters

Класс ответа

sql

Запрос

cls

Класс ответа T. Может быть record, POJO, Kotlin Data Class или другой, описывающий структуру таблицы в БД

fun forListAndGetFirst(sql: String): Entity

Метод выполняет запрос к БД. Работает аналогично методу forList, но возвращает только первый объект Entity из списка или пустой объект Entity, если список пуст.

Return

Объект Entity

Since

2.5.2

Parameters

sql

Запрос