Spec-Zone.ru › OpenJDK 27

Интерфейс CallableStatement

Все суперинтерфейсы:
AutoCloseable, PreparedStatement, Statement, Wrapper
public interface CallableStatement extends PreparedStatement
Интерфейс для выполнения хранимых процедур SQL. API JDBC предоставляет синтаксис escape-последовательностей SQL для хранимых процедур, который позволяет вызывать хранимые процедуры стандартным способом во всех СУБД. Этот синтаксис escape-последовательностей имеет одну форму с параметром результата и одну без него. Если параметр результата используется, его необходимо зарегистрировать как выходной параметр. Остальные параметры можно использовать для ввода, вывода или того и другого. К параметрам обращаются последовательно по номеру, начиная с 1. 
  {?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
  {call <procedure-name>[(<arg1>,<arg2>, ...)]}

Значения входных параметров задаются с помощью методов set, унаследованных от PreparedStatement. Тип всех выходных параметров необходимо зарегистрировать до выполнения хранимой процедуры; их значения извлекаются после выполнения с помощью методов get, предоставляемых здесь.

Объект CallableStatement может возвращать один объект ResultSet или несколько объектов ResultSet. Для обработки нескольких объектов ResultSet используются операции, унаследованные от Statement.

Для обеспечения максимальной переносимости перед получением значений выходных параметров следует обработать объекты ResultSet и счётчики обновлённых строк, возвращённые при вызове.

С версии:
1.1
См. также:
  • Connection.prepareCall(String)
  • ResultSet

Краткое описание полей

Поля, объявленные в интерфейсе Statement

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO
Модификатор и тип Поле Описание
static final int CLOSE_ALL_RESULTS
Константа, указывающая, что все объекты ResultSet, которые ранее оставались открытыми, должны быть закрыты при вызове getMoreResults.
static final int CLOSE_CURRENT_RESULT
Константа, указывающая, что текущий объект ResultSet должен быть закрыт при вызове getMoreResults.
static final int EXECUTE_FAILED
Константа, указывающая, что при выполнении пакетного оператора произошла ошибка.
static final int KEEP_CURRENT_RESULT
Константа, указывающая, что текущий объект ResultSet не должен быть закрыт при вызове getMoreResults.
static final int NO_GENERATED_KEYS
Константа, указывающая, что сгенерированные ключи не должны быть доступны для извлечения.
static final int RETURN_GENERATED_KEYS
Константа, указывающая, что сгенерированные ключи должны быть доступны для извлечения.
static final int SUCCESS_NO_INFO
Константа, указывающая, что пакетный оператор выполнен успешно, но количество затронутых им строк неизвестно.

Краткое описание методов

Модификатор и тип Метод Описание
Array getArray(int parameterIndex)
Извлекает значение указанного параметра JDBC ARRAY как объект Array в языке программирования Java.
Array getArray(String parameterName)
Извлекает значение параметра JDBC ARRAY как объект Array в языке программирования Java.
BigDecimal getBigDecimal(int parameterIndex)
Извлекает значение указанного параметра JDBC NUMERIC как объект java.math.BigDecimal с таким количеством цифр после десятичной точки, которое содержится в значении.
BigDecimal getBigDecimal(int parameterIndex, int scale)
Устарел.
используйте getBigDecimal(int parameterIndex) или getBigDecimal(String parameterName)
BigDecimal getBigDecimal(String parameterName)
Извлекает значение параметра JDBC NUMERIC как объект java.math.BigDecimal с таким количеством цифр после десятичной точки, которое содержится в значении.
Blob getBlob(int parameterIndex)
Извлекает значение указанного параметра JDBC BLOB как объект Blob в языке программирования Java.
Blob getBlob(String parameterName)
Извлекает значение параметра JDBC BLOB как объект Blob в языке программирования Java.
boolean getBoolean(int parameterIndex)
Извлекает значение указанного параметра JDBC BIT или BOOLEAN как boolean в языке программирования Java.
boolean getBoolean(String parameterName)
Извлекает значение параметра JDBC BIT или BOOLEAN как boolean в языке программирования Java.
byte getByte(int parameterIndex)
Извлекает значение указанного параметра JDBC TINYINT как byte в языке программирования Java.
byte getByte(String parameterName)
Извлекает значение параметра JDBC TINYINT как byte в языке программирования Java.
byte[] getBytes(int parameterIndex)
Извлекает значение указанного параметра JDBC BINARY или VARBINARY как массив значений byte в языке программирования Java.
byte[] getBytes(String parameterName)
Извлекает значение параметра JDBC BINARY или VARBINARY как массив значений byte в языке программирования Java.
Reader getCharacterStream(int parameterIndex)
Извлекает значение указанного параметра как объект java.io.Reader в языке программирования Java.
Reader getCharacterStream(String parameterName)
Извлекает значение указанного параметра как объект java.io.Reader в языке программирования Java.
Clob getClob(int parameterIndex)
Извлекает значение указанного параметра JDBC CLOB как объект java.sql.Clob в языке программирования Java.
Clob getClob(String parameterName)
Извлекает значение параметра JDBC CLOB как объект java.sql.Clob в языке программирования Java.
Date getDate(int parameterIndex)
Извлекает значение указанного параметра JDBC DATE как объект java.sql.Date.
Date getDate(int parameterIndex, Calendar cal)
Извлекает значение указанного параметра JDBC DATE как объект java.sql.Date, используя переданный объект Calendar для создания даты.
Date getDate(String parameterName)
Извлекает значение параметра JDBC DATE как объект java.sql.Date.
Date getDate(String parameterName, Calendar cal)
Извлекает значение параметра JDBC DATE как объект java.sql.Date, используя переданный объект Calendar для создания даты.
double getDouble(int parameterIndex)
Извлекает значение указанного параметра JDBC DOUBLE как double в языке программирования Java.
double getDouble(String parameterName)
Извлекает значение параметра JDBC DOUBLE как double в языке программирования Java.
float getFloat(int parameterIndex)
Извлекает значение указанного параметра JDBC FLOAT как float в языке программирования Java.
float getFloat(String parameterName)
Извлекает значение параметра JDBC FLOAT как float в языке программирования Java.
int getInt(int parameterIndex)
Извлекает значение указанного параметра JDBC INTEGER как int в языке программирования Java.
int getInt(String parameterName)
Извлекает значение параметра JDBC INTEGER как int в языке программирования Java.
long getLong(int parameterIndex)
Извлекает значение указанного параметра JDBC BIGINT как long в языке программирования Java.
long getLong(String parameterName)
Извлекает значение параметра JDBC BIGINT как long в языке программирования Java.
Reader getNCharacterStream(int parameterIndex)
Извлекает значение указанного параметра как объект java.io.Reader в языке программирования Java.
Reader getNCharacterStream(String parameterName)
Извлекает значение указанного параметра как объект java.io.Reader в языке программирования Java.
NClob getNClob(int parameterIndex)
Извлекает значение указанного параметра JDBC NCLOB как объект java.sql.NClob в языке программирования Java.
NClob getNClob(String parameterName)
Извлекает значение параметра JDBC NCLOB как объект java.sql.NClob в языке программирования Java.
String getNString(int parameterIndex)
Извлекает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR как String в языке программирования Java.
String getNString(String parameterName)
Извлекает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR как String в языке программирования Java.
Object getObject(int parameterIndex)
Извлекает значение указанного параметра как Object в языке программирования Java.
<T> T getObject(int parameterIndex, Class<T> type)
Возвращает объект, представляющий значение выходного параметра OUT parameterIndex, и преобразует SQL-тип параметра в запрошенный тип данных Java, если такое преобразование поддерживается.
Object getObject(int parameterIndex, Map<String,Class<?>> map)
Возвращает объект, представляющий значение выходного параметра OUT parameterIndex, и использует map для пользовательского сопоставления значения параметра.
Object getObject(String parameterName)
Извлекает значение параметра как Object в языке программирования Java.
<T> T getObject(String parameterName, Class<T> type)
Возвращает объект, представляющий значение выходного параметра OUT parameterName, и преобразует SQL-тип параметра в запрошенный тип данных Java, если такое преобразование поддерживается.
Object getObject(String parameterName, Map<String,Class<?>> map)
Возвращает объект, представляющий значение выходного параметра OUT parameterName, и использует map для пользовательского сопоставления значения параметра.
Ref getRef(int parameterIndex)
Извлекает значение указанного параметра JDBC REF(<structured-type>) как объект Ref в языке программирования Java.
Ref getRef(String parameterName)
Извлекает значение параметра JDBC REF(<structured-type>) как объект Ref в языке программирования Java.
RowId getRowId(int parameterIndex)
Извлекает значение указанного параметра JDBC ROWID как объект java.sql.RowId.
RowId getRowId(String parameterName)
Извлекает значение указанного параметра JDBC ROWID как объект java.sql.RowId.
short getShort(int parameterIndex)
Извлекает значение указанного параметра JDBC SMALLINT как short в языке программирования Java.
short getShort(String parameterName)
Извлекает значение параметра JDBC SMALLINT как short в языке программирования Java.
SQLXML getSQLXML(int parameterIndex)
Извлекает значение указанного параметра SQL XML как объект java.sql.SQLXML в языке программирования Java.
SQLXML getSQLXML(String parameterName)
Извлекает значение указанного параметра SQL XML как объект java.sql.SQLXML в языке программирования Java.
String getString(int parameterIndex)
Извлекает значение указанного параметра JDBC CHAR, VARCHAR или LONGVARCHAR как String в языке программирования Java.
String getString(String parameterName)
Извлекает значение параметра JDBC CHAR, VARCHAR или LONGVARCHAR как String в языке программирования Java.
Time getTime(int parameterIndex)
Извлекает значение указанного параметра JDBC TIME как объект java.sql.Time.
Time getTime(int parameterIndex, Calendar cal)
Извлекает значение указанного параметра JDBC TIME как объект java.sql.Time, используя переданный объект Calendar для создания времени.
Time getTime(String parameterName)
Извлекает значение параметра JDBC TIME как объект java.sql.Time.
Time getTime(String parameterName, Calendar cal)
Извлекает значение параметра JDBC TIME как объект java.sql.Time, используя переданный объект Calendar для создания времени.
Timestamp getTimestamp(int parameterIndex)
Извлекает значение указанного параметра JDBC TIMESTAMP как объект java.sql.Timestamp.
Timestamp getTimestamp(int parameterIndex, Calendar cal)
Извлекает значение указанного параметра JDBC TIMESTAMP как объект java.sql.Timestamp, используя переданный объект Calendar для создания объекта Timestamp.
Timestamp getTimestamp(String parameterName)
Извлекает значение параметра JDBC TIMESTAMP как объект java.sql.Timestamp.
Timestamp getTimestamp(String parameterName, Calendar cal)
Извлекает значение параметра JDBC TIMESTAMP как объект java.sql.Timestamp, используя переданный объект Calendar для создания объекта Timestamp.
URL getURL(int parameterIndex)
Извлекает значение указанного параметра JDBC DATALINK как объект java.net.URL.
URL getURL(String parameterName)
Извлекает значение параметра JDBC DATALINK как объект java.net.URL.
void registerOutParameter(int parameterIndex, int sqlType)
Регистрирует выходной параметр OUT с порядковым номером parameterIndex как имеющий тип JDBC sqlType.
void registerOutParameter(int parameterIndex, int sqlType, int scale)
Регистрирует параметр с порядковым номером parameterIndex как имеющий тип JDBC sqlType.
void registerOutParameter(int parameterIndex, int sqlType, String typeName)
Регистрирует указанный выходной параметр.
default void registerOutParameter(int parameterIndex, SQLType sqlType)
Регистрирует выходной параметр OUT с порядковым номером parameterIndex как имеющий тип JDBC sqlType.
default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale)
Регистрирует параметр с порядковым номером parameterIndex как имеющий тип JDBC sqlType.
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName)
Регистрирует указанный выходной параметр.
void registerOutParameter(String parameterName, int sqlType)
Регистрирует выходной параметр OUT с именем parameterName как имеющий тип JDBC sqlType.
void registerOutParameter(String parameterName, int sqlType, int scale)
Регистрирует параметр с именем parameterName как имеющий тип JDBC sqlType.
void registerOutParameter(String parameterName, int sqlType, String typeName)
Регистрирует указанный выходной параметр.
default void registerOutParameter(String parameterName, SQLType sqlType)
Регистрирует выходной параметр OUT с именем parameterName как имеющий тип JDBC sqlType.
default void registerOutParameter(String parameterName, SQLType sqlType, int scale)
Регистрирует параметр с именем parameterName как имеющий тип JDBC sqlType.
default void registerOutParameter(String parameterName, SQLType sqlType, String typeName)
Регистрирует указанный выходной параметр.
void setAsciiStream(String parameterName, InputStream x)
Устанавливает для указанного параметра переданный входной поток.
void setAsciiStream(String parameterName, InputStream x, int length)
Устанавливает для указанного параметра переданный входной поток заданного количества байтов.
void setAsciiStream(String parameterName, InputStream x, long length)
Устанавливает для указанного параметра переданный входной поток заданного количества байтов.
void setBigDecimal(String parameterName, BigDecimal x)
Устанавливает для указанного параметра переданное значение java.math.BigDecimal.
void setBinaryStream(String parameterName, InputStream x)
Устанавливает для указанного параметра переданный входной поток.
void setBinaryStream(String parameterName, InputStream x, int length)
Устанавливает для указанного параметра переданный входной поток заданного количества байтов.
void setBinaryStream(String parameterName, InputStream x, long length)
Устанавливает для указанного параметра переданный входной поток заданного количества байтов.
void setBlob(String parameterName, InputStream inputStream)
Устанавливает для указанного параметра объект InputStream.
void setBlob(String parameterName, InputStream inputStream, long length)
Устанавливает для указанного параметра объект InputStream.
void setBlob(String parameterName, Blob x)
Устанавливает для указанного параметра переданный объект java.sql.Blob.
void setBoolean(String parameterName, boolean x)
Устанавливает для указанного параметра переданное значение Java boolean.
void setByte(String parameterName, byte x)
Устанавливает для указанного параметра переданное значение Java byte.
void setBytes(String parameterName, byte[] x)
Устанавливает для указанного параметра переданный массив байтов Java.
void setCharacterStream(String parameterName, Reader reader)
Устанавливает для указанного параметра переданный объект Reader.
void setCharacterStream(String parameterName, Reader reader, int length)
Устанавливает для указанного параметра переданный объект Reader указанной длины в символах.
void setCharacterStream(String parameterName, Reader reader, long length)
Устанавливает для указанного параметра переданный объект Reader указанной длины в символах.
void setClob(String parameterName, Reader reader)
Устанавливает для указанного параметра объект Reader.
void setClob(String parameterName, Reader reader, long length)
Устанавливает для указанного параметра объект Reader.
void setClob(String parameterName, Clob x)
Устанавливает для указанного параметра переданный объект java.sql.Clob.
void setDate(String parameterName, Date x)
Устанавливает для указанного параметра переданное значение java.sql.Date, используя часовой пояс по умолчанию виртуальной машины, на которой выполняется приложение.
void setDate(String parameterName, Date x, Calendar cal)
Устанавливает для указанного параметра переданное значение java.sql.Date, используя переданный объект Calendar.
void setDouble(String parameterName, double x)
Устанавливает для указанного параметра переданное значение Java double.
void setFloat(String parameterName, float x)
Устанавливает для указанного параметра переданное значение Java float.
void setInt(String parameterName, int x)
Устанавливает для указанного параметра переданное значение Java int.
void setLong(String parameterName, long x)
Устанавливает для указанного параметра переданное значение Java long.
void setNCharacterStream(String parameterName, Reader value)
Устанавливает для указанного параметра объект Reader.
void setNCharacterStream(String parameterName, Reader value, long length)
Устанавливает для указанного параметра объект Reader.
void setNClob(String parameterName, Reader reader)
Устанавливает для указанного параметра объект Reader.
void setNClob(String parameterName, Reader reader, long length)
Устанавливает для указанного параметра объект Reader.
void setNClob(String parameterName, NClob value)
Устанавливает для указанного параметра объект java.sql.NClob.
void setNString(String parameterName, String value)
Устанавливает для указанного параметра переданный объект String.
void setNull(String parameterName, int sqlType)
Устанавливает для указанного параметра значение SQL NULL.
void setNull(String parameterName, int sqlType, String typeName)
Устанавливает для указанного параметра значение SQL NULL.
void setObject(String parameterName, Object x)
Устанавливает значение указанного параметра с помощью переданного объекта.
void setObject(String parameterName, Object x, int targetSqlType)
Устанавливает значение указанного параметра с помощью переданного объекта.
void setObject(String parameterName, Object x, int targetSqlType, int scale)
Устанавливает значение указанного параметра с помощью переданного объекта.
default void setObject(String parameterName, Object x, SQLType targetSqlType)
Устанавливает значение указанного параметра с помощью переданного объекта.
default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)
Устанавливает значение указанного параметра с помощью переданного объекта.
void setRowId(String parameterName, RowId x)
Устанавливает для указанного параметра переданный объект java.sql.RowId.
void setShort(String parameterName, short x)
Устанавливает для указанного параметра переданное значение Java short.
void setSQLXML(String parameterName, SQLXML xmlObject)
Устанавливает для указанного параметра переданный объект java.sql.SQLXML.
void setString(String parameterName, String x)
Устанавливает для указанного параметра переданное значение Java String.
void setTime(String parameterName, Time x)
Устанавливает для указанного параметра переданное значение java.sql.Time.
void setTime(String parameterName, Time x, Calendar cal)
Устанавливает для указанного параметра переданное значение java.sql.Time, используя переданный объект Calendar.
void setTimestamp(String parameterName, Timestamp x)
Устанавливает для указанного параметра переданное значение java.sql.Timestamp.
void setTimestamp(String parameterName, Timestamp x, Calendar cal)
Устанавливает для указанного параметра переданное значение java.sql.Timestamp, используя переданный объект Calendar.
void setURL(String parameterName, URL val)
Устанавливает для указанного параметра переданный объект java.net.URL.
boolean wasNull()
Возвращает, имело ли значение последнего прочитанного выходного параметра OUT значение SQL NULL.

