Интерфейс Statement

static final int CLOSE_CURRENT_RESULT

С версии:

1.4

См. также:

• Значения константных полей

static final int KEEP_CURRENT_RESULT

С версии:

1.4

См. также:

• Значения константных полей

static final int CLOSE_ALL_RESULTS

С версии:

1.4

См. также:

• Значения константных полей

static final int SUCCESS_NO_INFO

С версии:

1.4

См. также:

• Значения константных полей

static final int EXECUTE_FAILED

С версии:

1.4

См. также:

• Значения константных полей

static final int RETURN_GENERATED_KEYS

С версии:

1.4

См. также:

• Значения константных полей

static final int NO_GENERATED_KEYS

С версии:

1.4

См. также:

• Значения константных полей

ResultSet executeQuery(String sql) throws SQLException

Параметры:

sql — инструкция SQL для отправки в базу данных, обычно статическая инструкция SQL SELECT

Возвращает:

объект ResultSet, содержащий данные, полученные в результате указанного запроса; никогда не null

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, указанная инструкция SQL возвращает что-либо, кроме одного объекта ResultSet, либо метод вызван для PreparedStatement или CallableStatement

SQLTimeoutException — если драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял как минимум попытку отменить выполняющийся в данный момент Statement

int executeUpdate(String sql) throws SQLException

Параметры:

sql — инструкция языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо инструкция SQL, не возвращающая результатов, например инструкция DDL.

Возвращает:

либо (1) количество строк для инструкций языка манипулирования данными SQL (DML), либо (2) 0 для инструкций SQL, не возвращающих результатов

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, указанная инструкция SQL возвращает объект ResultSet либо метод вызван для PreparedStatement или CallableStatement

SQLTimeoutException — если драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял как минимум попытку отменить выполняющийся в данный момент Statement

void close() throws SQLException

Определено в:

close в интерфейсе AutoCloseable

Исключения:

SQLException — если произошла ошибка доступа к базе данных

int getMaxFieldSize() throws SQLException

Возвращает:

текущий предел размера столбцов, содержащих символьные и двоичные значения; ноль означает отсутствие ограничения

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• setMaxFieldSize(int)

void setMaxFieldSize(int max) throws SQLException

Параметры:

max — новый предел размера столбца в байтах; ноль означает отсутствие ограничения

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или не выполнено условие max >= 0

См. также:

• getMaxFieldSize()

int getMaxRows() throws SQLException

Возвращает:

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

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• setMaxRows(int)

void setMaxRows(int max) throws SQLException

Параметры:

max — новый предел количества строк; ноль означает отсутствие ограничения

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или не выполнено условие max >= 0

См. также:

• getMaxRows()

void setEscapeProcessing(boolean enable) throws SQLException

Параметры:

enable — true для включения обработки escape-последовательностей; false для ее отключения

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

int getQueryTimeout() throws SQLException

Возвращает:

текущее ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• setQueryTimeout(int)

void setQueryTimeout(int seconds) throws SQLException

Параметры:

seconds — новое ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или не выполнено условие seconds >= 0

См. также:

• getQueryTimeout()

void cancel() throws SQLException

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

SQLWarning getWarnings() throws SQLException

Возвращает:

первый объект SQLWarning или null, если предупреждений нет

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

void clearWarnings() throws SQLException

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

void setCursorName(String name) throws SQLException

Параметры:

name — новое имя курсора, которое должно быть уникальным в пределах одного соединения

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

boolean execute(String sql) throws SQLException

Параметры:

sql — любая инструкция SQL

Возвращает:

true, если первый результат — объект ResultSet; false, если это счетчик обновления или результатов нет

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement либо метод вызван для PreparedStatement или CallableStatement

SQLTimeoutException — если драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял как минимум попытку отменить выполняющийся в данный момент Statement

См. также:

• getResultSet()
• getUpdateCount()
• getMoreResults()

ResultSet getResultSet() throws SQLException

Возвращает:

текущий результат в виде объекта ResultSet или null, если результат является счетчиком обновления или больше нет результатов

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• execute(String)

int getUpdateCount() throws SQLException

Возвращает:

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

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• execute(String)

boolean getMoreResults() throws SQLException

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

Возвращает:

true, если следующий результат — объект ResultSet; false, если это счетчик обновления или больше нет результатов

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

