Class DbHelper.ExecuteQuery

  • All Implemented Interfaces:

    
    public final class DbHelper.ExecuteQuery
    
                        

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

    • Constructor Detail

      • DbHelper.ExecuteQuery

        DbHelper.ExecuteQuery(DbHelper dbHelper)
        Конструктор класса
    • Method Detail

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, Class<T> cls, String message, Boolean needFail)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Примеры:

        public String getEntityId() {
            var query = "SELECT id FROM entities where ...";
            return dbHelper.executeQuery.forSingleColumnObject(query, String.class,
                "Получение id");
        }
        public Integer getEntitiesCount() {
            var query = "SELECT count(*) FROM entities";
            return dbHelper.executeQuery.forSingleColumnObject(query, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, Class<T> cls, String message)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Примеры:

        public String getEntityId() {
            var query = "SELECT id FROM entities where ...";
            return dbHelper.executeQuery.forSingleColumnObject(query, String.class,
                "Получение id");
        }
        public Integer getEntitiesCount() {
            var query = "SELECT count(*) FROM entities";
            return dbHelper.executeQuery.forSingleColumnObject(query, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, Class<T> cls)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Примеры:

        public String getEntityId() {
            var query = "SELECT id FROM entities where ...";
            return dbHelper.executeQuery.forSingleColumnObject(query, String.class,
                "Получение id");
        }
        public Integer getEntitiesCount() {
            var query = "SELECT count(*) FROM entities";
            return dbHelper.executeQuery.forSingleColumnObject(query, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        Returns:

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

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, HashMap<String, Object> params, Class<T> cls, String message, Boolean needFail)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Пример:

        public Integer getEntitiesCount(String value) {
            var query = "SELECT count(*) FROM entities WHERE Value = :value";
            var params = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forSingleColumnObject(query, params, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, HashMap<String, Object> params, Class<T> cls, String message)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Пример:

        public Integer getEntitiesCount(String value) {
            var query = "SELECT count(*) FROM entities WHERE Value = :value";
            var params = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forSingleColumnObject(query, params, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forSingleColumnObject

         final <T extends Any> T forSingleColumnObject(String sqlQuery, HashMap<String, Object> params, Class<T> cls)

        Метод выполняет запрос к БД вида "select id from ..." и возвращает одно значение из одной колонки.

        Пример:

        public Integer getEntitiesCount(String value) {
            var query = "SELECT count(*) FROM entities WHERE Value = :value";
            var params = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forSingleColumnObject(query, params, Integer.class,
                "Получение количества записей в таблице");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        Returns:

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

      • forList

         final <T extends Any> List<T> forList(String sqlQuery, 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:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forList

         final <T extends Any> List<T> forList(String sqlQuery, 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:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forList

         final <T extends Any> List<T> forList(String sqlQuery, 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:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        Returns:

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

      • forList

         final <T extends Any> List<T> forList(String sqlQuery, HashMap<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 = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forList(query, params, Entity.class,
                "Получение записей из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forList

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

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

        Пример:

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

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

      • forList

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

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

        Пример:

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

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, 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,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, 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,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, 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,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        cls - Класс ответа T.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, HashMap<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 = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        needFail - По умолчанию true.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, HashMap<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 = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        message - По умолчанию null.
        Returns:

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

      • forListAndGetFirst

         final <T extends Any> T forListAndGetFirst(String sqlQuery, HashMap<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 = new HashMap<String, Object>();
            params.put("value", value);
            return dbHelper.executeQuery.forListAndGetFirst(query, params, Entity.class,
                "Получение записи из таблицы");
        }
        Parameters:
        sqlQuery - sql-запрос
        params - HashMap с параметрами запроса
        cls - Класс ответа T.
        Returns:

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

      • withoutResponse

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

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

        Пример:

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

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

      • withoutResponse

         final Integer withoutResponse(String sqlQuery, String message)

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

        Пример:

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

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

      • withoutResponse

         final Integer withoutResponse(String sqlQuery)

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

        Пример:

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

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

      • withoutResponse

         final Integer withoutResponse(String sqlQuery, HashMap<String, Object> params, String message, Boolean needFail)

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

        Пример:

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

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

      • withoutResponse

         final Integer withoutResponse(String sqlQuery, HashMap<String, Object> params, String message)

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

        Пример:

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

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

      • withoutResponse

         final Integer withoutResponse(String sqlQuery, HashMap<String, Object> params)

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

        Пример:

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

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