Интерфейс PreparedStatement

ResultSet executeQuery() throws SQLException

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

int executeUpdate() throws SQLException

Выполняет SQL-команду в этом PreparedStatement объекте, которая должна быть SQL-командой языка манипулирования данными (DML), например, INSERT, UPDATE или DELETE; или SQL-запрос, который ничего не возвращает, например, DDL-команда.

void setNull(int parameterIndex, int sqlType) throws SQLException

Устанавливает указанный параметр в SQL NULL.

Примечание: Вы должны указать тип SQL параметра.

void setBoolean(int parameterIndex, boolean x) throws SQLException

Устанавливает указанный параметр в заданное Java значение boolean. Драйвер преобразует его в SQL значение BIT или BOOLEAN при отправке в базу данных.

void setByte(int parameterIndex, byte x) throws SQLException

Устанавливает указанный параметр в заданное Java значение byte. Драйвер преобразует его в SQL значение TINYINT при отправке в базу данных.

void setShort(int parameterIndex, short x) throws SQLException

Устанавливает указанный параметр в заданное Java значение short. Драйвер преобразует его в SQL значение SMALLINT при отправке в базу данных.

void setInt(int parameterIndex, int x) throws SQLException

Устанавливает указанный параметр в заданное Java значение int. Драйвер преобразует его в SQL значение INTEGER при отправке в базу данных.

void setLong(int parameterIndex, long x) throws SQLException

Устанавливает указанный параметр в заданное Java значение long. Драйвер преобразует его в SQL значение BIGINT при отправке в базу данных.

void setFloat(int parameterIndex, float x) throws SQLException

Устанавливает указанный параметр в заданное Java значение float. Драйвер преобразует его в SQL значение REAL при отправке в базу данных.

void setDouble(int parameterIndex, double x) throws SQLException

Устанавливает указанный параметр в заданное Java значение double. Драйвер преобразует его в SQL значение DOUBLE при отправке в базу данных.

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

Устанавливает указанный параметр в заданное значение java.math.BigDecimal. Драйвер преобразует его в SQL значение NUMERIC при отправке в базу данных.

void setString(int parameterIndex, String x) throws SQLException

Устанавливает указанный параметр в заданное Java значение String. Драйвер преобразует его в SQL значение VARCHAR или LONGVARCHAR (в зависимости от размера аргумента по сравнению с ограничениями драйвера на значения VARCHAR) при отправке в базу данных.

void setBytes(int parameterIndex, byte[] x) throws SQLException

Устанавливает указанный параметр в заданный Java массив байтов. Драйвер преобразует его в SQL значение VARBINARY или LONGVARBINARY (в зависимости от размера аргумента по сравнению с ограничениями драйвера на значения VARBINARY) при отправке в базу данных.

void setDate(int parameterIndex, Date x) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Date используя по умолчанию часовой пояс виртуальной машины, на которой выполняется приложение. Драйвер преобразует его в SQL значение DATE при отправке в базу данных.

void setTime(int parameterIndex, Time x) throws SQLException

Устанавливает указанный параметр в заданное значение. Драйвер преобразует его в значение SQL при отправке в базу данных.

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

Устанавливает указанный параметр в заданное значение. Драйвер преобразует его в значение SQL при отправке в базу данных.

void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException

Устанавливает указанный параметр в заданный поток ввода, который будет иметь указанное количество байтов. При вводе очень большого значения ASCII в параметр LONGVARCHAR, может быть удобнее отправить его через java.io.InputStream. Данные будут читаться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимую конвертацию из ASCII в формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом Java потока или вашим собственным подклассом, реализующим стандартный интерфейс.

@Deprecated(since="1.2") void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException

Устанавливает указанный параметр в заданный поток ввода, который будет иметь указанное количество байтов. При вводе очень большого значения Unicode в параметр LONGVARCHAR, может быть удобнее отправить его через объект java.io.InputStream. Данные будут читаться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимую конвертацию из Unicode в формат символов базы данных. Формат байтов потока Unicode должен быть Java UTF-8, как определено в спецификации Java Virtual Machine.

Примечание: Этот объект потока может быть стандартным объектом Java потока или вашим собственным подклассом, реализующим стандартный интерфейс.

void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException

Устанавливает указанный параметр в заданный поток ввода, который будет иметь указанное количество байтов. При вводе очень большого двоичного значения в параметр LONGVARBINARY, может быть удобнее отправить его через объект java.io.InputStream. Данные будут читаться из потока по мере необходимости до достижения конца файла.

Примечание: Этот объект потока может быть стандартным объектом Java потока или вашим собственным подклассом, реализующим стандартный интерфейс.

void clearParameters() throws SQLException

Очищает текущие значения параметров немедленно.

В целом, значения параметров остаются в силе для повторного использования оператора. Установка значения параметра автоматически очищает его предыдущее значение. Однако в некоторых случаях полезно немедленно освободить ресурсы, используемые текущими значениями параметров; это можно сделать, вызвав метод clearParameters.

void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Этот метод аналогичен setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength), за исключением того, что предполагает масштаб ноль.

void setObject(int parameterIndex, Object x) throws SQLException

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

Спецификация JDBC определяет стандартное отображение типов Java Object к типам SQL. Переданный аргумент будет преобразован в соответствующий тип SQL перед отправкой в базу данных.

Обратите внимание, что этот метод может использоваться для передачи специфичных для базы данных абстрактных типов данных, используя специфичный для драйвера тип Java. Если объект является классом, реализующим интерфейс SQLData, JDBC-драйвер должен вызвать метод SQLData.writeSQL для записи его в поток данных SQL. Если, с другой стороны, объект является классом, реализующим Ref, Blob, Clob, NClob, Struct, java.net.URL, RowId, SQLXML или Array, драйвер должен передать его в базу данных в качестве значения соответствующего типа SQL.

Примечание: Не все базы данных позволяют отправлять нетипизированный Null в бэкенд. Для максимальной переносимости следует использовать метод setNull или метод setObject(int parameterIndex, Object x, int sqlType) вместо setObject(int parameterIndex, Object x).

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

boolean execute() throws SQLException

Выполняет SQL-запрос в этом объекте PreparedStatement, который может быть любым типом SQL-запроса. Некоторые подготовленные операторы возвращают несколько результатов; метод execute обрабатывает такие сложные запросы, а также более простые формы запросов, обрабатываемые методами executeQuery и executeUpdate.

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

void addBatch() throws SQLException

Добавляет набор параметров в пакет команд этого объекта PreparedStatement.

void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException

Устанавливает указанный параметр в заданный объект Reader, длина которого составляет заданное количество символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более практичным отправить его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимую конвертацию из UNICODE в формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом Java-потока или вашим собственным подклассом, реализующим стандартный интерфейс.

void setRef(int parameterIndex, Ref x) throws SQLException

Устанавливает указанный параметр в заданное значение REF(<structured-type>). Драйвер преобразует его в значение SQL REF при отправке в базу данных.

void setBlob(int parameterIndex, Blob x) throws SQLException

Устанавливает указанный параметр в заданный объект java.sql.Blob. Драйвер преобразует его в значение SQL BLOB при отправке в базу данных.

void setClob(int parameterIndex, Clob x) throws SQLException

Устанавливает указанный параметр в заданный объект java.sql.Clob. Драйвер преобразует его в значение SQL CLOB при отправке в базу данных.

void setArray(int parameterIndex, Array x) throws SQLException

Устанавливает указанный параметр в заданный объект java.sql.Array. Драйвер преобразует его в значение SQL ARRAY при отправке в базу данных.

ResultSetMetaData getMetaData() throws SQLException

Возвращает объект ResultSetMetaData, содержащий информацию о столбцах объекта ResultSet, который будет возвращён при выполнении этого объекта PreparedStatement.

Поскольку объект PreparedStatement предварительно скомпилирован, можно получить информацию об объекте ResultSet, который он вернёт, не выполняя его. Следовательно, можно вызвать метод getMetaData на объекте PreparedStatement вместо ожидания его выполнения и вызова метода ResultSet.getMetaData на возвращённом объекте ResultSet.

ПРИМЕЧАНИЕ: Использование этого метода может быть дорогостоящим для некоторых драйверов из-за отсутствия поддержки в подлежащей СУБД.

void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Date, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL DATE, которое затем отправляется в базу данных. С объектом Calendar, драйвер может вычислить дату, учитывая пользовательскую часовую зону. Если объект Calendar не указан, драйвер использует по умолчанию часовую зону виртуальной машины, на которой выполняется приложение.