См. также:

• execute(String)

void setFetchDirection(int direction) throws SQLException

Параметры:

direction — начальное направление обработки строк

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или указанное направление не является одним из следующих: ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN

С версии:

1.2

См. также:

• getFetchDirection()

int getFetchDirection() throws SQLException

Возвращает:

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

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

С версии:

1.2

См. также:

• setFetchDirection(int)

void setFetchSize(int rows) throws SQLException

Параметры:

rows — количество строк для извлечения

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или не выполнено условие rows >= 0.

С версии:

1.2

См. также:

• getFetchSize()

int getFetchSize() throws SQLException

Возвращает:

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

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

С версии:

1.2

См. также:

• setFetchSize(int)

int getResultSetConcurrency() throws SQLException

Возвращает:

либо ResultSet.CONCUR_READ_ONLY, либо ResultSet.CONCUR_UPDATABLE

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

С версии:

1.2

int getResultSetType() throws SQLException

Возвращает:

одно из значений ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

Исключения:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Statement

С версии:

1.2

void addBatch(String sql) throws SQLException

Параметры:

sql — обычно это инструкция SQL INSERT или UPDATE

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, драйвер не поддерживает пакетные обновления либо метод вызван для PreparedStatement или CallableStatement

С версии:

1.2

См. также:

• executeBatch()
• DatabaseMetaData.supportsBatchUpdates()

void clearBatch() throws SQLException

Исключения:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или драйвер не поддерживает пакетные обновления

С версии:

1.2

См. также:

• addBatch(String)
• DatabaseMetaData.supportsBatchUpdates()

int[] executeBatch() throws SQLException

Возвращает:

массив счётчиков обновления, содержащий по одному элементу для каждой команды в пакете. Элементы массива упорядочены в соответствии с порядком добавления команд в пакет.

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement или драйвер не поддерживает пакетные операторы. Выбрасывает BatchUpdateException (подкласс SQLException), если одна из отправленных в базу данных команд не выполнена должным образом или пытается вернуть набор результатов.

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.2

См. также:

• addBatch(String)
• DatabaseMetaData.supportsBatchUpdates()

Connection getConnection() throws SQLException

Возвращает:

соединение, создавшее этот оператор

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных или этот метод вызывается для закрытого Statement

Начиная с:

1.2

boolean getMoreResults(int current) throws SQLException

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

Параметры:

current — одна из следующих констант Statement, указывающих, что следует делать с текущими объектами ResultSet, полученными с помощью метода getResultSet: Statement.CLOSE_CURRENT_RESULT, Statement.KEEP_CURRENT_RESULT или Statement.CLOSE_ALL_RESULTS

Возвращает:

true, если следующий результат является объектом ResultSet; false, если это счётчик обновления или результатов больше нет

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement или переданный аргумент не является одним из следующих: Statement.CLOSE_CURRENT_RESULT, Statement.KEEP_CURRENT_RESULT или Statement.CLOSE_ALL_RESULTS

SQLFeatureNotSupportedException — если DatabaseMetaData.supportsMultipleOpenResults возвращает false, а в качестве аргумента передано Statement.KEEP_CURRENT_RESULT или Statement.CLOSE_ALL_RESULTS.

Начиная с:

1.4

См. также:

• execute(String)

ResultSet getGeneratedKeys() throws SQLException

Возвращает:

объект ResultSet, содержащий автоматически сгенерированные ключи, полученные при выполнении этого объекта Statement

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных или этот метод вызывается для закрытого Statement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

Начиная с:

1.4

int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException

Параметры:

sql — оператор языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо оператор SQL, который ничего не возвращает, например оператор DDL.

autoGeneratedKeys — флаг, указывающий, следует ли сделать автоматически сгенерированные ключи доступными для получения; одна из следующих констант: Statement.RETURN_GENERATED_KEYS Statement.NO_GENERATED_KEYS

Возвращает:

либо (1) количество строк для операторов языка манипулирования данными SQL (DML), либо (2) 0 для операторов SQL, которые ничего не возвращают

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, указанный оператор SQL возвращает объект ResultSet, указанная константа не входит в число допустимых, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод с константой Statement.RETURN_GENERATED_KEYS

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

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

Параметры:

sql — оператор языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо оператор SQL, который ничего не возвращает, например оператор DDL.

