AnyLogic
Развернуть
Размер шрифта

Функции базы данных

Функция Описание
java.sql.Connection getDatabaseConnection() Возвращает соединение с базой данных AnyLogic.
DeleteQuery deleteFrom(com.querydsl.sql.RelationalPathBase<?> table) Возвращает объект DeleteQuery, с помощью которого можно сконструировать запрос путем последовательных вызовов базы данных.

table — таблица, которую нужно удалить
InsertQuery insertInto(com.querydsl.sql.RelationalPathBase<?> table) Возвращает объект InsertQuery, с помощью которого можно сконструировать запрос путем последовательных вызовов базы данных.

table — таблица, в которую нужно вставить данные
SelectQuery selectFrom(com.querydsl.sql.RelationalPathBase<?> table) Возвращает объект SelectQuery, с помощью которого можно сконструировать запрос путем последовательных вызовов базы данных.

table — таблица, из которой нужно запросить данные
UpdateQuery update(com.querydsl.sql.RelationalPathBase<?> table) Возвращает объект UpdateQuery, с помощью которого можно сконструировать запрос путем последовательных вызовов базы данных.

table — таблица, которую нужно обновить
java.sql.PreparedStatement prepareStatement(String sql, Object... params) Создает объект PreparedStatement, который может в дальнейшем использоваться для вызова операторов INSERT, DELETE и UPDATE в контексте базы данных AnyLogic. Для объекта задается строка переданного SQL-запроса и соответствующие параметры.
Когда объект больше не нужен, его необходимо удалить вручную путем вызова функции close().

sql — строка, содержащая SQL-оператор
params — массив, содержащий параметры запроса
int selectAndDoForEach(java.util.function.Consumer<ResultSet> action, String sql, Object... params) Выполняет определенное действие для заданных оператора и параметров sql и params. Возвращает выбранные записи.
Например:
selectAndDoForEach( rs -> myCollection.add( rs.getString(1) ), ”SELECT name FROM parts_table WHERE priority = ?”, ”high” );

action — что нужно сделать с каждой записью (используйте get-функции для каждого набора результатов)
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
double[] selectArrayOfDouble(String sql, Object... params) Возвращает массив чисел типа double из первой колонки, которую возвращают заданные sql-запрос и его параметры. Запрос должен возвращать единственную колонку. Если результатов нет, возвращается пустой массив.

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
int[] selectArrayOfInt(String sql, Object... params) Возвращает массив чисел типа int из первой колонки, которую возвращают заданные sql-запрос и его параметры. Запрос должен возвращать единственную колонку. Если результатов нет, возвращается пустой массив.

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
boolean selectExists(String sql, Object... params) Возвращает true, если заданные sql-запрос и параметры возвращают хотя бы один результат. Результаты вызова функции кэшируются для увеличения производительности. Чтобы получить незакэшированный результат, используйте нотацию selectExists(false, sql, params).

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
boolean selectExists(boolean cached, String sql, Object... params) Возвращает true, если заданные sql-запрос и параметры возвращают хотя бы один результат.

cached — если true, то функция будет пытаться использовать закэшированные значения, чтобы не подключаться к базе данных
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectFirstValue(String sql, Object... params) Возвращает первый результат для заданных sql-запроса и параметров или null, если подходящих записей не обнаружено. Результаты вызова функции кэшируются для увеличения производительности. Чтобы получить незакэшированный результат, используйте нотацию selectFirstValue(false, sql, params).

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectFirstValue(boolean cached, String sql, Object... params) Возвращает первый результат для заданных sql-запроса и параметров или null, если подходящих записей не обнаружено.

cached — если true, то функция будет пытаться использовать закэшированные значения, чтобы не подключаться к базе данных
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectFirstValue(Class<T> returnType, String sql, Object... params) Возвращает первый результат для заданных sql-запроса и параметров или null, если подходящих записей не обнаружено. Результаты вызова функции кэшируются для увеличения производительности. Чтобы получить незакэшированный результат, используйте нотацию selectFirstValue(false, returnType, sql, params).

returnType — тип данных, который должна возвращать функция
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectFirstValue(boolean cached, Class<T> returnType, String sql, Object... params) Возвращает первый результат для заданных sql-запроса и параметров или null, если подходящих записей не обнаружено.

cached — если true, то функция будет пытаться использовать закэшированные значения, чтобы не подключаться к базе данных
returnType — тип данных, который должна возвращать функция
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
ResultSet selectResultSet(String sql, Object... params) Запрашивает результаты и возвращает объект типа «набор результатов» (ResultSet) для заданных sql-запроса и параметров.

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
TableFunction selectTableFunction(TableFunction tableFunction, String sql, Object... params) Выполняет заданный SELECT-запрос, возвращающий данные в 2 колонках. В первой колонке находятся значения аргументов, во второй — соответствующие значения из базы данных. Также возвращает использованную табличную функцию.

