Интерфейс 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. Поток должен содержать количество символов, указанное параметром length, в противном случае при выполнении 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 в формат символов базы данных.

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

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

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

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

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

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

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

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

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

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