columnIndexes — массив индексов столбцов, указывающий столбцы, которые следует вернуть из вставленной строки

Возвращает:

либо (1) количество строк для операторов языка манипулирования данными SQL (DML), либо (2) 0 для операторов SQL, которые ничего не возвращают

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, оператор SQL возвращает объект ResultSet, второй аргумент, переданный этому методу, не является массивом int, элементы которого являются допустимыми индексами столбцов, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

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

Параметры:

sql — оператор языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо оператор SQL, который ничего не возвращает, например оператор DDL.

columnNames — массив имён столбцов, которые следует вернуть из вставленной строки

Возвращает:

либо количество строк для операторов INSERT, UPDATE или DELETE, либо 0 для операторов SQL, которые ничего не возвращают

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, оператор SQL возвращает объект ResultSet, второй аргумент, переданный этому методу, не является массивом String, элементы которого являются допустимыми именами столбцов, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

boolean execute(String sql, int autoGeneratedKeys) throws SQLException

Параметры:

sql — любой оператор SQL

autoGeneratedKeys — константа, указывающая, следует ли сделать автоматически сгенерированные ключи доступными для получения с помощью метода getGeneratedKeys; одна из следующих констант: Statement.RETURN_GENERATED_KEYS или Statement.NO_GENERATED_KEYS

Возвращает:

true, если первый результат является объектом ResultSet; false, если это счётчик обновления или результатов нет

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, второй параметр, переданный этому методу, не является Statement.RETURN_GENERATED_KEYS или Statement.NO_GENERATED_KEYS, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод с константой Statement.RETURN_GENERATED_KEYS

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

См. также:

• getResultSet()
• getUpdateCount()
• getMoreResults()
• getGeneratedKeys()

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

Параметры:

sql — любой оператор SQL

columnIndexes — массив индексов столбцов вставленной строки, значения которых следует сделать доступными для получения при вызове метода getGeneratedKeys

Возвращает:

true, если первый результат является объектом ResultSet; false, если это счётчик обновления или результатов нет

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, элементы массива int, переданного этому методу, не являются допустимыми индексами столбцов, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

См. также:

• getResultSet()
• getUpdateCount()
• getMoreResults()

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

Параметры:

sql — любой оператор SQL

columnNames — массив имён столбцов вставленной строки, значения которых следует сделать доступными для получения при вызове метода getGeneratedKeys

Возвращает:

true, если следующий результат является объектом ResultSet; false, если это счётчик обновления или результатов больше нет

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement, элементы массива String, переданного этому методу, не являются допустимыми именами столбцов, метод вызывается для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

SQLTimeoutException — когда драйвер определил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял хотя бы попытку отменить выполняющийся в данный момент Statement

Начиная с:

1.4

См. также:

• getResultSet()
• getUpdateCount()
• getMoreResults()
• getGeneratedKeys()

int getResultSetHoldability() throws SQLException

Возвращает:

либо ResultSet.HOLD_CURSORS_OVER_COMMIT, либо ResultSet.CLOSE_CURSORS_AT_COMMIT

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных или этот метод вызывается для закрытого Statement

Начиная с:

1.4

boolean isClosed() throws SQLException

Возвращает:

true, если этот объект Statement закрыт; false, если он всё ещё открыт

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных

Начиная с:

1.6

void setPoolable(boolean poolable) throws SQLException

Параметры:

poolable — если значение true, запрашивает помещение оператора в пул; если false — исключение оператора из пула

Выбрасывает:

SQLException — если этот метод вызывается для закрытого Statement

Начиная с:

1.6

boolean isPoolable() throws SQLException

Возвращает:

true, если Statement предназначен для помещения в пул; в противном случае — false

Выбрасывает:

SQLException — если этот метод вызывается для закрытого Statement

Начиная с:

1.6

См. также:

• setPoolable(boolean)

void closeOnCompletion() throws SQLException

Выбрасывает:

SQLException — если этот метод вызывается для закрытого Statement

Начиная с:

1.7

boolean isCloseOnCompletion() throws SQLException

Возвращает:

true, если объект Statement будет закрыт после закрытия всех зависимых от него наборов результатов; в противном случае — false

Выбрасывает:

SQLException — если этот метод вызывается для закрытого Statement

Начиная с:

1.7

