Описание интерфейса

static final int CLOSE_CURRENT_RESULT

Константа, указывающая, что текущий объект ResultSet должен быть закрыт при вызове getMoreResults.

static final int KEEP_CURRENT_RESULT

Константа, указывающая, что текущий объект ResultSet не должен быть закрыт при вызове getMoreResults.

static final int CLOSE_ALL_RESULTS

Константа, указывающая, что все объекты ResultSet, которые ранее были открыты, должны быть закрыты при вызове getMoreResults.

static final int SUCCESS_NO_INFO

Константа, указывающая, что пакетное оператор успешно выполнился, но количество затронутых строк недоступно.

static final int EXECUTE_FAILED

Константа, указывающая, что при выполнении пакетного оператора произошла ошибка.

static final int RETURN_GENERATED_KEYS

Константа, указывающая, что сгенерированные ключи должны быть доступны для извлечения.

static final int NO_GENERATED_KEYS

Константа, указывающая, что сгенерированные ключи не должны быть доступны для извлечения.

ResultSet executeQuery(String sql) throws SQLException

Выполняет заданное SQL-оператор, возвращающее один объект ResultSet.

Примечание:Этот метод нельзя вызвать для PreparedStatement или CallableStatement.

int executeUpdate(String sql) throws SQLException

Выполняет заданный SQL-оператор, который может быть INSERT, UPDATE, или DELETE оператором или SQL-оператором, не возвращающим ничего, например, SQL-DDL-оператором.

Примечание:Этот метод нельзя вызвать для PreparedStatement или CallableStatement.

void close() throws SQLException

Освобождает ресурсы базы данных и JDBC объекта Statement немедленно вместо ожидания, пока это произойдет автоматически при закрытии. Обычно рекомендуется освобождать ресурсы сразу же после использования, чтобы избежать блокировки ресурсов базы данных.

Вызов метода close для объекта Statement, который уже закрыт, не имеет эффекта.

Примечание:При закрытии объекта Statement его текущий объект ResultSet, если он существует, также закрывается.

int getMaxFieldSize() throws SQLException

Возвращает максимальное количество байтов, которое может быть возвращено для значений символьных и двоичных столбцов в объекте ResultSet, созданном этим объектом Statement. Это ограничение применяется только к столбцам BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, NCHAR, NVARCHAR, LONGNVARCHAR и LONGVARCHAR. Если предел превышен, избыточные данные отбрасываются.

void setMaxFieldSize(int max) throws SQLException

Устанавливает ограничение для максимального количества байтов, которые могут быть возвращены для значений символьных и двоичных столбцов в объекте ResultSet, созданном этим объектом Statement. Это ограничение применяется только к полям BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, NCHAR, NVARCHAR, LONGNVARCHAR и LONGVARCHAR. Если предел превышен, избыточные данные отбрасываются. Для максимальной переносимости используйте значения, большие, чем 256.

int getMaxRows() throws SQLException

Возвращает максимальное количество строк, которое может содержать объект ResultSet, созданный этим объектом Statement. Если это ограничение превышено, избыточные строки отбрасываются.

void setMaxRows(int max) throws SQLException

Устанавливает ограничение для максимального количества строк, которое может содержать любой объект ResultSet, сгенерированный этим объектом Statement, на заданное значение. Если ограничение превышено, избыточные строки отбрасываются.

void setEscapeProcessing(boolean enable) throws SQLException

Устанавливает обработку экранирования включенной или выключенной. Если сканирование экранирования включено (по умолчанию), драйвер выполнит замену экранирования перед отправкой SQL-запроса в базу данных.

Свойство Connection и DataSource свойство escapeProcessing могут быть использованы для изменения поведения обработки экранирования по умолчанию. Значение true (по умолчанию) включает обработку экранирования для всех объектов Statement. Значение false отключает обработку экранирования для всех объектов Statement. Метод setEscapeProcessing может быть использован для указания поведения обработки экранирования для отдельного объекта Statement.

Примечание: так как подготовленные операторы обычно были проанализированы до вызова этого метода, отключение обработки экранирования для объектов PreparedStatements не повлияет на результат.

int getQueryTimeout() throws SQLException

