Интерфейс PreparedStatement

public interface PreparedStatement
extends Statement

Объект, представляющий предварительно скомпилированное SQL-предложение.

SQL-предложение предварительно компилируется и хранится в PreparedStatement объекте. Затем этот объект можно использовать для эффективного выполнения этого предложения несколько раз.

Примечание: Методы установки (setShort, setString, и так далее) для установки значений параметров IN должны указывать типы, совместимые с определенным SQL-типом входного параметра. Например, если параметр IN имеет SQL-тип INTEGER, тогда следует использовать метод setInt.

Если требуются произвольные преобразования типа параметров, следует использовать метод setObject с целевым SQL-типом.

В следующем примере установки параметра con представляет собой активное подключение:

PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                     SET SALARY = ? WHERE ID = ?");
   pstmt.setBigDecimal(1, 153833.00)
   pstmt.setInt(2, 110592)

Методы

executeQuery

ResultSet executeQuery()
                throws SQLException

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

Возвращает:

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

Исключения:

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

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

executeUpdate

int executeUpdate()
           throws SQLException

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

Возвращает:

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

Исключения:

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

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

setNull

void setNull(int parameterIndex,
             int sqlType)
      throws SQLException

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

sqlType - код типа SQL, определенный в java.sql.Types

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и JDBC-драйвер не поддерживает этот тип данных

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
         throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setByte

void setByte(int parameterIndex,
             byte x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setShort

void setShort(int parameterIndex,
              short x)
       throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setInt

void setInt(int parameterIndex,
            int x)
     throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setLong

void setLong(int parameterIndex,
             long x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setFloat

void setFloat(int parameterIndex,
              float x)
       throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setDouble

void setDouble(int parameterIndex,
               double x)
        throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal x)
            throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setString

void setString(int parameterIndex,
               String x)
        throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setBytes

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

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setDate

void setDate(int parameterIndex,
             Date x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setTime

void setTime(int parameterIndex,
             Time x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т.д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует параметру-заполнителю в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp x)
           throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - значение параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement

setAsciiStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - поток ввода Java, содержащий значение ASCII параметра.

length - количество байтов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement

setUnicodeStream

@Deprecated
void setUnicodeStream(int parameterIndex,
                                  InputStream x,
                                  int length)
                           throws SQLException

Устаревший. Используйте setCharacterStream

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - объект java.io.InputStream, содержащий значение параметра Unicode.

length - количество байтов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement

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

setBinaryStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - поток ввода java, содержащий двоичное значение параметра.

length - количество байтов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement

clearParameters

void clearParameters()
              throws SQLException

Исключения:

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

setObject

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

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - объект, содержащий входное значение параметра.

targetSqlType - тип SQL (как определено в java.sql.Types), который будет отправлен в базу данных.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement.

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType.

См. также:

Types

setObject

void setObject(int parameterIndex,
               Object x)
        throws SQLException

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

x - объект, содержащий входное значение параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого PreparedStatement или тип данного объекта неоднозначен.

execute

boolean execute()
         throws SQLException

Возвращает:

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

Исключения:

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

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

См. также:

Statement.execute(java.lang.String), Statement.getResultSet(), Statement.getUpdateCount(), Statement.getMoreResults()

addBatch

void addBatch()
       throws SQLException

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

Исключения:

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

С:

1.2

См. также:

Statement.addBatch(java.lang.String)

setCharacterStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2 и так далее.

reader - объект java.io.Reader, содержащий данные Unicode.

length - количество символов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement

С:

1.2

setRef

void setRef(int parameterIndex,
            Ref x)
     throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - значение SQL REF

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.2

setBlob

void setBlob(int parameterIndex,
             Blob x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - объект Blob, который отображает значение SQL BLOB

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.2

setClob

void setClob(int parameterIndex,
             Clob x)
      throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - объект Clob, который отображает значение SQL CLOB

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.2

setArray

void setArray(int parameterIndex,
              Array x)
       throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - объект Array, который отображает значение SQL ARRAY

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.2

getMetaData

ResultSetMetaData getMetaData()
                       throws SQLException

Возвращает:

описание столбцов объекта ResultSet или null, если драйвер не может вернуть объект ResultSetMetaData

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.2

setDate

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

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения даты

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

С:

1.2

setTime

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

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения времени

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

С:

1.2

setTimestamp

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

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения метки времени

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

С:

1.2

setNull

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

sqlType - значение из java.sql.Types

typeName - полное имя SQL пользовательского типа; игнорируется, если параметр не является типом пользовательского типа или REF

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

SQLFeatureNotSupportedException - если sqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных, или если драйвер JDBC не поддерживает этот метод

С:

1.2

setURL

void setURL(int parameterIndex,
            URL x)
     throws SQLException

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

Параметры:

parameterIndex - первый параметр равен 1, второй — 2, и так далее.

x - объект java.net.URL для установки

Исключения:

SQLException - если параметр parameterIndex не соответствует марке параметра в операторе SQL; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

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

С:

1.4

getParameterMetaData

ParameterMetaData getParameterMetaData()
                                throws SQLException

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

Возвращает:

объект ParameterMetaData, содержащий информацию о количестве, типах и свойствах для каждой метки параметра этого объекта PreparedStatement

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement

С:

1.4

См. также:

ParameterMetaData

setRowId

void setRowId(int parameterIndex,
              RowId x)
       throws SQLException

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

x - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement

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

С тех пор:

1.6

setNString

void setNString(int parameterIndex,
                String value)
         throws SQLException

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

value - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить ошибку преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement

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

С тех пор:

1.6

setNCharacterStream

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

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

value - значение параметра

length - количество символов в данных параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить ошибку преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement

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

С тех пор:

1.6

setNClob

void setNClob(int parameterIndex,
              NClob value)
       throws SQLException

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

value - значение параметра

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить ошибку преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement

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

С тех пор:

1.6

setClob

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

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

reader - Объект, содержащий данные для установки значения параметра.

length - количество символов в данных параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого PreparedStatement, или если указанная длина меньше нуля.

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

С тех пор:

1.6

setBlob

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

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

inputStream - Объект, содержащий данные для установки значения параметра.

length - количество байтов в данных параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого PreparedStatement; если указанная длина меньше нуля или количество байтов в потоке ввода не соответствует указанной длине.

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

С тех пор:

1.6

setNClob

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

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

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

reader - Объект, содержащий данные для установки значения параметра.

length - количество символов в данных параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить ошибку преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement

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

С тех пор:

1.6

setSQLXML

void setSQLXML(int parameterIndex,
               SQLXML xmlObject)
        throws SQLException

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2, и т. д.

xmlObject - объект SQLXML, отображающий значение SQL XML

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод был вызван для закрытого PreparedStatement или java.xml.transform.Result, Writer или OutputStream не был закрыт для объекта SQLXML

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

С тех пор:

1.6

setObject

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

x - объект, содержащий значение входного параметра.

targetSqlType - тип SQL (как определено в java.sql.Types), который должен быть отправлен в базу данных. Аргумент scale может дополнительно квалифицировать этот тип.

scaleOrLength - для java.sql.Types.DECIMAL или java.sql.Types.NUMERIC types, это количество цифр после запятой. Для типов Java Object InputStream и Reader, это длина данных в потоке или ридере. Для всех других типов это значение будет проигнорировано.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод вызван на закрытом PreparedStatement или если Java Object, указанный x, представляет собой объект InputStream или Reader, а значение параметра scale меньше нуля.

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType.

См. также:

Types

setAsciiStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

x - Java-поток ввода, содержащий значение ASCII-параметра.

length - количество байтов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

С момента:

1.6

setBinaryStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

x - java-поток ввода, содержащий двоичное значение параметра.

length - количество байтов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

С момента:

1.6

setCharacterStream

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

reader - объект java.io.Reader, содержащий данные Unicode.

length - количество символов в потоке.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

С момента:

1.6

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream x)
             throws SQLException

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

x - Java-поток ввода, содержащий значение ASCII-параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

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

С момента:

1.6

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream x)
              throws SQLException

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

x - java-поток ввода, содержащий двоичное значение параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

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

С момента:

1.6

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader reader)
                 throws SQLException

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и так далее.