default long getLargeUpdateCount() throws SQLException

Возвращает:

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

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных или этот метод вызывается для закрытого Statement

Начиная с:

1.8

См. также:

• execute(String)

default void setLargeMaxRows(long max) throws SQLException

Параметры:

max — новое ограничение на максимальное количество строк; ноль означает отсутствие ограничения

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных, этот метод вызывается для закрытого Statement или условие max >= 0 не выполнено

Начиная с:

1.8

См. также:

• getMaxRows()

default long getLargeMaxRows() throws SQLException

Возвращает:

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

Выбрасывает:

SQLException — если происходит ошибка доступа к базе данных или этот метод вызывается для закрытого Statement

Начиная с:

1.8

См. также:

• setMaxRows(int)

default long[] executeLargeBatch() throws SQLException

Возвращает:

массив счетчиков обновленных строк, содержащий по одному элементу для каждой команды в пакете. Элементы массива упорядочены в соответствии с порядком добавления команд в пакет.

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement или драйвер не поддерживает пакетные инструкции. Выбрасывает BatchUpdateException (подкласс SQLException), если одна из команд, отправленных в базу данных, не выполнена должным образом или пытается вернуть результирующий набор.

SQLTimeoutException — если драйвер установил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял по крайней мере попытку отменить выполняемый в данный момент Statement

Начиная с:

1.8

См. также:

• addBatch(String)
• DatabaseMetaData.supportsBatchUpdates()

default long executeLargeUpdate(String sql) throws SQLException

Параметры:

sql — инструкция языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо инструкция SQL, не возвращающая данных, например инструкция DDL.

Возвращает:

либо (1) количество строк для инструкций языка манипулирования данными SQL (DML), либо (2) 0 для инструкций SQL, не возвращающих данных

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, указанная инструкция SQL создает объект ResultSet, метод вызван для PreparedStatement или CallableStatement

SQLTimeoutException — если драйвер установил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял по крайней мере попытку отменить выполняемый в данный момент Statement

Начиная с:

1.8

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

Параметры:

sql — инструкция языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо инструкция SQL, не возвращающая данных, например инструкция DDL.

autoGeneratedKeys — флаг, указывающий, следует ли сделать автоматически сгенерированные ключи доступными для получения; одна из следующих констант: Statement.RETURN_GENERATED_KEYS Statement.NO_GENERATED_KEYS

Возвращает:

либо (1) количество строк для инструкций языка манипулирования данными SQL (DML), либо (2) 0 для инструкций SQL, не возвращающих данных

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, указанная инструкция SQL возвращает объект ResultSet, указанная константа не входит в число допустимых, метод вызван для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод с константой Statement.RETURN_GENERATED_KEYS

SQLTimeoutException — если драйвер установил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял по крайней мере попытку отменить выполняемый в данный момент Statement

Начиная с:

1.8

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

Параметры:

sql — инструкция языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо инструкция SQL, не возвращающая данных, например инструкция DDL.

columnIndexes — массив индексов столбцов, указывающий, какие столбцы следует вернуть из вставленной строки

Возвращает:

либо (1) количество строк для инструкций языка манипулирования данными SQL (DML), либо (2) 0 для инструкций SQL, не возвращающих данных

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, инструкция SQL возвращает объект ResultSet, второй аргумент, переданный этому методу, не является массивом int, элементы которого представляют допустимые индексы столбцов, либо метод вызван для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

SQLTimeoutException — если драйвер установил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял по крайней мере попытку отменить выполняемый в данный момент Statement

Начиная с:

1.8

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

Параметры:

sql — инструкция языка манипулирования данными SQL (DML), например INSERT, UPDATE или DELETE; либо инструкция SQL, не возвращающая данных, например инструкция DDL.

columnNames — массив имен столбцов, которые следует вернуть из вставленной строки

Возвращает:

либо количество строк для инструкций INSERT, UPDATE или DELETE, либо 0 для инструкций SQL, не возвращающих данных

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого Statement, инструкция SQL возвращает объект ResultSet, второй аргумент, переданный этому методу, не является массивом String, элементы которого представляют допустимые имена столбцов, либо метод вызван для PreparedStatement или CallableStatement

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

SQLTimeoutException — если драйвер установил, что превышено значение времени ожидания, заданное методом setQueryTimeout, и предпринял по крайней мере попытку отменить выполняемый в данный момент Statement