Возвращает количество секунд, которое драйвер будет ждать выполнения объекта Statement. Если предел времени истечёт, будет брошено исключение SQLException.

void setQueryTimeout(int seconds) throws SQLException

Устанавливает количество секунд, которое драйвер будет ждать выполнения объекта Statement, заданное в секундах. По умолчанию нет ограничения на время, разрешенное для завершения выполняемого оператора. Если предел времени истекает, выбрасывается исключение SQLTimeoutException. Драйвер JDBC должен применить этот предел к методам execute, executeQuery и executeUpdate.

Примечание: Реализации драйверов JDBC также могут применять это ограничение к методам ResultSet (см. документацию вашего поставщика драйвера для получения подробностей).

Примечание: В случае пакетной обработки Statement, определено, применяется ли таймаут к отдельным SQL-командам, добавленным через метод addBatch, или ко всему пакету SQL-команд, вызванному методом executeBatch (см. документацию вашего поставщика драйвера для получения подробностей).

void cancel() throws SQLException

Отменяет этот объект Statement, если СУБД и драйвер поддерживают прерывание SQL-запроса. Этот метод может быть использован одним потоком для отмены запроса, который выполняется другим потоком.

SQLWarning getWarnings() throws SQLException

Возвращает первое предупреждение, сгенерированное вызовами для этого объекта Statement. Последующие предупреждения объекта Statement будут присоединены к этому объекту SQLWarning.

Цепочка предупреждений автоматически очищается каждый раз, когда оператор (пере)выполняется. Этот метод не может быть вызван для закрытого объекта Statement; в противном случае будет брошено исключение SQLException.

Примечание: Если вы обрабатываете объект ResultSet, любые предупреждения, связанные с чтением в этом объекте ResultSet, будут присоединены к нему, а не к объекту Statement, который его сгенерировал.

void clearWarnings() throws SQLException

Очищает все предупреждения, сгенерированные для этого объекта Statement. После вызова этого метода метод getWarnings вернёт null, пока новое предупреждение не будет сгенерировано для этого объекта Statement.

void setCursorName(String name) throws SQLException

Устанавливает имя SQL-курсора в указанное значение String, которое будет использоваться последующими методами объекта Statement объекта execute. Это имя может затем использоваться в операторах SQL для позиционного обновления или удаления для идентификации текущей строки в объекте ResultSet, сгенерированном этим оператором. Если база данных не поддерживает позиционное обновление/удаление, этот метод ничего не делает. Для обеспечения того, чтобы курсор имел правильный уровень изоляции для поддержки обновлений, оператор курсора должен иметь вид SELECT FOR UPDATE. Если FOR UPDATE отсутствует, позиционные обновления могут завершиться неудачей.

Примечание: По определению, выполнение позиционных обновлений и удалений должно выполняться другим объектом Statement, отличным от объекта, который сгенерировал объект ResultSet, используемый для позиционирования. Кроме того, имена курсоров должны быть уникальными в пределах соединения.

boolean execute(String sql) throws SQLException

Выполняет указанный SQL-запрос, который может возвращать несколько результатов. В некоторых (редких) случаях один SQL-запрос может возвращать несколько наборов результатов и/или значения обновлений. Обычно этим можно пренебречь, если вы не (1) выполняете хранимую процедуру, которая, как вы знаете, может возвращать несколько результатов, или (2) динамически выполняете неизвестную SQL-строку.

Метод execute выполняет SQL-запрос и указывает форму первого результата. Затем вы должны использовать методы getResultSet или getUpdateCount для получения результата и getMoreResults для перехода к последующим результатам.

Примечание: Этот метод не может быть вызван для объекта PreparedStatement или CallableStatement.

ResultSet getResultSet() throws SQLException

Возвращает текущий результат в виде объекта ResultSet. Этот метод следует вызывать только один раз на результат.

int getUpdateCount() throws SQLException

Возвращает текущий результат как количество обновлений; если результат — объект ResultSet или результатов больше нет, возвращается -1. Этот метод следует вызывать только один раз на результат.

boolean getMoreResults() throws SQLException

Переходит к следующему результату для этого объекта Statement, возвращает true, если это объект ResultSet, и неявно закрывает любые текущие объекты ResultSet, полученные с помощью метода getResultSet.