Методы, объявленные в интерфейсе PreparedStatement

addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL
Модификатор и тип Метод Описание
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()
Получает объект 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, InputStream inputStream)
Устанавливает для указанного параметра объект InputStream.
void setBlob(int parameterIndex, InputStream inputStream, long length)
Устанавливает для указанного параметра объект InputStream.
void setBlob(int parameterIndex, Blob x)
Устанавливает для указанного параметра заданный объект java.sql.Blob.
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, Reader reader)
Устанавливает для указанного параметра объект Reader.
void setClob(int parameterIndex, Reader reader, long length)
Устанавливает для указанного параметра объект Reader.
void setClob(int parameterIndex, Clob x)
Устанавливает для указанного параметра заданный объект java.sql.Clob.
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)
Устанавливает для указанного параметра объект Reader.
void setNCharacterStream(int parameterIndex, Reader value, long length)
Устанавливает для указанного параметра объект Reader.
void setNClob(int parameterIndex, Reader reader)
Устанавливает для указанного параметра объект Reader.
void setNClob(int parameterIndex, Reader reader, long length)
Устанавливает для указанного параметра объект Reader.
void setNClob(int parameterIndex, NClob value)
Устанавливает для указанного параметра объект java.sql.NClob.
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.

Методы, объявленные в интерфейсе Statement

addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, 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, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout
Модификатор и тип Метод Описание
void addBatch(String sql)
Добавляет заданную команду SQL в текущий список команд объекта Statement.
void cancel()
Отменяет выполнение объекта Statement, если СУБД и драйвер поддерживают прерывание инструкции SQL.
void clearBatch()
Очищает текущий список инструкций SQL объекта Statement.
void clearWarnings()
Удаляет все предупреждения, зарегистрированные для объекта Statement.
void close()
Немедленно освобождает ресурсы базы данных и JDBC объекта Statement, не дожидаясь автоматического закрытия объекта.
void closeOnCompletion()
Указывает, что объект Statement будет закрыт после закрытия всех зависимых от него наборов результатов.
default String enquoteIdentifier(String identifier, boolean alwaysDelimit)
Возвращает simple SQL identifier или идентификатор с разделителями.
default String enquoteLiteral(String val)
Возвращает String, заключенный в одинарные кавычки.
default String enquoteNCharLiteral(String val)
Возвращает String, представляющий литерал национального набора символов, заключенный в одинарные кавычки и снабженный префиксом в виде заглавной буквы N.
boolean execute(String sql)
Выполняет заданную инструкцию SQL, которая может возвращать несколько результатов.
boolean execute(String sql, int autoGeneratedKeys)
Выполняет заданную инструкцию SQL, которая может возвращать несколько результатов, и сообщает драйверу, что сгенерированные автоматически ключи должны быть доступны для получения.
boolean execute(String sql, int[] columnIndexes)
Выполняет заданную инструкцию SQL, которая может возвращать несколько результатов, и сообщает драйверу, что сгенерированные автоматически ключи, указанные в заданном массиве, должны быть доступны для получения.
boolean execute(String sql, String[] columnNames)
Выполняет заданную инструкцию SQL, которая может возвращать несколько результатов, и сообщает драйверу, что сгенерированные автоматически ключи, указанные в заданном массиве, должны быть доступны для получения.
int[] executeBatch()
Отправляет пакет команд на выполнение в базу данных и, если все команды выполняются успешно, возвращает массив счетчиков обновлений.
default long[] executeLargeBatch()
Отправляет пакет команд на выполнение в базу данных и, если все команды выполняются успешно, возвращает массив счетчиков обновлений.
default long executeLargeUpdate(String sql)
Выполняет заданную инструкцию SQL, которая может быть инструкцией INSERT, UPDATE или DELETE либо инструкцией SQL, не возвращающей данных, например инструкцией DDL.
default long executeLargeUpdate(String sql, int autoGeneratedKeys)
Выполняет заданную инструкцию SQL и сообщает драйверу с помощью заданного флага, следует ли сделать доступными для получения автоматически сгенерированные ключи, полученные объектом Statement.
default long executeLargeUpdate(String sql, int[] columnIndexes)
Выполняет заданную инструкцию SQL и сообщает драйверу, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для получения.
default long executeLargeUpdate(String sql, String[] columnNames)
Выполняет заданную инструкцию SQL и сообщает драйверу, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для получения.
ResultSet executeQuery(String sql)
Выполняет заданную инструкцию SQL, возвращающую один объект ResultSet.
int executeUpdate(String sql)
Выполняет заданную инструкцию SQL, которая может быть инструкцией INSERT, UPDATE или DELETE либо инструкцией SQL, не возвращающей данных, например инструкцией DDL.
int executeUpdate(String sql, int autoGeneratedKeys)
Выполняет заданную инструкцию SQL и сообщает драйверу с помощью заданного флага, следует ли сделать доступными для получения автоматически сгенерированные ключи, полученные объектом Statement.
int executeUpdate(String sql, int[] columnIndexes)
Выполняет заданную инструкцию SQL и сообщает драйверу, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для получения.
int executeUpdate(String sql, String[] columnNames)
Выполняет заданную инструкцию SQL и сообщает драйверу, что автоматически сгенерированные ключи, указанные в заданном массиве, должны быть доступны для получения.
Connection getConnection()
Получает объект Connection, создавший этот объект Statement.
int getFetchDirection()
Получает направление выборки строк из таблиц базы данных, установленное по умолчанию для наборов результатов, созданных этим объектом Statement.
int getFetchSize()
Получает количество строк набора результатов, установленное по умолчанию в качестве размера выборки для объектов ResultSet, созданных этим объектом Statement.
ResultSet getGeneratedKeys()
Получает все автоматически сгенерированные ключи, созданные в результате выполнения этого объекта Statement.
default long getLargeMaxRows()
Получает максимальное количество строк, которое может содержать объект ResultSet, созданный этим объектом Statement.
default long getLargeUpdateCount()
Получает текущий результат как счетчик обновлений; если результат представляет собой объект ResultSet или больше результатов нет, возвращается -1.
int getMaxFieldSize()
Получает максимальное количество байтов, возвращаемых для значений символьных и двоичных столбцов в объекте ResultSet, созданном этим объектом Statement.
int getMaxRows()
Получает максимальное количество строк, которое может содержать объект ResultSet, созданный этим объектом Statement.
boolean getMoreResults()
Переходит к следующему результату объекта Statement, возвращает true, если результат является объектом ResultSet, и неявно закрывает все текущие объекты ResultSet, полученные с помощью метода getResultSet.
boolean getMoreResults(int current)
Переходит к следующему результату объекта Statement, обрабатывает все текущие объекты ResultSet в соответствии с инструкциями, заданными флагом, и возвращает true, если следующий результат является объектом ResultSet.
int getQueryTimeout()
Получает количество секунд, в течение которых драйвер будет ожидать выполнения объекта Statement.
ResultSet getResultSet()
Получает текущий результат как объект ResultSet.
int getResultSetConcurrency()
Получает режим параллелизма набора результатов для объектов ResultSet, созданных этим объектом Statement.
int getResultSetHoldability()
Получает режим сохранения набора результатов для объектов ResultSet, созданных этим объектом Statement.
int getResultSetType()
Получает тип набора результатов для объектов ResultSet, созданных этим объектом Statement.
int getUpdateCount()
Получает текущий результат как счетчик обновлений; если результат представляет собой объект ResultSet или больше результатов нет, возвращается -1.
SQLWarning getWarnings()
Получает первое предупреждение, зарегистрированное при вызовах объекта Statement.
boolean isClosed()
Получает сведения о том, закрыт ли объект Statement.
boolean isCloseOnCompletion()
Возвращает значение, указывающее, будет ли объект Statement закрыт после закрытия всех зависимых от него наборов результатов.
boolean isPoolable()
Возвращает значение, указывающее, допускает ли объект Statement использование в пуле.
default boolean isSimpleIdentifier(String identifier)
Возвращает значение, указывающее, является ли identifier простым идентификатором SQL.
void setCursorName(String name)
Задает имя курсора SQL как String, которое будет использоваться последующими методами объекта Statement execute.
void setEscapeProcessing(boolean enable)
Включает или отключает обработку escape-последовательностей.
void setFetchDirection(int direction)
Передает драйверу подсказку о направлении обработки строк в объектах ResultSet, созданных с помощью этого объекта Statement.
void setFetchSize(int rows)
Передает драйверу JDBC подсказку о количестве строк, которые следует извлечь из базы данных, когда для объектов ResultSet, созданных этим объектом Statement, потребуются дополнительные строки.
default void setLargeMaxRows(long max)
Устанавливает заданное ограничение максимального количества строк, которое может содержать любой объект ResultSet, созданный этим объектом Statement.
void setMaxFieldSize(int max)
Устанавливает ограничение максимального количества байтов, возвращаемых для значений символьных и двоичных столбцов в объекте ResultSet, созданном этим объектом Statement.
void setMaxRows(int max)
Устанавливает заданное ограничение максимального количества строк, которое может содержать любой объект ResultSet, созданный этим объектом Statement.
void setPoolable(boolean poolable)
Запрашивает использование объекта Statement в пуле или отказ от него.
void setQueryTimeout(int seconds)
Устанавливает время ожидания драйвера выполнения объекта Statement в заданное количество секунд.