Начиная с:

1.8

default String enquoteLiteral(String val) throws SQLException

Требования к реализации:

Реализация по умолчанию создает литерал следующим образом: "'" + val.replace("'", "''") + "'".

Примечание по реализации:

Реализациям драйверов JDBC может потребоваться собственная реализация этого метода, чтобы соответствовать требованиям базового источника данных.

Параметры:

val — строка символов

Возвращает:

строку, заключенную в одинарные кавычки, в которой каждая одинарная кавычка заменена двумя одинарными кавычками

Выбрасывает:

NullPointerException — если val равен null

SQLException — если произошла ошибка доступа к базе данных

Начиная с:

9

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

Требования к реализации:

Реализация по умолчанию использует следующие критерии для определения допустимого простого идентификатора SQL:

• Строка не заключена в двойные кавычки
• Первый символ — буква от a ('\0061') до z ('\u007A') или от A ('\u0041') до Z ('\u005A')
• Имя содержит только буквенно-цифровые символы ([0-9A-Za-z]) или символ «_»

Реализация по умолчанию выбрасывает SQLException, если:

• DatabaseMetaData.getIdentifierQuoteString() не возвращает двойную кавычку
• identifier содержит символ null или двойную кавычку
• Длина identifier меньше 1 или больше 128 символов

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

идентификатор	alwaysDelimit	Результат
Hello	false	Hello
Hello	true	"Hello"
G'Day	false	"G'Day"
"Bruce Wayne"	false	"Bruce Wayne"
"Bruce Wayne"	true	"Bruce Wayne"
"select"	false	"select"
"select"	true	"select"
GoodDay$	false	"GoodDay$"
Hello"World	false	SQLException
"Hello"World"	false	SQLException

Примечание по реализации:

Реализациям драйверов JDBC может потребоваться собственная реализация этого метода, чтобы соответствовать требованиям базового источника данных.

Параметры:

identifier — идентификатор SQL

alwaysDelimit — указывает, следует ли возвращать простой идентификатор SQL как идентификатор с ограничителями

Возвращает:

простой идентификатор SQL или идентификатор с ограничителями

Выбрасывает:

SQLException — если идентификатор недопустим

SQLFeatureNotSupportedException — если источник данных не поддерживает идентификаторы с ограничителями

NullPointerException — если identifier равен null

Начиная с:

9

default boolean isSimpleIdentifier(String identifier) throws SQLException

Требования к реализации:

Реализация по умолчанию использует следующие критерии для определения допустимого простого идентификатора SQL:

• Идентификатор не заключен в двойные кавычки
• Первый символ — буква от a до z или от A до Z
• Идентификатор содержит только буквенно-цифровые символы ([0-9A-Za-z]) или символ «_»
• Идентификатор не является зарезервированным словом SQL
• Длина идентификатора составляет от 1 до 128 символов включительно

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

идентификатор	Простой идентификатор
Hello	true
G'Day	false
"Bruce Wayne"	false
GoodDay$	false
Hello"World	false
"Hello"World"	false
"select"	false
"from"	false

Примечание по реализации:

Реализациям драйверов JDBC может потребоваться собственная реализация этого метода, чтобы соответствовать требованиям базового источника данных.

Параметры:

identifier — идентификатор SQL

Возвращает:

true, если это простой идентификатор SQL; в противном случае false

Выбрасывает:

NullPointerException — если identifier равен null

SQLException — если произошла ошибка доступа к базе данных

Начиная с:

9

default String enquoteNCharLiteral(String val) throws SQLException

Требования к реализации:

Реализация по умолчанию создает литерал следующим образом: "N'" + val.replace("'", "''") + "'".

Примечание по реализации:

Реализациям драйверов JDBC может потребоваться собственная реализация этого метода, чтобы соответствовать требованиям базового источника данных. Реализация enquoteNCharLiteral может принимать набор символов, отличный от набора, принимаемого реализацией enquoteLiteral того же драйвера.

Параметры:

val — строка символов

Возвращает:

результат замены каждого символа одинарной кавычки в аргументе двумя символами одинарной кавычки, к которому затем добавлен префикс «N».

Выбрасывает:

NullPointerException — если val равен null

SQLException — если произошла ошибка доступа к базе данных

Начиная с:

9