Результатов больше нет, когда верно следующее:

     // stmt is a Statement object
     ((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))
 

void setFetchDirection(int direction) throws SQLException

Даёт драйверу подсказку о направлении обработки строк в объектах ResultSet, созданных с использованием этого объекта Statement. Значение по умолчанию — ResultSet.FETCH_FORWARD.

Обратите внимание, что этот метод устанавливает направление извлечения по умолчанию для наборов результатов, сгенерированных этим объектом Statement. Каждый набор результатов имеет свои методы для получения и установки своего собственного направления извлечения.

int getFetchDirection() throws SQLException

Возвращает направление извлечения строк из таблиц базы данных, которое является значением по умолчанию для наборов результатов, сгенерированных из этого объекта Statement. Если этот объект Statement не задал направление извлечения, вызвав метод setFetchDirection, возвращаемое значение зависит от реализации.

void setFetchSize(int rows) throws SQLException

Даёт JDBC-драйверу подсказку о количестве строк, которые должны быть извлечены из базы данных, когда для объектов ResultSet, сгенерированных этим объектом Statement, требуется больше строк. Если заданное значение равно нулю, подсказка игнорируется. Значение по умолчанию — ноль.

int getFetchSize() throws SQLException

Возвращает количество строк набора результатов, которое является значением по умолчанию для размера извлечения объектов ResultSet, сгенерированных из этого объекта Statement. Если этот объект Statement не задал размер извлечения, вызвав метод setFetchSize, возвращаемое значение зависит от реализации.

int getResultSetConcurrency() throws SQLException

Возвращает конкуретность набора результатов для объектов ResultSet, сгенерированных этим объектом Statement.

int getResultSetType() throws SQLException

Возвращает тип набора результатов для объектов ResultSet, сгенерированных этим объектом Statement.

void addBatch(String sql) throws SQLException

Добавляет заданную SQL-команду в текущий список команд для этого объекта Statement. Команды в этом списке могут быть выполнены как пакет, вызвав метод executeBatch.

Примечание: Этот метод не может быть вызван для объекта PreparedStatement или CallableStatement.

void clearBatch() throws SQLException

Очищает текущий список SQL-команд этого объекта Statement.

int[] executeBatch() throws SQLException

Отправляет пакет команд в базу данных для выполнения и, если все команды выполняются успешно, возвращает массив счётов обновления. Элементы массива int возвращаемого массива упорядочены так, чтобы соответствовать командам в пакете, которые упорядочены в порядке добавления в пакет. Элементы в массиве, возвращаемом методом executeBatch, могут быть следующими:

1. Число, большее или равное нулю — указывает, что команда была обработана успешно и является счётом обновления, указывающим количество строк в базе данных, затронутых выполнением команды
2. Значение SUCCESS_NO_INFO — указывает, что команда была обработана успешно, но количество затронутых строк неизвестно

   Если одна из команд в пакете обновлений не выполняется должным образом, этот метод выбрасывает исключение BatchUpdateException, и JDBC-драйвер может или не может продолжить обработку оставшихся команд в пакете. Однако поведение драйвера должно соответствовать конкретной СУБД, либо всегда продолжать обработку команд, либо никогда не продолжать обработку команд. Если драйвер продолжает обработку после ошибки, массив, возвращаемый методом BatchUpdateException.getUpdateCounts, будет содержать столько элементов, сколько команд в пакете, и по крайней мере один из элементов будет следующим:

3. Значение EXECUTE_FAILED — указывает, что команда не была выполнена успешно и появляется только в том случае, если драйвер продолжает обработку команд после ошибки

Возможные реализации и возвращаемые значения были изменены в Java 2 SDK, Standard Edition, версии 1.3, чтобы учесть возможность продолжения обработки команд в пакетном обновлении после того, как был сброшен объект BatchUpdateException.

Connection getConnection() throws SQLException

Возвращает объект Connection, который произвёл этот объект Statement.

boolean getMoreResults(int current) throws SQLException

Переходит к следующему результату этого объекта Statement, обрабатывает любые текущие объекты ResultSet в соответствии с инструкциями, заданными данным флагом, и возвращает true, если следующий результат является объектом ResultSet.

