PreparedStatement (Платформа Java SE 8 b92)

Все Суперинтерфейсы:

AutoCloseable, Оператор, Обертка

Все Известные Подынтерфейсы:

CallableStatement
```
public interface PreparedStatement
extends Statement
```
Объект, который представляет предварительно скомпилированный SQL-оператор.
SQL-оператор предварительно компилируется и сохранен в a PreparedStatement объект. Этот объект может тогда использоваться, чтобы эффективно выполнить этот оператор многократно.
Отметьте: методы метода set (setShort, setString, и так далее) для того, чтобы установить В значениях параметра должен определить типы, которые являются совместимыми с определенным типом SQL входного параметра. Например, если В параметре имеет тип 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)
 
```
См. Также:

Connection.prepareStatement(java.lang.String), ResultSet

Полевая Сводка
- Поля, наследованные от интерфейса java.sql. Оператор
  CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

Сводка метода

Все Методы Методы экземпляра Абстрактные Методы Методы значения по умолчанию Устаревшие Методы
Модификатор и Тип	Метод и Описание
`void`	`addBatch()` Добавляет ряд параметров к этому `PreparedStatement` пакет объекта команд.
`void`	`clearParameters()` сразу очищает текущие значения параметра.
`boolean`	`execute()` Выполняет SQL-оператор в этом `PreparedStatement` объект, который может быть любым видом SQL-оператора.
`default long`	`executeLargeUpdate()` Выполняет SQL-оператор в этом `PreparedStatement` объект, который должен быть Языком манипулирования данными SQL (DML) оператор, такой как `INSERT`, `UPDATE` или `DELETE`; или SQL-оператор, который ничего не возвращает, такого как оператор DDL.
`ResultSet`	`executeQuery()` Выполняет SQL-запрос в этом `PreparedStatement` возразите и возвращается `ResultSet` объект сгенерирован запросом.
`int`	`executeUpdate()` Выполняет SQL-оператор в этом `PreparedStatement` объект, который должен быть Языком манипулирования данными SQL (DML) оператор, такой как `INSERT`, `UPDATE` или `DELETE`; или SQL-оператор, который ничего не возвращает, такого как оператор DDL.
`ResultSetMetaData`	`getMetaData()` Получает a `ResultSetMetaData` объект, который содержит информацию о столбцах `ResultSet` объект, который будет возвращен когда это `PreparedStatement` объект выполняется.
`ParameterMetaData`	`getParameterMetaData()` Получает число, типы и свойства этого `PreparedStatement` параметры объекта.
`void`	`setArray(int parameterIndex, Array x)` Устанавливает определяемые параметры к данному `java.sql.Array` объект.
`void`	`setAsciiStream(int parameterIndex, InputStream x)` Устанавливает определяемые параметры к данному входному потоку.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)` Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
`void`	`setAsciiStream(int parameterIndex, InputStream x, long length)` Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)` Устанавливает определяемые параметры к данному `java.math.BigDecimal` значение.
`void`	`setBinaryStream(int parameterIndex, InputStream x)` Устанавливает определяемые параметры к данному входному потоку.
`void`	`setBinaryStream(int parameterIndex, InputStream x, int length)` Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
`void`	`setBinaryStream(int parameterIndex, InputStream x, long length)` Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
`void`	`setBlob(int parameterIndex, Blob x)` Устанавливает определяемые параметры к данному `java.sql.Blob` объект.
`void`	`setBlob(int parameterIndex, InputStream inputStream)` Устанавливает определяемые параметры к a `InputStream` объект.
`void`	`setBlob(int parameterIndex, InputStream inputStream, long length)` Устанавливает определяемые параметры к a `InputStream` объект.
`void`	`setBoolean(int parameterIndex, boolean x)` Устанавливает определяемые параметры к данному Java `boolean` значение.
`void`	`setByte(int parameterIndex, byte x)` Устанавливает определяемые параметры к данному Java `byte` значение.
`void`	`setBytes(int parameterIndex, byte[] x)` Устанавливает определяемые параметры данному массиву Java байтов.
`void`	`setCharacterStream(int parameterIndex, Reader reader)` Устанавливает определяемые параметры к данному `Reader` объект.
`void`	`setCharacterStream(int parameterIndex, Reader reader, int length)` Устанавливает определяемые параметры к данному `Reader` объект, который является данным числом символов долго.
`void`	`setCharacterStream(int parameterIndex, Reader reader, long length)` Устанавливает определяемые параметры к данному `Reader` объект, который является данным числом символов долго.
`void`	`setClob(int parameterIndex, Clob x)` Устанавливает определяемые параметры к данному `java.sql.Clob` объект.
`void`	`setClob(int parameterIndex, Reader reader)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setClob(int parameterIndex, Reader reader, long length)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setDate(int parameterIndex, Date x)` Устанавливает определяемые параметры к данному `java.sql.Date` значение используя часовой пояс значения по умолчанию виртуальной машины, которая запускает приложение.
`void`	`setDate(int parameterIndex, Date x, Calendar cal)` Устанавливает определяемые параметры к данному `java.sql.Date` значение, используя данный `Calendar` объект.
`void`	`setDouble(int parameterIndex, double x)` Устанавливает определяемые параметры к данному Java `double` значение.
`void`	`setFloat(int parameterIndex, float x)` Устанавливает определяемые параметры к данному Java `float` значение.
`void`	`setInt(int parameterIndex, int x)` Устанавливает определяемые параметры к данному Java `int` значение.
`void`	`setLong(int parameterIndex, long x)` Устанавливает определяемые параметры к данному Java `long` значение.
`void`	`setNCharacterStream(int parameterIndex, Reader value)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setNCharacterStream(int parameterIndex, Reader value, long length)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setNClob(int parameterIndex, NClob value)` Устанавливает определяемые параметры к a `java.sql.NClob` объект.
`void`	`setNClob(int parameterIndex, Reader reader)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setNClob(int parameterIndex, Reader reader, long length)` Устанавливает определяемые параметры к a `Reader` объект.
`void`	`setNString(int parameterIndex, String value)` Устанавливает определяемые параметры к данному `String` объект.
`void`	`setNull(int parameterIndex, int sqlType)` Устанавливает определяемые параметры к SQL `NULL`.
`void`	`setNull(int parameterIndex, int sqlType, String typeName)` Устанавливает определяемые параметры к SQL `NULL`.
`void`	`setObject(int parameterIndex, Object x)` Устанавливает значение определяемого параметра, используя данный объект.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType)` Устанавливает значение определяемого параметра с данным объектом.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)` Устанавливает значение определяемого параметра с данным объектом.
`default void`	`setObject(int parameterIndex, Object x, SQLType targetSqlType)` Устанавливает значение определяемого параметра с данным объектом.
`default void`	`setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength)` Устанавливает значение определяемого параметра с данным объектом.
`void`	`setRef(int parameterIndex, Ref x)` Устанавливает определяемые параметры к данному `REF(<structured-type>)` значение.
`void`	`setRowId(int parameterIndex, RowId x)` Устанавливает определяемые параметры к данному `java.sql.RowId` объект.
`void`	`setShort(int parameterIndex, short x)` Устанавливает определяемые параметры к данному Java `short` значение.
`void`	`setSQLXML(int parameterIndex, SQLXML xmlObject)` Устанавливает определяемые параметры к данному `java.sql.SQLXML` объект.
`void`	`setString(int parameterIndex, String x)` Устанавливает определяемые параметры к данному Java `String` значение.
`void`	`setTime(int parameterIndex, Time x)` Устанавливает определяемые параметры к данному `java.sql.Time` значение.
`void`	`setTime(int parameterIndex, Time x, Calendar cal)` Устанавливает определяемые параметры к данному `java.sql.Time` значение, используя данный `Calendar` объект.
`void`	`setTimestamp(int parameterIndex, Timestamp x)` Устанавливает определяемые параметры к данному `java.sql.Timestamp` значение.
`void`	`setTimestamp(int parameterIndex, Timestamp x, Calendar cal)` Устанавливает определяемые параметры к данному `java.sql.Timestamp` значение, используя данный `Calendar` объект.
`void`	`setUnicodeStream(int parameterIndex, InputStream x, int length)` Осуждаемый. Использовать `setCharacterStream`
`void`	`setURL(int parameterIndex, URL x)` Устанавливает определяемые параметры к данному `java.net.URL` значение.

Методы, наследованные от интерфейса java.sql. Оператор
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Методы, наследованные от интерфейса java.sql. Обертка
isWrapperFor, unwrap

- Деталь метода
  - executeQuery
```
ResultSet executeQuery()
                throws SQLException