tableFunction — табличная функция
sql — строка, содержащая SQL-оператор
params — массив, содержащий параметры оператора
<T> T selectUniqueValue(String sql, Object... params) Возвращает уникальный результат для заданных sql-запроса и параметров. Возвращает полученное значение колонки. При отсутствии подходящих значений или неуникальном результате возвращает ошибку RuntimeException. Результаты вызова функции кэшируются для увеличения производительности. Чтобы получить незакэшированный результат, используйте нотацию selectUniqueValue(false, sql, params).

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectUniqueValue(boolean cached, String sql, Object... params) Возвращает уникальный результат для заданных sql-запроса и параметров. Возвращает полученное значение колонки. При отсутствии подходящих значений или неуникальном результате возвращает ошибку RuntimeException.

cached — если true, то функция будет пытаться использовать закэшированные значения, чтобы не подключаться к базе данных
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectUniqueValue(Class<T> returnType, String sql, Object... params) Возвращает уникальный результат для заданных sql-запроса и параметров. Возвращает полученное значение колонки. При отсутствии подходящих значений или неуникальном результате возвращает ошибку RuntimeException. Результаты вызова функции кэшируются для увеличения производительности. Чтобы получить незакэшированный результат, используйте нотацию selectUniqueValue(false, returnType, sql, params).

returnType — тип данных, который должна возвращать функция
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T selectUniqueValue(boolean cached, Class<T> returnType, String sql, Object... params) Возвращает уникальный результат для заданных sql-запроса и параметров. Возвращает полученное значение колонки. При отсутствии подходящих значений или неуникальном результате возвращает ошибку RuntimeException.

cached — если true, то функция будет пытаться использовать закэшированные значения, чтобы не подключаться к базе данных
returnType — тип данных, который должна возвращать функция
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> List<T> selectValues(String sql, Object... params) Возвращает список результатов для заданных sql-запроса и параметров. Запрос должен возвращать единственную колонку. При отсутствии подходящих значений возвращает пустой список.

sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> List<T> selectValues(Class<T> returnType, String sql, Object... params) Возвращает список результатов для заданных sql-запроса и параметров. Запрос должен возвращать единственную колонку. При отсутствии подходящих значений возвращает пустой список.

returnType — требуемый тип данных для элементов, возвращаемых функцией
sql — строка, содержащая SELECT-запрос
params — массив, содержащий параметры SELECT-запроса
<T> T sqlGetObject(java.sql.ResultSet rs, String columnLabel, Class<T> returnType) Получает значение заданной записи из ResultSet.

rs — ResultSet с избранными значениями
columnLabel — имя колонки
returnType — тип значения, которое нужно вернуть
<T> T sqlGetObject(com.anylogic.engine.ResultSet rs, String columnLabel, Class<T> returnType) Получает значение заданной записи из ResultSet, «обернутого» встроенным средством AnyLogic.

rs — встроенная «обертка» AnyLogic для ResultSet с избранными значениями
columnLabel — имя колонки
returnType — тип значения, которое нужно вернуть
<T> T sqlGetObject(java.sql.ResultSet rs, int index, Class<T> returnType) Получает значение заданной записи из ResultSet.

rs — ResultSet с избранными значениями
index — индекс результата
returnType — тип значения, которое нужно вернуть
<T> T sqlGetObject(com.anylogic.engine.ResultSet rs, int index, Class<T> returnType) Получает значение заданной записи из ResultSet, «обернутого» встроенным средством AnyLogic.

rs — встроенная «обертка» AnyLogic для ResultSet с избранными значениями
index — индекс результата
returnType — тип значения, которое нужно вернуть
void sqlSetObject(java.sql.PreparedStatement st, int index, Object object) Задает указанное значение параметру с указанным индексом для заданного PreparedStatement.

st — PreparedStatement
index — индекс заданного параметра в запросе
object — значение параметра
int executeStatement(String sql, Object... params) Выполняет SQL-запрос INSERT, DELETE или UPDATE к базе данных AnyLogic, используя заданные строку запроса и параметры.
Возвращает число задействованных рядов таблицы базы данных.

sql — строка, содержащая SQL-запрос
params — массив, содержащий параметры запроса
void executeAction(String code, Object... argDescriptors) Выполняет кодовую команду, представленную типом данных String. Ничего не возвращает.

code — строка, содержащая код Java, который вы хотите выполнить. Код может включать параметры: их значения следует описать параметром argDescriptors
argDescriptors — массив параметров и их значений, представленный в следующем формате: параметр 1, значение параметра 1, параметр 2, значение параметра 2, …
<T> T executeExpression(String code, Object... argDescriptors) Выполняет кодовую команду, представленную типом данных String. Возвращает результат выполнения команды.

code — строка, содержащая код Java, который вы хотите выполнить. Код может включать параметры: их значения следует описать параметром argDescriptors
argDescriptors — массив параметров и их значений, представленный в следующем формате: параметр 1, значение параметра 1, параметр 2, значение параметра 2, …
<T> T executeExpression(Class<T> returnType, String code, Object... argDescriptors) Выполняет кодовую команду, представленную типом данных String. Возвращает результат выполнения команды; тип данных результата задается с помощью параметра returnType.

returnType — определяет тип данных, возвращаемый кодом. Может быть void.class, если результат выполнения команды сам является Java-выражением
code — строка, содержащая код Java, который вы хотите выполнить. Код может включать параметры: их значения следует описать параметром argDescriptors
argDescriptors — массив параметров и их значений, представленный в следующем формате: параметр 1, значение параметра 1, параметр 2, значение параметра 2, …
Как мы можем улучшить эту статью?