void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Time, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIME, которое затем отправляется в базу данных. С объектом Calendar, драйвер может вычислить время, учитывая пользовательскую часовую зону. Если объект Calendar не указан, драйвер использует по умолчанию часовую зону виртуальной машины, на которой выполняется приложение.

void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Timestamp, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIMESTAMP, которое затем отправляется в базу данных. С объектом Calendar, драйвер может вычислить метку времени, учитывая пользовательскую часовую зону. Если объект Calendar не указан, драйвер использует по умолчанию часовую зону виртуальной машины, на которой выполняется приложение.

void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException

Устанавливает указанный параметр в значение SQL NULL. Этот вариант метода setNull следует использовать для параметров пользовательских типов и типов REF. Примеры пользовательских типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные массивы.

Примечание: Для обеспечения переносимости приложения должны указать код SQL-типа и полное квалифицированное имя SQL-типа при указании параметра NULL пользовательского или REF типа. В случае пользовательского типа имя — это имя типа самого параметра. Для параметра REF имя — это имя типа, на который ссылается параметр. Если драйвер JDBC не нуждается в коде типа или информации об имени типа, он может его игнорировать. Хотя этот метод предназначен для параметров пользовательского и REF типа, его можно использовать для установки параметра NULL любого типа JDBC. Если параметр не имеет пользовательского или REF типа, указанное имя типа игнорируется.

void setURL(int parameterIndex, URL x) throws SQLException

Устанавливает указанный параметр в заданное значение java.net.URL. Драйвер преобразует его в значение SQL DATALINK при отправке в базу данных.

ParameterMetaData getParameterMetaData() throws SQLException

Возвращает количество, типы и свойства параметров этого объекта PreparedStatement.

void setRowId(int parameterIndex, RowId x) throws SQLException

Устанавливает указанный параметр в заданный объект java.sql.RowId. Драйвер преобразует его в значение SQL ROWID при отправке в базу данных.

void setNString(int parameterIndex, String value) throws SQLException

Устанавливает указанный параметр в заданный объект String. Драйвер преобразует его в значение SQL NCHAR или NVARCHAR или LONGNVARCHAR (в зависимости от размера аргумента по отношению к пределам драйвера для NVARCHAR значений) при отправке в базу данных.

void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

Устанавливает указанный параметр в объект Reader. Поток Reader считывает данные до конца файла. Драйвер выполняет необходимое преобразование из формата Java символов в национальный набор символов базы данных.

void setNClob(int parameterIndex, NClob value) throws SQLException

Устанавливает указанный параметр в объект java.sql.NClob. Драйвер преобразует его в значение SQL NCLOB при отправке в базу данных.

void setClob(int parameterIndex, Reader reader, long length) throws SQLException

Устанавливает указанный параметр в объект Reader. Чтец должен содержать количество символов, указанное в length, иначе при выполнении SQLException будет сгенерирована ошибка. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как CLOB. Когда используется метод setCharacterStream, драйвер может выполнить дополнительные действия, чтобы определить, должны ли данные параметра быть отправлены на сервер как LONGVARCHAR или как CLOB.

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

Устанавливает указанный параметр в объект InputStream. Поток Inputstream должен содержать количество байтов, указанное в length, иначе при выполнении SQLException будет сгенерирована ошибка. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. Когда используется метод setBinaryStream, драйвер может выполнить дополнительные действия, чтобы определить, должны ли данные параметра быть отправлены на сервер как LONGVARBINARY или как BLOB.

void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

Устанавливает указанный параметр в объект Reader. Чтец должен содержать количество символов, указанное длиной, в противном случае при выполнении PreparedStatement будет сгенерировано SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int), потому что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как NCLOB. Когда используется метод setCharacterStream, драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB.

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

Устанавливает указанный параметр в данный объект java.sql.SQLXML. Драйвер преобразует это в значение SQL XML при отправке его в базу данных.

void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Если второй аргумент является InputStream, то поток должен содержать количество байтов, заданное scaleOrLength. Если второй аргумент является Reader, то чтец должен содержать количество символов, заданное scaleOrLength. Если эти условия не выполняются, драйвер сгенерирует SQLException при выполнении подготовленного запроса.