```
    Выполняет SQL-запрос в этом PreparedStatement возразите и возвращается ResultSet объект сгенерирован запросом.
    
    Возвраты:
    
    a ResultSet объект, который содержит данные, произведенные запросом; никогда null
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или SQL-оператор не возвращает a ResultSet объект
    
    SQLTimeoutException - когда драйвер решил, что значение тайм-аута, которое было определено setQueryTimeout метод был превышен и по крайней мере попытался отменить в настоящий момент рабочее Statement
  - executeUpdate
```
int executeUpdate()
           throws SQLException
```
    Выполняет SQL-оператор в этом PreparedStatement объект, который должен быть Языком манипулирования данными SQL (DML) оператор, такой как INSERT, UPDATE или DELETE; или SQL-оператор, который ничего не возвращает, такого как оператор DDL.
    
    Возвраты:
    
    или (1) счет строки для Языка манипулирования данными SQL (DML) операторы или (2) 0 для SQL-операторов, которые ничего не возвращают
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или SQL-оператор возвращает a ResultSet объект
    
    SQLTimeoutException - когда драйвер решил, что значение тайм-аута, которое было определено setQueryTimeout метод был превышен и по крайней мере попытался отменить в настоящий момент рабочее Statement
  - setNull
```
void setNull(int parameterIndex,
             int sqlType)
      throws SQLException