Методы, объявленные в интерфейсе Wrapper

isWrapperFor, unwrap
Модификатор и тип Метод Описание
boolean isWrapperFor(Class<?> iface)
Возвращает true, если этот объект реализует интерфейс, переданный в качестве аргумента, или прямо либо косвенно является оболочкой объекта, который его реализует.
<T> T unwrap(Class<T> iface)
Возвращает объект, реализующий заданный интерфейс, чтобы обеспечить доступ к нестандартным методам или стандартным методам, не предоставляемым прокси-объектом.

Подробное описание методов

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException
Регистрирует параметр OUT в порядковой позиции parameterIndex с типом JDBC sqlType. Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный с помощью sqlType для параметра OUT, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Если ожидаемый для этого выходного параметра тип JDBC специфичен для данной базы данных, следует указать java.sql.Types.OTHER в sqlType. Метод getObject(int) извлекает значение.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
sqlType — код типа JDBC, определённый в java.sql.Types. Если параметр имеет тип JDBC NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных
См. также:
  • Types

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException
Регистрирует параметр в порядковой позиции parameterIndex с типом JDBC sqlType. Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный с помощью sqlType для параметра OUT, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Эту версию registerOutParameter следует использовать, если параметр имеет тип JDBC NUMERIC или DECIMAL.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
sqlType — код типа SQL, определённый в java.sql.Types.
scale — требуемое число цифр справа от десятичной точки. Значение должно быть больше или равно нулю.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных
См. также:
  • Types

wasNull

boolean wasNull() throws SQLException
Определяет, имел ли последний прочитанный параметр OUT значение SQL NULL. Обратите внимание, что этот метод следует вызывать только после вызова метода получения значения; в противном случае отсутствует значение, по которому можно определить, является ли оно null.
Возвращает:
true, если последний прочитанный параметр имел значение SQL NULL; в противном случае — false
Исключения:
SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

getString