Данный Java-объект будет преобразован в заданный targetSqlType перед отправкой в базу данных. Если у объекта есть пользовательское отображение (он является классом, реализующим интерфейс SQLData), JDBC-драйвер должен вызвать метод SQLData.writeSQL для записи его в поток данных SQL. Если, с другой стороны, объект является классом, реализующим Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего SQL-типа.

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

void setAsciiStream(int parameterIndex, InputStream x, long length) throws SQLException

Устанавливает указанный параметр в заданный поток ввода, который будет иметь указанное количество байтов. При вводе очень большого ASCII-значения в параметр LONGVARCHAR, может быть удобнее отправить его через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. JDBC-драйвер выполнит необходимое преобразование из ASCII в формат символов базы данных.

void setBinaryStream(int parameterIndex, InputStream x, long length) throws SQLException

Устанавливает указанный параметр в заданный поток ввода, который будет иметь указанное количество байтов. При вводе очень большого двоичного значения в параметр LONGVARBINARY, может быть удобнее отправить его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLException

Устанавливает указанный параметр в заданный объект Reader, длина которого равна заданному количеству символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может быть удобнее отправить его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. JDBC-драйвер выполнит необходимое преобразование из UNICODE в формат символов базы данных.

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

Устанавливает указанный параметр в заданный поток ввода. При вводе очень большого ASCII-значения в параметр LONGVARCHAR, может быть удобнее отправить его через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. JDBC-драйвер выполнит необходимое преобразование из ASCII в формат символов базы данных.

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

Устанавливает указанный параметр в заданный поток ввода. При вводе очень большого двоичного значения в параметр, может быть более целесообразно передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

Примечание: Этот объект потока может быть стандартным объектом потока Java или вашим собственным подклассом, реализующим стандартный интерфейс.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setBinaryStream, принимающей параметр длины, быть более эффективным.

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

Устанавливает указанный параметр в заданный объект Reader. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно передать его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимую конвертацию из UNICODE в формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом потока Java или вашим собственным подклассом, реализующим стандартный интерфейс.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setCharacterStream, принимающей параметр длины, быть более эффективным.

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

Устанавливает указанный параметр в объект Reader. Reader считывает данные до достижения конца файла. Драйвер выполняет необходимую конвертацию из формата символов Java в национальный формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом потока Java или вашим собственным подклассом, реализующим стандартный интерфейс.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setNCharacterStream, принимающей параметр длины, быть более эффективным.

void setClob(int parameterIndex, Reader reader) throws SQLException

Устанавливает указанный параметр в объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как CLOB. Когда используется метод setCharacterStream, драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARCHAR или CLOB

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setClob, принимающей параметр длины, быть более эффективным.

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

Устанавливает указанный параметр в объект InputStream. Этот метод отличается от метода setBinaryStream (int, InputStream) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. Когда используется метод setBinaryStream, драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setBlob, принимающей параметр длины, быть более эффективным.

void setNClob(int parameterIndex, Reader reader) throws SQLException

Устанавливает указанный параметр в объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как NCLOB. Когда используется метод setCharacterStream, драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setNClob, принимающей параметр длины, быть более эффективным.

default void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Если второй аргумент является InputStream, то поток должен содержать количество байтов, указанное параметром scaleOrLength. Если второй аргумент является Reader, то читатель должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не выполняются, драйвер сгенерирует SQLException при выполнении подготовленного запроса.

Указанный Java-объект будет преобразован в указанный targetSqlType перед отправкой в базу данных. Если объект имеет пользовательское отображение (является объектом класса, реализующего интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL для записи его в SQL-поток данных. Если, с другой стороны, объект является классом, реализующим Ref, Blob, Clob, NClob, Struct, java.net.URL, или Array, драйвер должен передать его в базу данных в качестве значения соответствующего SQL-типа.

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

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

default void setObject(int parameterIndex, Object x, SQLType targetSqlType) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Этот метод похож на setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength), за исключением того, что он предполагает масштаб ноль.

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

default long executeLargeUpdate() throws SQLException

Выполняет оператор SQL в этом PreparedStatement объекте, который должен быть оператором языка обработки данных SQL (DML), например, INSERT, UPDATE или DELETE; или оператор SQL, который ничего не возвращает, например, оператор DDL.

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

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