```
    Устанавливает определяемые параметры к SQL NULL.
    Отметьте: следует определить тип SQL параметра.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    sqlType - код типа SQL, определенный в java.sql.Types
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если sqlType a 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
```
    Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов. Когда очень большое значение ASCII вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток Java, который содержит значение параметра ASCII
    
    length - число байтов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
  - setUnicodeStream
```
@Deprecated
void setUnicodeStream(int parameterIndex,
                                  InputStream x,
                                  int length)
                           throws SQLException
```
    Осуждаемый. Использовать setCharacterStream
    
    Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов. Когда очень большое значение Unicode вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от Unicode до формата случайной работы базы данных. Формат байта потока Unicode должен быть Java UTF-8, как определено в Спецификации виртуальной машины Java.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - a java.io.InputStream объект, который содержит значение параметра Unicode
    
    length - число байтов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
  - setBinaryStream
```
void setBinaryStream(int parameterIndex,
                     InputStream x,
                     int length)
              throws SQLException
```
    Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов. Когда очень большое двоичное значение вводится к a LONGVARBINARY параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток java, который содержит двоичное значение параметра
    
    length - число байтов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
  - clearParameters
```
void clearParameters()
              throws SQLException
```
    сразу очищает текущие значения параметра.
    Вообще, значения параметра остаются в силе для повторного использования оператора. Установка значения параметра автоматически очищает свое предыдущее значение. Однако, в некоторых случаях полезно сразу высвободить средства, используемые текущими значениями параметра; это может быть сделано, вызывая метод clearParameters.
    
    Броски:
    
    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. Типы), чтобы быть отправленным базе данных
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    См. Также:
    
    Types
  - setObject
