Package io.bitbucket.dsmoons.framework.odk

Class DbHelper.ExecuteQuery

  • All Implemented Interfaces:
    
public final class DbHelper.ExecuteQuery

    Дополнительный класс, предоставляющий методы доступа к БД

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description

    • Field Summary

      Fields 
      Modifier and Type Field Description

    • Constructor Summary

      Constructors 
      Constructor Description

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description

    • Constructor Detail

    • Method Detail

      • forList

         final <T extends Any> List<T> forList(String sql, Class<T> cls, String message, Boolean needFail)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.forList(query, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Список объектов класса T

      • forList

         final <T extends Any> List<T> forList(String sql, Class<T> cls, String message)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.forList(query, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

        Список объектов класса T

      • forList

         final <T extends Any> List<T> forList(String sql, Class<T> cls)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.forList(query, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        Returns:

        Список объектов класса T

      • forList

         final <T extends Any> List<T> forList(String sql, Map<String, Object> params, Class<T> cls, String message, Boolean needFail)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forList(query, params, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Список объектов класса T

      • forList

         final <T extends Any> List<T> forList(String sql, Map<String, Object> params, Class<T> cls, String message)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forList(query, params, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

        Список объектов класса T

      • forList

         final <T extends Any> List<T> forList(String sql, Map<String, Object> params, Class<T> cls)

        Метод выполняет запрос к БД и возвращает список объектов.

        Пример:

        public List<Entity> getEntitiesListByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forList(query, params, Entity.class,
        "Получение записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        Returns:

        Список объектов класса T

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql, String message, Boolean needFail)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql, String message)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        message - По умолчанию null.
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql, Map<String, Object> params, String message, Boolean needFail)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql, Map<String, Object> params, String message)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        message - По умолчанию null.
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListOfRowMaps

         final List<Map<String, Object>> forListOfRowMaps(String sql, Map<String, Object> params)

        Метод выполняет запрос к БД и возвращает список ассоциативных массивов (Map), где ключ массива - название столбца, значение - значение из таблицы

        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        Returns:

        Список массивов

        Since:

        2.5.0

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Class<T> cls, String message, Boolean needFail)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s' ORDER BY id DESC", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, Entity.class,
        "Получение записи из таблицы");
}
        public Integer getEmployeesCount() {
    var query = "SELECT count(*) FROM employees";
    return sqlite.executeQuery.forListAndGetFirst(query, Integer.class);
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Class<T> cls, String message)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s' ORDER BY id DESC", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, Entity.class,
        "Получение записи из таблицы");
}
        public Integer getEmployeesCount() {
    var query = "SELECT count(*) FROM employees";
    return sqlite.executeQuery.forListAndGetFirst(query, Integer.class);
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Class<T> cls)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = String.format("SELECT * FROM entities WHERE value = '%s' ORDER BY id DESC", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, Entity.class,
        "Получение записи из таблицы");
}
        public Integer getEmployeesCount() {
    var query = "SELECT count(*) FROM employees";
    return sqlite.executeQuery.forListAndGetFirst(query, Integer.class);
}
        Parameters:
        sql - sql-запрос
        cls - Класс ответа T.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Map<String, Object> params, Class<T> cls, String message, Boolean needFail)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value ORDER BY id DESC";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
        "Получение записи из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Map<String, Object> params, Class<T> cls, String message)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value ORDER BY id DESC";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
        "Получение записи из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sql, Map<String, Object> params, Class<T> cls)

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

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

        Пример:

        public Entity getEntityByValue(String value) {
    var query = "SELECT * FROM entities WHERE value = :value ORDER BY id DESC";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
        "Получение записи из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        cls - Класс ответа T.
        Returns:

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

      • withoutResponse

         final Integer withoutResponse(String sql, String message, Boolean needFail)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = String.format("DELETE * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.withoutResponse(query, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Количество строк, затронутых запросом

      • withoutResponse

         final Integer withoutResponse(String sql, String message)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = String.format("DELETE * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.withoutResponse(query, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        message - По умолчанию null.
        Returns:

        Количество строк, затронутых запросом

      • withoutResponse

         final Integer withoutResponse(String sql)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = String.format("DELETE * FROM entities WHERE value = '%s'", value);
    return dbHelper.executeQuery.withoutResponse(query, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        Returns:

        Количество строк, затронутых запросом

      • withoutResponse

         final Integer withoutResponse(String sql, Map<String, Object> params, String message, Boolean needFail)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = "DELETE * FROM entities WHERE Value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.withoutResponse(query, params, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

        Количество строк, затронутых запросом

      • withoutResponse

         final Integer withoutResponse(String sql, Map<String, Object> params, String message)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = "DELETE * FROM entities WHERE Value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.withoutResponse(query, params, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        message - По умолчанию null.
        Returns:

        Количество строк, затронутых запросом

      • withoutResponse

         final Integer withoutResponse(String sql, Map<String, Object> params)

        Метод выполняет запрос к БД без ответа (DELETE, UPDATE, INSERT и т.д.).

        Пример:

        public int deleteEntitiesByValue(String value) {
    var query = "DELETE * FROM entities WHERE Value = :value";
    var params = Map.of("value", value);
    return dbHelper.executeQuery.withoutResponse(query, params, "Удаление записей из таблицы");
}
        Parameters:
        sql - sql-запрос
        params - Map с параметрами запроса
        Returns:

        Количество строк, затронутых запросом