reader - объект java.io.Reader, содержащий данные Unicode.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом PreparedStatement.

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

С момента:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader value)
                  throws SQLException

Параметры:

parameterIndex - первого параметра равен 1, второго - 2 и так далее.

value - значение параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных; или этот метод был вызван на закрытом PreparedStatement.

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

С момента:

1.6

setClob

void setClob(int parameterIndex,
             Reader reader)
      throws SQLException

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2 и так далее.

reader - Объект, содержащий данные для установки значения параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; этот метод был вызван на закрытом PreparedStatement, или если parameterIndex не соответствует марке параметра в SQL-запросе.

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

С момента:

1.6

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream)
      throws SQLException

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2 и т. д.

inputStream - Объект, содержащий данные для установки значения параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных; если метод вызван для закрытого PreparedStatement или если parameterIndex не соответствует марке параметра в SQL-запросе.

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

С тех пор:

1.6

setNClob

void setNClob(int parameterIndex,
              Reader reader)
       throws SQLException

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2 и т. д.

reader - Объект, содержащий данные для установки значения параметра.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого PreparedStatement.

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

С тех пор:

1.6

setObject

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т. д.

x - объект, содержащий значение входного параметра.

targetSqlType - тип SQL, который должен быть отправлен в базу данных. Параметр scale может дополнительно квалифицировать этот тип.

scaleOrLength - для java.sql.JDBCType.DECIMAL или java.sql.JDBCType.NUMERIC types, это число цифр после запятой. Для типов Java Object InputStream и Reader, это длина данных в потоке или читателе. Для всех других типов это значение будет проигнорировано.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement, или если Java-объект, указанный x, является объектом InputStream или Reader, и значение параметра scale меньше нуля.

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType.

С тех пор:

1.8

См. также:

JDBCType, SQLType

setObject

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

Параметры:

parameterIndex - первый параметр равен 1, второй - 2 и т. д.

x - объект, содержащий значение входного параметра.

targetSqlType - тип SQL, который должен быть отправлен в базу данных.

Исключения:

SQLException - если parameterIndex не соответствует марке параметра в SQL-запросе; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого PreparedStatement.

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType.

С тех пор:

1.8

См. также:

JDBCType, SQLType

executeLargeUpdate

default long executeLargeUpdate()
                         throws SQLException

Возвращает:

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

Исключения:

SQLException - если произошла ошибка доступа к базе данных; если метод вызван для закрытого PreparedStatement или SQL-запрос возвращает объект ResultSet.

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

С тех пор:

1.8