```
void setObject(int parameterIndex,
               Object x)
        throws SQLException
```
    Устанавливает значение определяемого параметра, используя данный объект.
    Спецификация JDBC определяет стандартное отображение от Java Object типы к типам SQL. Данный параметр будет преобразован в соответствующий тип SQL прежде, чем быть отправленным базе данных.
    Отметьте, что этот метод может использоваться, чтобы передать datatabase-определенные абстрактные типы данных, при использовании специфичного для драйвера типа Java. Если объект имеет class, реализовывая интерфейс SQLData, драйвер JDBC должен вызвать метод SQLData.writeSQL записать это в поток данных SQL. Если с другой стороны объект имеет реализацию class Ref, Blob, Clob, NClob, Struct, java.net.URL, RowId, SQLXML или Array, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
    Отметьте: Не все базы данных учитывают невведенный Нуль, который будет отправлен бэкэнду. Для максимальной мобильности, setNull или setObject(int parameterIndex, Object x, int sqlType) метод должен использоваться вместо setObject(int parameterIndex, Object x).
    Отметьте: Этот метод выдает исключение, если есть неоднозначность, например, если объект имеет class, реализовывая больше чем один из ранее названных интерфейсов.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - объект, содержащий входное значение параметра
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или тип данного объекта неоднозначен
  - выполниться
```
boolean execute()
         throws SQLException
```
    Выполняет SQL-оператор в этом PreparedStatement объект, который может быть любым видом SQL-оператора. Некоторые готовые операторы возвращают многократные результаты; execute метод обрабатывает эти сложные операторы так же как более простую форму операторов, обработанных методами executeQuery и executeUpdate.
    execute метод возвращает a boolean указать на форму первого результата. Следует вызвать любого метод getResultSet или getUpdateCount получать результат; следует вызвать getMoreResults перемещаться в любой последующий результат (ы).
    
    Возвраты:
    
    true если первым результатом является a 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
```
    Устанавливает определяемые параметры к данному Reader объект, который является данным числом символов долго. Когда очень большое значение UNICODE вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.Reader объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    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 - a 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 - a 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
```
    Получает a ResultSetMetaData объект, который содержит информацию о столбцах ResultSet объект, который будет возвращен когда это PreparedStatement объект выполняется.
    Поскольку a PreparedStatement объект предварительно компилируется, возможно знать о ResultSet возразите, что это возвратится, не имея необходимость выполнять это. Следовательно, возможно вызвать метод getMetaData на a PreparedStatement возразите вместо того, чтобы ожидать, чтобы выполнить это и затем вызвать ResultSet.getMetaData метод на ResultSet объект, который возвращается.
    ОТМЕТЬТЕ: Используя этот метод может быть дорогим для некоторых драйверов из-за нехватки базовой поддержки DBMS.
    
    Возвраты:
    
    описание a ResultSet столбцы объекта или null если драйвер не может возвратить a 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 значение, которое драйвер тогда отправляет базе данных. С a 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 значение, которое драйвер тогда отправляет базе данных. С a 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 значение, которое драйвер тогда отправляет базе данных. С a 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
```
    Устанавливает определяемые параметры к SQL NULL. Эта версия метода setNull должен использоваться для определяемых пользователем типов и КАСАТЕЛЬНО параметров типа. Примеры определяемых пользователем типов включают: STRUCT, ОТЛИЧНЫЙ, JAVA_OBJECT, и названные типы массива.
    Отметьте: Чтобы быть переносимыми, приложения должны дать код типа SQL и полностью определенное имя типа SQL, определяя определяемый пользователем НУЛЬ или КАСАТЕЛЬНО параметра. В случае определяемого пользователем типа имя является именем типа параметра непосредственно. Для КАСАТЕЛЬНО параметра, имя является именем типа типа, на который ссылаются. Если драйвер JDBC не нуждается в кодовом названии типа или информации об имени типа, это может проигнорировать это. Хотя это предназначается для определяемого пользователем и Касательно параметров, этот метод может использоваться, чтобы установить нулевые параметры любого типа JDBC. Если у параметра нет определяемого пользователем или КАСАТЕЛЬНО типа, данное имя типа игнорируется.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    sqlType - значение от java.sql.Types
    
    typeName - полностью определенное имя SQL определяемый пользователем тип; проигнорированный, если параметр не является определяемым пользователем типом или КАСАТЕЛЬНО
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если sqlType a 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 параметры объекта.
    
    Возвраты:
    
    a 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
```
    Устанавливает определяемые параметры к a 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