Результатов больше нет, когда выполняется следующее условие:

     // stmt is a Statement object
     ((stmt.getMoreResults(current) == false) && (stmt.getUpdateCount() == -1))
 

ResultSet getGeneratedKeys() throws SQLException

Возвращает любые сгенерированные ключи, созданные в результате выполнения этого объекта Statement. Если этот объект Statement не сгенерировал ключей, возвращается пустой объект ResultSet.

Примечание: Если столбцы, представляющие сгенерированные ключи, не были указаны, реализация драйвера JDBC определит столбцы, которые лучше всего представляют сгенерированные ключи.

int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException

Выполняет данное SQL-утверждение и сигнализирует драйверу с помощью данного флага о том, должны ли сгенерированные ключи, созданные этим объектом Statement, быть доступны для получения. Драйвер проигнорирует флаг, если SQL-утверждение не является утверждением INSERT или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

Примечание: Этот метод не может быть вызван для объектов PreparedStatement или CallableStatement.

int executeUpdate(String sql, int[] columnIndexes) throws SQLException

Выполняет данное SQL-утверждение и сигнализирует драйверу, что сгенерированные ключи, указанные в данном массиве, должны быть доступны для получения. Этот массив содержит индексы столбцов в целевой таблице, содержащие сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является утверждением INSERT или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

Примечание: Этот метод не может быть вызван для объектов PreparedStatement или CallableStatement.

int executeUpdate(String sql, String[] columnNames) throws SQLException

Выполняет данное SQL-утверждение и сигнализирует драйверу, что сгенерированные ключи, указанные в данном массиве, должны быть доступны для получения. Этот массив содержит имена столбцов в целевой таблице, содержащие сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является утверждением INSERT или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

Примечание: Этот метод не может быть вызван для объектов PreparedStatement или CallableStatement.

boolean execute(String sql, int autoGeneratedKeys) throws SQLException

Выполняет заданное SQL-утверждение, которое может возвращать несколько результатов, и сигнализирует драйверу, что все сгенерированные ключи должны быть доступны для извлечения. Драйвер проигнорирует этот сигнал, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

В некоторых (редких) ситуациях одно SQL-утверждение может возвращать несколько наборов результатов и/или счетчики обновлений. Обычно этим можно пренебречь, если вы не (1) выполняете хранимую процедуру, которая, как вам известно, может возвращать несколько результатов, или (2) динамически выполняете неизвестную строку SQL.

Метод execute выполняет SQL-утверждение и указывает форму первого результата. Затем вы должны использовать методы getResultSet или getUpdateCount для извлечения результата и getMoreResults для перехода к любым последующим результатам.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

boolean execute(String sql, int[] columnIndexes) throws SQLException

Выполняет заданное SQL-утверждение, которое может возвращать несколько результатов, и сигнализирует драйверу, что сгенерированные ключи, указанные в заданном массиве, должны быть доступны для извлечения. Этот массив содержит индексы столбцов в целевой таблице, которые содержат сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

В некоторых (редких) ситуациях одно SQL-утверждение может возвращать несколько наборов результатов и/или счетчиков обновлений. Обычно этим можно пренебречь, если вы не (1) выполняете хранимую процедуру, которая, как вам известно, может возвращать несколько результатов, или (2) динамически выполняете неизвестную строку SQL.

Метод execute выполняет SQL-утверждение и указывает форму первого результата. Затем вы должны использовать методы getResultSet или getUpdateCount для извлечения результата и getMoreResults для перехода к любым последующим результатам.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

boolean execute(String sql, String[] columnNames) throws SQLException

Выполняет заданное SQL-утверждение, которое может возвращать несколько результатов, и сигнализирует драйверу, что сгенерированные ключи, указанные в заданном массиве, должны быть доступны для извлечения. Этот массив содержит имена столбцов в целевой таблице, которые содержат сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать сгенерированные ключи (список таких утверждений зависит от поставщика).

В некоторых (редких) ситуациях одно SQL-утверждение может возвращать несколько наборов результатов и/или счетчики обновлений. Обычно этим можно пренебречь, если вы не (1) выполняете хранимую процедуру, которая, как вам известно, может возвращать несколько результатов, или (2) динамически выполняете неизвестную строку SQL.