String getString(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC CHAR, VARCHAR или LONGVARCHAR как String в языке программирования Java.

Для типа фиксированной длины JDBC CHAR возвращённый объект String имеет точно такое же значение, какое имело значение SQL CHAR в базе данных, включая добавленные базой данных символы-заполнители.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setString(String, String)

getBoolean

boolean getBoolean(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC BIT или BOOLEAN как boolean в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет false.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setBoolean(String, boolean)

getByte

byte getByte(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC TINYINT как byte в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setByte(String, byte)

getShort

short getShort(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC SMALLINT как short в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setShort(String, short)

getInt

int getInt(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC INTEGER как int в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setInt(String, int)

getLong

long getLong(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC BIGINT как long в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setLong(String, long)

getFloat

float getFloat(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC FLOAT как float в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setFloat(String, float)

getDouble

double getDouble(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC DOUBLE как double в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setDouble(String, double)

getBigDecimal

@Deprecated(since="1.2") BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException
Устарело.
используйте getBigDecimal(int parameterIndex) или getBigDecimal(String parameterName)
Извлекает значение указанного параметра JDBC NUMERIC как объект java.math.BigDecimal с scale цифрами справа от десятичной точки.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
scale — число цифр справа от десятичной точки
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
См. также:
  • setBigDecimal(String, BigDecimal)

getBytes

byte[] getBytes(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC BINARY или VARBINARY как массив значений byte в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setBytes(String, byte[])

getDate

Date getDate(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC DATE как объект java.sql.Date.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setDate(String, Date)

getTime

Time getTime(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC TIME как объект java.sql.Time.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setTime(String, Time)

getTimestamp

Timestamp getTimestamp(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC TIMESTAMP как объект java.sql.Timestamp.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • setTimestamp(String, Timestamp)

getObject

Object getObject(int parameterIndex) throws SQLException
Извлекает значение указанного параметра как Object в языке программирования Java. Если значение имеет тип SQL NULL, драйвер возвращает объект Java null.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для этого параметра с помощью метода registerOutParameter. Зарегистрировав целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения абстрактных типов данных, специфичных для базы данных.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
объект java.lang.Object, содержащий значение параметра OUT
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
  • Types
  • setObject(String, Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC NUMERIC как объект java.math.BigDecimal со всеми цифрами справа от десятичной точки, содержащимися в значении.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра с полной точностью. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
Начиная с версии:
1.2
См. также:
  • setBigDecimal(String, BigDecimal)

getObject

Object getObject(int parameterIndex, Map<String,Class<?>> map) throws SQLException
Возвращает объект, представляющий значение параметра OUT parameterIndex, и использует map для пользовательского сопоставления значения параметра.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для этого параметра с помощью метода registerOutParameter. Зарегистрировав целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения абстрактных типов данных, специфичных для базы данных.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
map — сопоставление имён типов SQL с классами Java
Возвращает:
объект java.lang.Object, содержащий значение параметра OUT
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:
1.2
См. также:
  • setObject(String, Object, int, int)

getRef

Ref getRef(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC REF(<structured-type>) как объект Ref в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра как объект Ref в языке программирования Java. Если значением был SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:
1.2

getBlob

Blob getBlob(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC BLOB как объект Blob в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра как объект Blob в языке программирования Java. Если значением был SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:
1.2

getClob

Clob getClob(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC CLOB как объект java.sql.Clob в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра как объект Clob в языке программирования Java. Если значением был SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:
1.2

getArray

Array getArray(int parameterIndex) throws SQLException
Извлекает значение указанного параметра JDBC ARRAY как объект Array в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
Возвращает:
значение параметра как объект Array в языке программирования Java. Если значением был SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:
1.2

getDate

Date getDate(int parameterIndex, Calendar cal) throws SQLException
Извлекает значение указанного параметра JDBC DATE как объект java.sql.Date, используя переданный объект Calendar для создания даты. С помощью объекта Calendar драйвер может вычислить дату с учётом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
cal — объект Calendar, который драйвер будет использовать для создания даты
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
Начиная с версии:
1.2
См. также:
  • setDate(String, Date)

getTime

Time getTime(int parameterIndex, Calendar cal) throws SQLException
Извлекает значение указанного параметра JDBC TIME как объект java.sql.Time, используя переданный объект Calendar для создания времени. С помощью объекта Calendar драйвер может вычислить время с учётом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
cal — объект Calendar, который драйвер будет использовать для создания времени
Возвращает:
значение параметра; если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
Начиная с версии:
1.2
См. также:
  • setTime(String, Time)

getTimestamp

Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException
Извлекает значение указанного параметра JDBC TIMESTAMP как объект java.sql.Timestamp, используя переданный объект Calendar для создания объекта Timestamp. С помощью объекта Calendar драйвер может вычислить метку времени с учётом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
cal — объект Calendar, который драйвер будет использовать для создания метки времени
Возвращает:
значение параметра. Если значение — SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
Начиная с версии:
1.2
См. также:
  • setTimestamp(String, Timestamp)

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException
Регистрирует указанный выходной параметр. Эту версию метода registerOutParameter следует использовать для определяемого пользователем или REF выходного параметра. Примеры определяемых пользователем типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

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

Примечание: При чтении значения выходного параметра необходимо использовать метод получения, тип Java которого соответствует зарегистрированному SQL-типу параметра.

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.
sqlType — значение из Types
typeName — полное имя структурированного SQL-типа
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных
С версии:
1.2
См. также:
  • Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType) throws SQLException
Регистрирует параметр OUT с именем parameterName как тип JDBC sqlType. Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, заданный с помощью sqlType для параметра OUT, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Если ожидаемый тип JDBC, возвращаемый этому выходному параметру, является специфичным для данной базы данных, sqlType должен быть java.sql.Types.OTHER. Метод getObject(int) получает это значение.

Параметры:
parameterName — имя параметра
sqlType — код типа JDBC, определенный в java.sql.Types. Если параметр имеет тип JDBC NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных, либо если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException
Регистрирует параметр с именем parameterName как тип JDBC sqlType. Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, заданный с помощью sqlType для параметра OUT, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Эту версию registerOutParameter следует использовать, если параметр имеет тип JDBC NUMERIC или DECIMAL.

Параметры:
parameterName — имя параметра
sqlType — код SQL-типа, определенный в java.sql.Types.
scale — требуемое количество цифр справа от десятичной точки. Значение должно быть больше или равно нулю.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных, либо если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException
Регистрирует указанный выходной параметр. Эту версию метода registerOutParameter следует использовать для именованного пользователем или REF-параметра. Примеры именованных пользователем типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

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

Примечание: При чтении значения выходного параметра необходимо использовать метод getXXX, тип Java XXX которого соответствует зарегистрированному SQL-типу параметра.

Параметры:
parameterName — имя параметра
sqlType — значение из Types
typeName — полное имя структурированного SQL-типа
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если sqlType имеет тип данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, а драйвер JDBC не поддерживает этот тип данных, либо если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • Types

getURL

URL getURL(int parameterIndex) throws SQLException
Получает значение указанного параметра JDBC DATALINK в виде объекта java.net.URL.
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.
Возвращает:
объект java.net.URL, представляющий значение JDBC DATALINK, используемое для указанного параметра
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных, метод вызван для закрытого CallableStatement или возвращаемый URL не является допустимым URL на платформе Java
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • setURL(String, URL)

setURL

void setURL(String parameterName, URL val) throws SQLException
Устанавливает для указанного параметра заданный объект java.net.URL. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа DATALINK.
Параметры:
parameterName — имя параметра
val — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных; если метод вызван для закрытого CallableStatement или URL имеет неверный формат
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getURL(int)

setNull

void setNull(String parameterName, int sqlType) throws SQLException
Устанавливает для указанного параметра значение SQL NULL.

Примечание: Необходимо указать SQL-тип параметра.

Параметры:
parameterName — имя параметра
sqlType — код SQL-типа, определенный в java.sql.Types
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа boolean. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа BIT или BOOLEAN.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getBoolean(int)

setByte

void setByte(String parameterName, byte x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа byte. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа TINYINT.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getByte(int)

setShort

void setShort(String parameterName, short x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа short. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа SMALLINT.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getShort(int)

setInt

void setInt(String parameterName, int x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа int. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа INTEGER.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getInt(int)

setLong

void setLong(String parameterName, long x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа long. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа BIGINT.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getLong(int)

setFloat

void setFloat(String parameterName, float x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа float. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа FLOAT.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getFloat(int)

setDouble

void setDouble(String parameterName, double x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа double. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа DOUBLE.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getDouble(int)

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
Устанавливает для указанного параметра заданное значение java.math.BigDecimal. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа NUMERIC.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getBigDecimal(int, int)

setString

void setString(String parameterName, String x) throws SQLException
Устанавливает для указанного параметра заданное значение Java-типа String. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа VARCHAR или LONGVARCHAR (в зависимости от размера аргумента относительно ограничений драйвера на значения VARCHAR).
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getString(int)

setBytes

void setBytes(String parameterName, byte[] x) throws SQLException
Устанавливает для указанного параметра заданный массив байтов Java. При отправке данных в базу данных драйвер преобразует их в значение SQL-типа VARBINARY или LONGVARBINARY (в зависимости от размера аргумента относительно ограничений драйвера на значения VARBINARY).
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getBytes(int)

setDate

void setDate(String parameterName, Date x) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Date, используя часовой пояс по умолчанию виртуальной машины, в которой выполняется приложение. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа DATE.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getDate(int)

setTime

void setTime(String parameterName, Time x) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Time. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа TIME.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getTime(int)

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Timestamp. При отправке значения в базу данных драйвер преобразует его в значение SQL-типа TIMESTAMP.
Параметры:
parameterName — имя параметра
x — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4
См. также:
  • getTimestamp(int)

setAsciiStream

void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
Устанавливает для указанного параметра заданный входной поток, содержащий указанное количество байтов. Если в параметр LONGVARCHAR вводится очень большое значение ASCII, может быть удобнее передать его через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование ASCII в символьный формат базы данных.

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий значение параметра ASCII
length — количество байтов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4

setBinaryStream

void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
Устанавливает для указанного параметра заданный входной поток, содержащий указанное количество байтов. Если в параметр LONGVARBINARY вводится очень большое двоичное значение, может быть удобнее передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий двоичное значение параметра
length — количество байтов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.4

setObject

void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
Устанавливает значение указанного параметра с помощью заданного объекта.

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

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

Параметры:
parameterName — имя параметра
x — объект, содержащий значение входного параметра
targetSqlType — SQL-тип (определенный в java.sql.Types), который будет передан базе данных. Аргумент scale может дополнительно уточнять этот тип.
scale — для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC это количество цифр после десятичной точки. Для всех остальных типов это значение игнорируется.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный targetSqlType
С версии:
1.4
См. также:
  • Types
  • getObject(int)

setObject

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
Устанавливает значение указанного параметра с помощью заданного объекта. Этот метод аналогичен setObject(String parameterName, Object x, int targetSqlType, int scaleOrLength), за исключением того, что предполагает масштаб, равный нулю.
Параметры:
parameterName — имя параметра
x — объект, содержащий значение входного параметра
targetSqlType — тип SQL (определённый в java.sql.Types), который будет передан базе данных
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный targetSqlType
Начиная с:
1.4
См. также:
  • getObject(int)

setObject

void setObject(String parameterName, Object x) throws SQLException
Устанавливает значение указанного параметра с помощью заданного объекта.

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

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

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

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

Параметры:
parameterName — имя параметра
x — объект, содержащий значение входного параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных, этот метод вызван для закрытого CallableStatement или заданный параметр Object неоднозначен
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • getObject(int)

setCharacterStream

void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
Устанавливает для указанного параметра заданный объект Reader длиной в указанное количество символов. Если в параметр LONGVARCHAR вводится очень большое значение UNICODE, практичнее передать его с помощью объекта java.io.Reader. Данные считываются из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит все необходимые преобразования из UNICODE в символьный формат базы данных.

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

Параметры:
parameterName — имя параметра
reader — объект java.io.Reader, содержащий данные UNICODE, используемые в качестве указанного параметра
length — количество символов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

setDate

void setDate(String parameterName, Date x, Calendar cal) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Date, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL DATE, которое затем отправляет в базу данных. С объектом Calendar драйвер может вычислить дату с учётом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.
Параметры:
parameterName — имя параметра
x — значение параметра
cal — объект Calendar, который драйвер будет использовать для создания даты
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • getDate(int)

setTime

void setTime(String parameterName, Time x, Calendar cal) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Time, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIME, которое затем отправляет в базу данных. С объектом Calendar драйвер может вычислить время с учётом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.
Параметры:
parameterName — имя параметра
x — значение параметра
cal — объект Calendar, который драйвер будет использовать для создания времени
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • getTime(int)

setTimestamp

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
Устанавливает для указанного параметра заданное значение java.sql.Timestamp, используя заданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIMESTAMP, которое затем отправляет в базу данных. С объектом Calendar драйвер может вычислить временную метку с учётом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.
Параметры:
parameterName — имя параметра
x — значение параметра
cal — объект Calendar, который драйвер будет использовать для создания временной метки
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • getTimestamp(int)

setNull

void setNull(String parameterName, int sqlType, String typeName) throws SQLException
Устанавливает для указанного параметра значение SQL NULL. Эта версия метода setNull должна использоваться для пользовательских типов и параметров типа REF. Примеры пользовательских типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Примечание: Для обеспечения переносимости приложения должны указывать код типа SQL и полное имя типа SQL при задании пользовательского параметра NULL или параметра REF. Для пользовательского типа указывается имя самого типа параметра. Для параметра REF указывается имя типа, на который он ссылается.

Хотя этот метод предназначен для пользовательских параметров и параметров Ref, его можно использовать для установки параметра null любого типа JDBC. Если параметр не имеет пользовательского типа или типа REF, заданный typeName игнорируется.

Параметры:
parameterName — имя параметра
sqlType — значение из java.sql.Types
typeName — полное имя пользовательского типа SQL; игнорируется, если параметр не имеет пользовательского типа или не является значением SQL REF
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

getString

String getString(String parameterName) throws SQLException
Извлекает значение параметра JDBC CHAR, VARCHAR или LONGVARCHAR в виде String в языке программирования Java.

Для типа JDBC фиксированной длины CHAR возвращаемый объект String имеет в точности то же значение, что и значение SQL CHAR в базе данных, включая добавленные базой данных пробелы.

Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setString(String, String)

getBoolean

boolean getBoolean(String parameterName) throws SQLException
Извлекает значение параметра JDBC BIT или BOOLEAN в виде boolean в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет false.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setBoolean(String, boolean)

getByte

byte getByte(String parameterName) throws SQLException
Извлекает значение параметра JDBC TINYINT в виде byte в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setByte(String, byte)

getShort

short getShort(String parameterName) throws SQLException
Извлекает значение параметра JDBC SMALLINT в виде short в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setShort(String, short)

getInt

int getInt(String parameterName) throws SQLException
Извлекает значение параметра JDBC INTEGER в виде int в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setInt(String, int)

getLong

long getLong(String parameterName) throws SQLException
Извлекает значение параметра JDBC BIGINT в виде long в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setLong(String, long)

getFloat

float getFloat(String parameterName) throws SQLException
Извлекает значение параметра JDBC FLOAT в виде float в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setFloat(String, float)

getDouble

double getDouble(String parameterName) throws SQLException
Извлекает значение параметра JDBC DOUBLE в виде double в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет 0.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setDouble(String, double)

getBytes

byte[] getBytes(String parameterName) throws SQLException
Извлекает значение параметра JDBC BINARY или VARBINARY в виде массива значений byte в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setBytes(String, byte[])

getDate

Date getDate(String parameterName) throws SQLException
Извлекает значение параметра JDBC DATE в виде объекта java.sql.Date.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setDate(String, Date)

getTime

Time getTime(String parameterName) throws SQLException
Извлекает значение параметра JDBC TIME в виде объекта java.sql.Time.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setTime(String, Time)

getTimestamp

Timestamp getTimestamp(String parameterName) throws SQLException
Извлекает значение параметра JDBC TIMESTAMP в виде объекта java.sql.Timestamp.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setTimestamp(String, Timestamp)

getObject

Object getObject(String parameterName) throws SQLException
Извлекает значение параметра в виде Object в языке программирования Java. Если значение является значением SQL NULL, драйвер возвращает объект Java null.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для данного параметра с помощью метода registerOutParameter. Зарегистрировав целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения абстрактных типов данных, специфичных для базы данных.

Параметры:
parameterName — имя параметра
Возвращает:
Объект java.lang.Object, содержащий значение выходного параметра.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • Types
  • setObject(String, Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(String parameterName) throws SQLException
Извлекает значение параметра JDBC NUMERIC в виде объекта java.math.BigDecimal с таким же количеством цифр после десятичной точки, какое содержится в значении.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра с полной точностью. Если значение равно SQL NULL, результатом будет null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setBigDecimal(String, BigDecimal)

getObject

Object getObject(String parameterName, Map<String,Class<?>> map) throws SQLException
Возвращает объект, представляющий значение выходного параметра parameterName, и использует map для пользовательского сопоставления значения параметра.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для данного параметра с помощью метода registerOutParameter. Зарегистрировав целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения абстрактных типов данных, специфичных для базы данных.

Параметры:
parameterName — имя параметра
map — сопоставление имён типов SQL с классами Java
Возвращает:
объект java.lang.Object, содержащий значение выходного параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setObject(String, Object, int, int)

getRef

Ref getRef(String parameterName) throws SQLException
Извлекает значение параметра JDBC REF(<structured-type>) в виде объекта Ref в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта Ref в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

getBlob

Blob getBlob(String parameterName) throws SQLException
Извлекает значение параметра JDBC BLOB в виде объекта Blob в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта Blob в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

getClob

Clob getClob(String parameterName) throws SQLException
Извлекает значение параметра JDBC CLOB в виде объекта java.sql.Clob в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта Clob в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

getArray

Array getArray(String parameterName) throws SQLException
Возвращает значение параметра JDBC ARRAY в виде объекта Array в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта Array в языке программирования Java. Если значением было SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4

getDate

Date getDate(String parameterName, Calendar cal) throws SQLException
Возвращает значение параметра JDBC DATE в виде объекта java.sql.Date, используя переданный объект Calendar для создания даты. С помощью объекта Calendar драйвер может вычислить дату с учетом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterName — имя параметра
cal — объект Calendar, который драйвер будет использовать для создания даты
Возвращает:
значение параметра. Если значением является SQL NULL, результатом будет null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setDate(String, Date)

getTime

Time getTime(String parameterName, Calendar cal) throws SQLException
Возвращает значение параметра JDBC TIME в виде объекта java.sql.Time, используя переданный объект Calendar для создания времени. С помощью объекта Calendar драйвер может вычислить время с учетом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterName — имя параметра
cal — объект Calendar, который драйвер будет использовать для создания времени
Возвращает:
значение параметра; если значением является SQL NULL, результатом будет null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setTime(String, Time)

getTimestamp

Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException
Возвращает значение параметра JDBC TIMESTAMP в виде объекта java.sql.Timestamp, используя переданный объект Calendar для создания объекта Timestamp. С помощью объекта Calendar драйвер может вычислить временную метку с учетом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.
Параметры:
parameterName — имя параметра
cal — объект Calendar, который драйвер будет использовать для создания временной метки
Возвращает:
значение параметра. Если значением является SQL NULL, результатом будет null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setTimestamp(String, Timestamp)

getURL

URL getURL(String parameterName) throws SQLException
Возвращает значение параметра JDBC DATALINK в виде объекта java.net.URL.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта java.net.URL в языке программирования Java. Если значением было SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных, этот метод вызван для закрытого CallableStatement или возникла проблема с URL
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
  • setURL(String, URL)

getRowId

RowId getRowId(int parameterIndex) throws SQLException
Возвращает значение указанного параметра JDBC ROWID в виде объекта java.sql.RowId.
Параметры:
parameterIndex — первый параметр имеет индекс 1, второй — 2 и т. д.
Возвращает:
объект RowId, представляющий значение JDBC ROWID, используемое в качестве указанного параметра. Если параметр содержит SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getRowId

RowId getRowId(String parameterName) throws SQLException
Возвращает значение указанного параметра JDBC ROWID в виде объекта java.sql.RowId.
Параметры:
parameterName — имя параметра
Возвращает:
объект RowId, представляющий значение JDBC ROWID, используемое в качестве указанного параметра. Если параметр содержит SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException
Устанавливает для указанного параметра переданный объект java.sql.RowId. При отправке значения в базу данных драйвер преобразует его в SQL ROWID.
Параметры:
parameterName — имя параметра
x — значение параметра
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setNString

void setNString(String parameterName, String value) throws SQLException
Устанавливает для указанного параметра переданный объект String. Драйвер преобразует его в SQL NCHAR или NVARCHAR или LONGNVARCHAR
Параметры:
parameterName — имя устанавливаемого параметра
value — значение параметра
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Устанавливает для указанного параметра объект Reader. Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных.
Параметры:
parameterName — имя устанавливаемого параметра
value — значение параметра
length — количество символов в данных параметра.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setNClob

void setNClob(String parameterName, NClob value) throws SQLException
Устанавливает для указанного параметра объект java.sql.NClob. Этот объект реализует интерфейс java.sql.NClob. Объект NClob соответствует SQL NCLOB.
Параметры:
parameterName — имя устанавливаемого параметра
value — значение параметра
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setClob

void setClob(String parameterName, Reader reader, long length) throws SQLException
Устанавливает для указанного параметра объект Reader. Объект reader должен содержать указанное в length количество символов, иначе при выполнении CallableStatement будет сгенерирован SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу: значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARCHAR или CLOB
Параметры:
parameterName — имя устанавливаемого параметра
reader — объект, содержащий данные для установки значения параметра.
length — количество символов в данных параметра.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если указанная длина меньше нуля; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setBlob

void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
Устанавливает для указанного параметра объект InputStream. Объект Inputstream должен содержать указанное в length количество символов, иначе при выполнении CallableStatement будет сгенерирован SQLException. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что сообщает драйверу: значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB
Параметры:
parameterName — имя устанавливаемого параметра; второй параметр имеет индекс 2 и т. д.
inputStream — объект, содержащий данные для установки значения параметра.
length — количество байтов в данных параметра.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если указанная длина меньше нуля; если количество байтов в InputStream не соответствует указанной длине; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setNClob

void setNClob(String parameterName, Reader reader, long length) throws SQLException
Устанавливает для указанного параметра объект Reader. Объект reader должен содержать указанное в length количество символов, иначе при выполнении CallableStatement будет сгенерирован SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB
Параметры:
parameterName — имя устанавливаемого параметра
reader — объект, содержащий данные для установки значения параметра.
length — количество символов в данных параметра.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getNClob

NClob getNClob(int parameterIndex) throws SQLException
Возвращает значение указанного параметра JDBC NCLOB в виде объекта java.sql.NClob в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет индекс 1, второй — 2 и т. д.
Возвращает:
значение параметра в виде объекта NClob в языке программирования Java. Если значением было SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterIndex недопустим; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getNClob

NClob getNClob(String parameterName) throws SQLException
Возвращает значение параметра JDBC NCLOB в виде объекта java.sql.NClob в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
значение параметра в виде объекта NClob в языке программирования Java. Если значением было SQL NULL, возвращается значение null.
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
Устанавливает для указанного параметра переданный объект java.sql.SQLXML. При отправке значения в базу данных драйвер преобразует его в значение SQL XML.
Параметры:
parameterName — имя параметра
xmlObject — объект SQLXML, соответствующий значению SQL XML
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого CallableStatement или java.xml.transform.Result, Writer или OutputStream для объекта SQLXML не был закрыт
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getSQLXML

SQLXML getSQLXML(int parameterIndex) throws SQLException
Возвращает значение указанного параметра SQL XML в виде объекта java.sql.SQLXML в языке программирования Java.
Параметры:
parameterIndex — индекс первого параметра — 1, второго — 2 и т. д.
Возвращает:
объект SQLXML, соответствующий значению SQL XML
Вызывает:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getSQLXML

SQLXML getSQLXML(String parameterName) throws SQLException
Возвращает значение указанного параметра SQL XML в виде объекта java.sql.SQLXML в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
объект SQLXML, соответствующий значению SQL XML
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getNString

String getNString(int parameterIndex) throws SQLException
Возвращает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR в виде String в языке программирования Java.

Для JDBC-типа фиксированной длины NCHAR возвращаемый объект String имеет точно такое же значение, какое имело в базе данных значение SQL NCHAR, включая любое дополнение, добавленное базой данных.

Параметры:
parameterIndex — индекс первого параметра — 1, второго — 2 и т. д.
Возвращает:
объект String, соответствующий значению NCHAR, NVARCHAR или LONGNVARCHAR
Вызывает:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6
См. также:
  • setNString(String, String)

getNString

String getNString(String parameterName) throws SQLException
Возвращает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR в виде String в языке программирования Java.

Для JDBC-типа фиксированной длины NCHAR возвращаемый объект String имеет точно такое же значение, какое имело в базе данных значение SQL NCHAR, включая любое дополнение, добавленное базой данных.

Параметры:
parameterName — имя параметра
Возвращает:
объект String, соответствующий значению NCHAR, NVARCHAR или LONGNVARCHAR
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6
См. также:
  • setNString(String, String)

getNCharacterStream

Reader getNCharacterStream(int parameterIndex) throws SQLException
Возвращает значение указанного параметра в виде объекта java.io.Reader в языке программирования Java. Предназначен для доступа к параметрам NCHAR,NVARCHAR и LONGNVARCHAR.
Параметры:
parameterIndex — первый параметр имеет индекс 1, второй — 2 и т. д.
Возвращает:
объект java.io.Reader, содержащий значение параметра; если значением является SQL NULL, возвращается значение null в языке программирования Java.
Вызывает:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getNCharacterStream

Reader getNCharacterStream(String parameterName) throws SQLException
Возвращает значение указанного параметра в виде объекта java.io.Reader в языке программирования Java. Предназначен для доступа к параметрам NCHAR,NVARCHAR и LONGNVARCHAR.
Параметры:
parameterName — имя параметра
Возвращает:
объект java.io.Reader, содержащий значение параметра; если значением является SQL NULL, возвращается значение null в языке программирования Java
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

getCharacterStream

Reader getCharacterStream(int parameterIndex) throws SQLException
Возвращает значение указанного параметра в виде объекта java.io.Reader в языке программирования Java.
Параметры:
parameterIndex — первый параметр имеет индекс 1, второй — 2 и т. д.
Возвращает:
объект java.io.Reader, содержащий значение параметра; если значением является SQL NULL, возвращается значение null в языке программирования Java.
Вызывает:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
Начиная с:
1.6

getCharacterStream

Reader getCharacterStream(String parameterName) throws SQLException
Возвращает значение указанного параметра в виде объекта java.io.Reader в языке программирования Java.
Параметры:
parameterName — имя параметра
Возвращает:
объект java.io.Reader, содержащий значение параметра; если значением является SQL NULL, возвращается значение null в языке программирования Java
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setBlob

void setBlob(String parameterName, Blob x) throws SQLException
Устанавливает для указанного параметра переданный объект java.sql.Blob. При отправке значения в базу данных драйвер преобразует его в значение SQL BLOB.
Параметры:
parameterName — имя параметра
x — объект Blob, соответствующий значению SQL BLOB
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setClob

void setClob(String parameterName, Clob x) throws SQLException
Устанавливает для указанного параметра переданный объект java.sql.Clob. При отправке значения в базу данных драйвер преобразует его в значение SQL CLOB.
Параметры:
parameterName — имя параметра
x — объект Clob, соответствующий значению SQL CLOB
Вызывает:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:
1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException
Устанавливает для указанного параметра заданный входной поток, содержащий указанное количество байтов. Если в параметр LONGVARCHAR вводится очень большое значение ASCII, практичнее может оказаться передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из ASCII в формат символов базы данных.

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий значение параметра ASCII
length — количество байтов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException
Устанавливает для указанного параметра заданный входной поток, содержащий указанное количество байтов. Если в параметр LONGVARBINARY вводится очень большое двоичное значение, практичнее может оказаться передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий двоичное значение параметра
length — количество байтов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException
Устанавливает для указанного параметра заданный объект Reader указанной длины в символах. Если в параметр LONGVARCHAR вводится очень большое значение UNICODE, практичнее может оказаться передать его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

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

Параметры:
parameterName — имя параметра
reader — объект java.io.Reader, содержащий данные UNICODE, используемые в качестве указанного параметра
length — количество символов в потоке
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException
Устанавливает для указанного параметра заданный входной поток. Если в параметр LONGVARCHAR вводится очень большое значение ASCII, практичнее может оказаться передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из ASCII в формат символов базы данных.

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

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий значение параметра ASCII
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException
Устанавливает для указанного параметра заданный входной поток. Если в параметр LONGVARBINARY вводится очень большое двоичное значение, практичнее может оказаться передать его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

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

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

Параметры:
parameterName — имя параметра
x — входной поток Java, содержащий двоичное значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException
Устанавливает для указанного параметра заданный объект Reader. Если в параметр LONGVARCHAR вводится очень большое значение UNICODE, практичнее может оказаться передать его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

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

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

Параметры:
parameterName — имя параметра
reader — объект java.io.Reader, содержащий данные Unicode
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException
Устанавливает для указанного параметра объект Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных.

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

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

Параметры:
parameterName — имя параметра
value — значение параметра
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможно возникновение ошибки преобразования данных; если произошла ошибка доступа к базе данных; или если этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setClob

void setClob(String parameterName, Reader reader) throws SQLException
Устанавливает для указанного параметра объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу: значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу, возможно, придется выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARCHAR или CLOB.

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

Параметры:
parameterName — имя параметра
reader — объект, содержащий данные, которые следует установить в качестве значения параметра.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException
Устанавливает для указанного параметра объект InputStream. Этот метод отличается от метода setBinaryStream (int, InputStream) тем, что сообщает драйверу: значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу, возможно, придется выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARBINARY или BLOB.

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

Параметры:
parameterName — имя параметра
inputStream — объект, содержащий данные, которые следует установить в качестве значения параметра.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException
Устанавливает для указанного параметра объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу, возможно, придется выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGNVARCHAR или NCLOB.

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

Параметры:
parameterName — имя параметра
reader — объект, содержащий данные, которые следует установить в качестве значения параметра.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможно возникновение ошибки преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.6

getObject

<T> T getObject(int parameterIndex, Class<T> type) throws SQLException
Возвращает объект, представляющий значение выходного параметра parameterIndex, и преобразует SQL-тип параметра в запрошенный тип данных Java, если такое преобразование поддерживается. Если преобразование не поддерживается или для типа указано значение null, генерируется SQLException.

Как минимум, реализация должна поддерживать преобразования, определенные в приложении B, таблице B-3, а также преобразование соответствующих пользовательских типов SQL в тип Java, реализующий SQLData или Struct. Дополнительные преобразования могут поддерживаться и определяются поставщиком.

Параметры типа:
T — тип класса, моделируемого этим объектом Class
Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
type — класс, представляющий тип данных Java, в который следует преобразовать указанный параметр.
Возвращает:
экземпляр type, содержащий значение выходного параметра
Исключения:
SQLException — если преобразование не поддерживается, type имеет значение null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробную информацию, например, если произошла ошибка преобразования
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.7

getObject

<T> T getObject(String parameterName, Class<T> type) throws SQLException
Возвращает объект, представляющий значение выходного параметра parameterName, и преобразует SQL-тип параметра в запрошенный тип данных Java, если такое преобразование поддерживается. Если преобразование не поддерживается или для типа указано значение null, генерируется SQLException.

Как минимум, реализация должна поддерживать преобразования, определенные в приложении B, таблице B-3, а также преобразование соответствующих пользовательских типов SQL в тип Java, реализующий SQLData или Struct. Дополнительные преобразования могут поддерживаться и определяются поставщиком.

Параметры типа:
T — тип класса, моделируемого этим объектом Class
Параметры:
parameterName — имя параметра
type — класс, представляющий тип данных Java, в который следует преобразовать указанный параметр.
Возвращает:
экземпляр type, содержащий значение выходного параметра
Исключения:
SQLException — если преобразование не поддерживается, type имеет значение null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробную информацию, например, если произошла ошибка преобразования
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:
1.7

setObject

default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Устанавливает значение указанного параметра, используя заданный объект. Если второй аргумент является InputStream, поток должен содержать количество байтов, указанное в scaleOrLength. Если второй аргумент является Reader, объект чтения должен содержать количество символов, указанное в scaleOrLength. Если эти условия не выполнены, при выполнении подготовленного оператора драйвер сгенерирует SQLException.

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

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

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterName — имя параметра
x — объект, содержащий значение входного параметра
targetSqlType — тип SQL, который следует передать базе данных. Аргумент scale может дополнительно уточнять этот тип.
scaleOrLength — для java.sql.JDBCType.DECIMAL или java.sql.JDBCType.NUMERIC types это количество цифр после десятичной точки. Для типов объектов Java InputStream и Reader это длина данных в потоке или объекте чтения. Для всех остальных типов это значение игнорируется.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого CallableStatement; либо если указанный Java-объект x является объектом InputStream или Reader, а значение параметра scale меньше нуля
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный targetSqlType
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

setObject

default void setObject(String parameterName, Object x, SQLType targetSqlType) throws SQLException
Устанавливает значение указанного параметра, используя заданный объект. Этот метод аналогичен методу setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength), за исключением того, что предполагает значение scale, равное нулю.

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterName — имя параметра
x — объект, содержащий значение входного параметра
targetSqlType — тип SQL, который следует передать базе данных
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный targetSqlType
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException
Регистрирует выходной параметр с порядковым номером parameterIndex как параметр типа JDBC sqlType. Все выходные параметры необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный с помощью sqlType для выходного параметра, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Если тип JDBC, который должен возвращаться для этого выходного параметра, специфичен для данной базы данных, sqlType может быть JDBCType.OTHER или SQLType, поддерживаемым драйвером JDBC. Значение извлекается методом getObject(int).

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра. Если параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL, следует использовать версию registerOutParameter, принимающую значение scale.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException
Регистрирует параметр с порядковым номером parameterIndex как параметр типа JDBC sqlType. Все выходные параметры необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный с помощью sqlType для выходного параметра, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Эту версию registerOutParameter следует использовать, если параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL.

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра.
scale — требуемое количество цифр справа от десятичной точки. Значение должно быть больше или равно нулю.
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException
Регистрирует указанный выходной параметр. Эту версию метода registerOutParameter следует использовать для пользовательского или REF выходного параметра. Примеры пользовательских типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все выходные параметры необходимо зарегистрировать до выполнения хранимой процедуры.

Для пользовательского параметра также следует указать полное имя типа SQL параметра, а для параметра REF необходимо указать полное имя типа, на который он ссылается. Драйвер JDBC, которому не нужны сведения о коде и имени типа, может их игнорировать. Однако для обеспечения переносимости приложениям всегда следует указывать эти значения для пользовательских параметров и параметров REF. Хотя этот метод предназначен для пользовательских параметров и параметров REF, его можно использовать для регистрации параметра любого типа JDBC. Если параметр не имеет пользовательского типа или типа REF, параметр typeName игнорируется.

Примечание: При чтении значения выходного параметра необходимо использовать метод получения, тип Java которого соответствует зарегистрированному типу SQL параметра.

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterIndex — первый параметр имеет номер 1, второй — 2 и так далее
sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра.
typeName — полное имя структурированного типа SQL
Исключения:
SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException
Регистрирует выходной параметр с именем parameterName как параметр типа JDBC sqlType. Все выходные параметры необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный с помощью sqlType для выходного параметра, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Если тип JDBC, который должен возвращаться для этого выходного параметра, специфичен для данной базы данных, sqlType должен быть JDBCType.OTHER или SQLType, поддерживаемым драйвером JDBC. Значение извлекается методом getObject(int).

Реализация по умолчанию генерирует SQLFeatureNotSupportedException

Параметры:
parameterName — имя параметра
sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра. Если параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL, следует использовать версию registerOutParameter, принимающую значение scale.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType или этот метод
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException
Регистрирует параметр с именем parameterName как параметр типа JDBC sqlType. Все выходные параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

Тип JDBC, указанный для выходного параметра с помощью sqlType, определяет тип Java, который необходимо использовать в методе get для чтения значения этого параметра.

Эту версию registerOutParameter следует использовать, если параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL.

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

Параметры:
parameterName — имя параметра
sqlType — код типа JDBC, определенный в SQLType, который используется для регистрации выходного параметра OUT.
scale — требуемое количество цифр справа от десятичной точки. Оно должно быть больше или равно нулю.
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType или этот метод
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException
Регистрирует указанный выходной параметр. Эту версию метода registerOutParameter следует использовать для параметров с именованным пользователем типом или параметров REF. Примеры типов с именованным пользователем типом: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все выходные параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

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

Примечание: При чтении значения выходного параметра необходимо использовать метод getXXX, тип Java XXX которого соответствует зарегистрированному типу SQL параметра.

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

Параметры:
parameterName — имя параметра
sqlType — код типа JDBC, определенный в SQLType, который используется для регистрации выходного параметра OUT.
typeName — полное имя структурированного типа SQL
Исключения:
SQLException — если parameterName не соответствует именованному параметру; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого CallableStatement
SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает указанный sqlType или этот метод
С версии:
1.8
См. также:
  • JDBCType
  • SQLType

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API