```
    Устанавливает определяемые параметры к a 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
```
    Устанавливает определяемые параметры к a Reader объект. Читатель должен содержать число символов, определенных длиной иначе a SQLException будет сгенерирован когда PreparedStatement выполняется. Этот метод отличается от setCharacterStream (int, Reader, int) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB. Когда setCharacterStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARCHAR или a 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
```
    Устанавливает определяемые параметры к a InputStream объект. inputstream должен содержать число символов, определенных длиной иначе a SQLException будет сгенерирован когда PreparedStatement выполняется. Этот метод отличается от setBinaryStream (int, InputStream, int) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB. Когда setBinaryStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARBINARY или a BLOB
    
    Параметры:
    
    parameterIndex - индексируйте первого параметра, 1, второе 2...
    
    inputStream - Объект, который содержит данные, чтобы установить значение параметра в.
    
    length - число байтов в данных параметра.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement; если определенная длина является меньше чем нуль или если число байтов в inputstream не соответствует specfied длину.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setNClob
```
void setNClob(int parameterIndex,
              Reader reader,
              long length)
       throws SQLException
```
    Устанавливает определяемые параметры к a Reader объект. Читатель должен содержать число символов, определенных длиной иначе a SQLException будет сгенерирован когда PreparedStatement выполняется. Этот метод отличается от setCharacterStream (int, Reader, int) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB. Когда setCharacterStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGNVARCHAR или a NCLOB
    
    Параметры:
    
    parameterIndex - индексируйте первого параметра, 1, второе 2...
    
    reader - Объект, который содержит данные, чтобы установить значение параметра в.
    
    length - число символов в данных параметра.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если определенная длина является меньше чем нуль; если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setSQLXML
```
void setSQLXML(int parameterIndex,
               SQLXML xmlObject)
        throws SQLException