Метод execute выполняет SQL-утверждение и указывает форму первого результата. Затем вы должны использовать методы getResultSet или getUpdateCount для извлечения результата и getMoreResults для перехода к любым последующим результатам.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

int getResultSetHoldability() throws SQLException

Извлекает возможность удержания набора результатов для объектов ResultSet, сгенерированных этим объектом Statement.

boolean isClosed() throws SQLException

Извлекает, был ли закрыт этот объект Statement. Объект Statement закрыт, если на нем был вызван метод close, или если он закрыт автоматически.

void setPoolable(boolean poolable) throws SQLException

Запрашивает, должен ли Statement быть помещен в пул или нет. Указанное значение является подсказкой для реализации пула утверждений, указывающей, хочет ли приложение, чтобы утверждение было помещено в пул. Управление пулом утверждений решает, использовать ли подсказку.

Значение poolable утверждения применимо как к внутренним кэшам утверждений, реализованным драйвером, так и к внешним кэшам утверждений, реализованным серверами приложений и другими приложениями.

По умолчанию Statement не находится в пуле при создании, а PreparedStatement и CallableStatement находятся в пуле при создании.

boolean isPoolable() throws SQLException

Возвращает значение, указывающее, находится ли Statement в пуле или нет.

void closeOnCompletion() throws SQLException

Указывает, что этот Statement будет закрыт, когда все его зависимые наборы результатов будут закрыты. Если выполнение Statement не порождает наборы результатов, этот метод не оказывает никакого влияния.

Примечание: Несколько вызовов closeOnCompletion не переключают эффект на этот Statement. Однако вызов closeOnCompletion влияет как на последующее выполнение операторов, так и на операторы, которые в настоящее время имеют открытые зависимые наборы результатов.

boolean isCloseOnCompletion() throws SQLException

Возвращает значение, указывающее, будет ли этот Statement закрыт, когда все его зависимые наборы результатов будут закрыты.

default long getLargeUpdateCount() throws SQLException

Возвращает текущий результат как счётчик обновлений; если результат — объект ResultSet или больше результатов нет, возвращается -1. Этот метод следует вызывать только один раз на результат.

Этот метод следует использовать, когда возвращаемое количество строк может превышать Integer.MAX_VALUE.

Реализация по умолчанию бросит UnsupportedOperationException

default void setLargeMaxRows(long max) throws SQLException

Устанавливает предел максимального числа строк, которое может содержать любой объект ResultSet, сгенерированный этим объектом Statement, на указанное значение. Если предел превышен, лишние строки отбрасываются.

Этот метод следует использовать, когда предел строк может превысить Integer.MAX_VALUE.

Реализация по умолчанию бросит UnsupportedOperationException

default long getLargeMaxRows() throws SQLException

Возвращает максимальное количество строк, которое может содержать объект ResultSet, созданный этим объектом Statement. Если этот предел превышен, лишние строки отбрасываются.

Этот метод следует использовать, когда возвращаемый предел строк может превысить Integer.MAX_VALUE.

Реализация по умолчанию вернёт 0

default long[] executeLargeBatch() throws SQLException

Отправляет пакет команд в базу данных для выполнения и, если все команды выполняются успешно, возвращает массив счётчиков обновлений. Элементы массива, возвращаемого методом, упорядочены так, чтобы соответствовать командам в пакете, которые упорядочены по порядку добавления их в пакет. Элементы массива, возвращаемого методом executeLargeBatch, могут быть следующими:

1. Число, большее или равное нулю — указывает, что команда была обработана успешно, и является значением счётчика обновлений, показывающим количество строк в базе данных, затронутых выполнением команды
2. Значение SUCCESS_NO_INFO — указывает, что команда была обработана успешно, но количество затронутых строк неизвестно

   Если одна из команд в пакетном обновлении не выполняется должным образом, этот метод выбрасывает BatchUpdateException, и драйвер JDBC может или не может продолжить обработку оставшихся команд в пакете. Однако поведение драйвера должно быть согласовано с конкретной СУБД, либо всегда продолжать обработку команд, либо никогда не продолжать обработку команд. Если драйвер продолжает обработку после ошибки, массив, возвращаемый методом BatchUpdateException.getLargeUpdateCounts, будет содержать столько элементов, сколько команд в пакете, и по крайней мере один из элементов будет следующим:

3. Значение EXECUTE_FAILED — указывает, что команда не выполнена успешно и встречается только в том случае, если драйвер продолжает обработку команд после ошибки

Этот метод следует использовать, когда возвращаемое количество строк может превышать Integer.MAX_VALUE.

Реализация по умолчанию бросит UnsupportedOperationException

default long executeLargeUpdate(String sql) throws SQLException

Выполняет заданный SQL-запрос, который может быть оператором INSERT, UPDATE, или DELETE, или SQL-запросом, не возвращающим ничего, например, SQL-DDL-запросом.

Этот метод следует использовать, когда возвращаемое количество строк может превышать Integer.MAX_VALUE.

Примечание: Этот метод нельзя вызвать для PreparedStatement или CallableStatement.

Реализация по умолчанию бросит UnsupportedOperationException

default long executeLargeUpdate(String sql, int autoGeneratedKeys) throws SQLException

Выполняет заданное SQL-утверждение и сигнализирует драйверу с заданным флагом о том, должны ли автоматически сгенерированные ключи, произведённые этим Statement объектом, быть доступны для извлечения. Драйвер проигнорирует флаг, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать автоматически сгенерированные ключи (список таких утверждений зависит от поставщика).

Этот метод должен использоваться, когда количество возвращённых строк может превысить Integer.MAX_VALUE.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

default long executeLargeUpdate(String sql, int[] columnIndexes) throws SQLException

Выполняет заданное SQL-утверждение и сигнализирует драйверу о том, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для извлечения. Этот массив содержит индексы столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать автоматически сгенерированные ключи (список таких утверждений зависит от поставщика).

Этот метод должен использоваться, когда количество возвращённых строк может превысить Integer.MAX_VALUE.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

default long executeLargeUpdate(String sql, String[] columnNames) throws SQLException

Выполняет заданное SQL-утверждение и сигнализирует драйверу о том, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для извлечения. Этот массив содержит имена столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-утверждение не является INSERT утверждением или SQL-утверждением, способным возвращать автоматически сгенерированные ключи (список таких утверждений зависит от поставщика).

Этот метод должен использоваться, когда количество возвращённых строк может превысить Integer.MAX_VALUE.

Примечание: Этот метод нельзя вызывать на PreparedStatement или CallableStatement.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

default String enquoteLiteral(String val) throws SQLException

Возвращает String, заключённый в одинарные кавычки. Любое вхождение одиночной кавычки в строке будет заменено двумя одиночными кавычками.

Примеры преобразования:

Значение	Результат
Hello	'Hello'
G'Day	'G''Day'
'G''Day'	'''G''''Day'''
I'''M	'I''''''M'

default String enquoteIdentifier(String identifier, boolean alwaysQuote) throws SQLException

Возвращает идентификатор SQL. Если identifier — это простой идентификатор SQL:

• Возвращает исходное значение, если alwaysQuote равно false
• Возвращает разграниченный идентификатор, если alwaysQuote равно true

Если identifier не является простым идентификатором SQL, то identifier будет заключено в двойные кавычки, если это не сделано уже. Если источник данных не поддерживает двойные кавычки для разграниченных идентификаторов, идентификатор должен быть заключён в строку, возвращаемую из DatabaseMetaData.getIdentifierQuoteString(). Если источник данных не поддерживает разграниченные идентификаторы, должно быть выброшено исключение SQLFeatureNotSupportedException.

Будет выброшено исключение SQLException, если identifier содержит недопустимые символы для разграниченного идентификатора или длина идентификатора неверна для источника данных.

default boolean isSimpleIdentifier(String identifier) throws SQLException

Определяет, является ли identifier простым идентификатором SQL.

default String enquoteNCharLiteral(String val) throws SQLException

Возвращает строку String, представляющую строковый литерал National Character Set, заключённый в одинарные кавычки и с префиксом заглавной буквы N. Любой одиночный символ апострофа в строке будет заменён двумя одинарными апострофами.

Примеры преобразования:

Значение	Результат
Hello	N'Hello'
G'Day	N'G''Day'
'G''Day'	N'''G''''Day'''
I'''M	N'I''''''M'
N'Hello'	N'N''Hello'''