```
    Устанавливает определяемые параметры к данному java.sql.SQLXML объект. Драйвер преобразовывает это в SQL XML оцените, когда это отправляет это базе данных.
    
    Параметры:
    
    parameterIndex - индексируйте первого параметра, 1, второе 2...
    
    xmlObject - a 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
```
    Устанавливает значение определяемого параметра с данным объектом. Если второй параметр InputStream тогда поток должен содержать число байтов, определенных scaleOrLength. Если вторым параметром является a Reader тогда читатель должен содержать число символов, определенных scaleOrLength. Если эти условия не будут истиной, то драйвер генерирует a SQLException когда готовый оператор выполняется.
    Данный объект Java будет преобразован в данный targetSqlType прежде, чем быть отправленным базе данных. Если у объекта есть пользовательское отображение (имеет class, реализовывая интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL записать это в поток данных SQL. Если с другой стороны объект имеет реализацию class Ref, Blob, Clob, NClob, Struct, java.net.URL, или Array, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
    Отметьте, что этот метод может использоваться, чтобы передать специфичные для базы данных абстрактные типы данных.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - объект, содержащий входное значение параметра
    
    targetSqlType - тип SQL (как определено в java.sql. Типы), чтобы быть отправленным базе данных. Параметр масштаба может далее квалифицировать этот тип.
    
    scaleOrLength - для java.sql.Types.DECIMAL или java.sql.Types.NUMERIC types, это - число цифр после десятичной точки. Для типов Объекта Java InputStream и Reader, это - длина данных в потоке или читателе. Для всех других типов будет проигнорировано это значение.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или если Объект Java, определенный x, является объектом InputStream или Читателя, и значение масштабного коэффициента является меньше чем нуль
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Types
  - setAsciiStream
```
void setAsciiStream(int parameterIndex,
                    InputStream x,
                    long length)
             throws SQLException
```
    Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов. Когда очень большое значение ASCII вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток Java, который содержит значение параметра ASCII
    
    length - число байтов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    С тех пор:
    
    1.6
  - setBinaryStream
```
void setBinaryStream(int parameterIndex,
                     InputStream x,
                     long length)
              throws SQLException
```
    Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов. Когда очень большое двоичное значение вводится к a LONGVARBINARY параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток java, который содержит двоичное значение параметра
    
    length - число байтов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    С тех пор:
    
    1.6
  - setCharacterStream
```
void setCharacterStream(int parameterIndex,
                        Reader reader,
                        long length)
                 throws SQLException
```
    Устанавливает определяемые параметры к данному Reader объект, который является данным числом символов долго. Когда очень большое значение UNICODE вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.Reader объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    reader - java.io.Reader объект, который содержит данные Unicode
    
    length - число символов в потоке
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    С тех пор:
    
    1.6
  - setAsciiStream
```
void setAsciiStream(int parameterIndex,
                    InputStream x)
             throws SQLException
```
    Устанавливает определяемые параметры к данному входному потоку. Когда очень большое значение ASCII вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setAsciiStream который берет параметр длины.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток Java, который содержит значение параметра ASCII
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setBinaryStream
```
void setBinaryStream(int parameterIndex,
                     InputStream x)
              throws SQLException
```
    Устанавливает определяемые параметры к данному входному потоку. Когда очень большое двоичное значение вводится к a LONGVARBINARY параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBinaryStream который берет параметр длины.
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - входной поток java, который содержит двоичное значение параметра
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setCharacterStream
```
void setCharacterStream(int parameterIndex,
                        Reader reader)
                 throws SQLException
```
    Устанавливает определяемые параметры к данному Reader объект. Когда очень большое значение UNICODE вводится к a LONGVARCHAR параметр, это может быть более практично, чтобы отправить это через a java.io.Reader объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setCharacterStream который берет параметр длины.
    
    Параметры:
    
    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
```
    Устанавливает определяемые параметры к a Reader объект. Reader читает данные, пока конец файла не достигается. Драйвер делает необходимое преобразование от символьного формата Java до набора национального характера в базе данных.
    Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNCharacterStream который берет параметр длины.
    
    Параметры:
    
    parameterIndex - из первого параметра 1, второе 2...
    
    value - значение параметра
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит; или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setClob
```
void setClob(int parameterIndex,
             Reader reader)
      throws SQLException
```
    Устанавливает определяемые параметры к a Reader объект. Этот метод отличается от setCharacterStream (int, Reader) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB. Когда setCharacterStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARCHAR или a CLOB
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setClob который берет параметр длины.
    
    Параметры:
    
    parameterIndex - индексируйте первого параметра, 1, второе 2...
    
    reader - Объект, который содержит данные, чтобы установить значение параметра в.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatementили если parameterIndex не соответствует маркеру параметра в SQL-операторе
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setBlob
```
void setBlob(int parameterIndex,
             InputStream inputStream)
      throws SQLException
```
    Устанавливает определяемые параметры к a InputStream объект. Этот метод отличается от setBinaryStream (int, InputStream) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB. Когда setBinaryStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARBINARY или a BLOB
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBlob который берет параметр длины.
    
    Параметры:
    
    parameterIndex - индексируйте первого параметра, 1, второе 2...
    
    inputStream - Объект, который содержит данные, чтобы установить значение параметра в.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или если parameterIndex не соответствует маркеру параметра в SQL-операторе,
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.6
  - setNClob
```
void setNClob(int parameterIndex,
              Reader reader)
       throws SQLException
```
    Устанавливает определяемые параметры к a Reader объект. Этот метод отличается от setCharacterStream (int, Reader) метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB. Когда setCharacterStream метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGNVARCHAR или a NCLOB
    Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNClob который берет параметр длины.
    
    Параметры:
    
    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
```
    Устанавливает значение определяемого параметра с данным объектом. Если второй параметр InputStream тогда поток должен содержать число байтов, определенных scaleOrLength. Если вторым параметром является a Reader тогда читатель должен содержать число символов, определенных scaleOrLength. Если эти условия не будут истиной, то драйвер генерирует a SQLException когда готовый оператор выполняется.
    Данный объект Java будет преобразован в данный targetSqlType прежде, чем быть отправленным базе данных. Если у объекта есть пользовательское отображение (имеет class, реализовывая интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL записать это в поток данных SQL. Если с другой стороны объект имеет реализацию class Ref, Blob, Clob, NClob, Struct, java.net.URL, или Array, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
    Отметьте, что этот метод может использоваться, чтобы передать специфичные для базы данных абстрактные типы данных.
    Реализация по умолчанию бросит SQLFeatureNotSupportedException
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - объект, содержащий входное значение параметра
    
    targetSqlType - тип SQL, который будет отправлен базе данных. Параметр масштаба может далее квалифицировать этот тип.
    
    scaleOrLength - для java.sql.JDBCType.DECIMAL или java.sql.JDBCType.NUMERIC types, это - число цифр после десятичной точки. Для типов Объекта Java InputStream и Reader, это - длина данных в потоке или читателе. Для всех других типов будет проигнорировано это значение.
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement или если Объект Java, определенный x, является объектом InputStream или Читателя, и значение масштабного коэффициента является меньше чем нуль
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    С тех пор:
    
    1.8
    
    См. Также:
    
    JDBCType, SQLType
  - setObject
```
default void setObject(int parameterIndex,
                       Object x,
                       SQLType targetSqlType)
                throws SQLException
```
    Устанавливает значение определяемого параметра с данным объектом. Этот метод подобен setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength), за исключением того, что это принимает масштаб нуля.
    Реализация по умолчанию бросит SQLFeatureNotSupportedException
    
    Параметры:
    
    parameterIndex - первый параметр 1, второе 2...
    
    x - объект, содержащий входное значение параметра
    
    targetSqlType - тип SQL, который будет отправлен базе данных
    
    Броски:
    
    SQLException - если parameterIndex не соответствует маркеру параметра в SQL-операторе; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    С тех пор:
    
    1.8
    
    См. Также:
    
    JDBCType, SQLType
  - executeLargeUpdate
```
default long executeLargeUpdate()
                         throws SQLException
```
    Выполняет SQL-оператор в этом PreparedStatement объект, который должен быть Языком манипулирования данными SQL (DML) оператор, такой как INSERT, UPDATE или DELETE; или SQL-оператор, который ничего не возвращает, такого как оператор DDL.
    Этот метод должен использоваться, когда возвращенное количество строки может превысить Integer.MAX_VALUE.
    Реализация по умолчанию бросит UnsupportedOperationException
    
    Возвраты:
    
    или (1) счет строки для Языка манипулирования данными SQL (DML) операторы или (2) 0 для SQL-операторов, которые ничего не возвращают
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит; этот метод вызывают на закрытом PreparedStatement или SQL-оператор возвращает a ResultSet объект
    
    SQLTimeoutException - когда драйвер решил, что значение тайм-аута, которое было определено setQueryTimeout метод был превышен и по крайней мере попытался отменить в настоящий момент рабочее Statement
    
    С тех пор:
    
    1.8

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Интерфейс PreparedStatement

Полевая Сводка

Поля, наследованные от интерфейса java.sql. Оператор

Сводка метода

Методы, наследованные от интерфейса java.sql. Оператор

Методы, наследованные от интерфейса java.sql. Обертка

Деталь метода

executeQuery

executeUpdate

setNull

setBoolean

setByte

setShort

setInt

setLong

setFloat

setDouble

setBigDecimal

setString

setBytes

setDate

setTime

setTimestamp

setAsciiStream

setUnicodeStream

setBinaryStream

clearParameters

setObject

setObject

выполниться

addBatch

setCharacterStream

setRef

setBlob

setClob

setArray

getMetaData

setDate

setTime

setTimestamp

setNull

setURL

getParameterMetaData

setRowId

setNString

setNCharacterStream

setNClob

setClob

setBlob

setNClob

setSQLXML

setObject

setAsciiStream

setBinaryStream

setCharacterStream

setAsciiStream

setBinaryStream

setCharacterStream

setNCharacterStream

setClob

setBlob

setNClob

setObject

setObject

executeLargeUpdate