Интерфейс SQLInput

public interface SQLInput

Поток ввода, содержащий поток значений, представляющих экземпляр SQL-структурированного типа или SQL-различимого типа. Этот интерфейс, используемый только для пользовательской сопоставления, используется драйвером за кулисами, и программист никогда напрямую не вызывает SQLInput методы. Методы reader (readLong, readBytes, и т.д.) предоставляют способ для реализации SQLData интерфейса читать значения в SQLInput объекте. И, как описано в SQLData, вызовы методов reader должны выполняться в том порядке, в котором соответствующие атрибуты появляются в SQL-определении типа. Метод wasNull используется для определения, было ли последнее прочитанное значение SQL NULL.

Когда метод getObject вызывается с объектом класса, реализующего интерфейс SQLData, драйвер JDBC вызывает метод SQLData.getSQLType для определения SQL-типа пользовательского типа (UDT), который подвергается пользовательскому сопоставлению. Драйвер создает экземпляр SQLInput, заполняя его атрибутами UDT. Затем драйвер передает поток ввода методу SQLData.readSQL, который в свою очередь вызывает SQLInput методы reader в своей реализации для чтения атрибутов из потока ввода.

Методы

readString

String readString()
           throws SQLException

Считывает следующий атрибут в потоке и возвращает его как строку в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readBoolean

boolean readBoolean()
             throws SQLException

Считывает следующий атрибут в потоке и возвращает его как логическое значение в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает false

Исключения:

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

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

С тех пор:

1.2

readByte

byte readByte()
       throws SQLException

Считывает следующий атрибут в потоке и возвращает его как байт в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readShort

short readShort()
         throws SQLException

Считывает следующий атрибут в потоке и возвращает его как короткое целое число в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readInt

int readInt()
     throws SQLException

Считывает следующий атрибут в потоке и возвращает его как целое число в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readLong

long readLong()
       throws SQLException

Считывает следующий атрибут в потоке и возвращает его как длинное целое число в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readFloat

float readFloat()
         throws SQLException

Считывает следующий атрибут в потоке и возвращает его как число с плавающей точкой в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readDouble

double readDouble()
           throws SQLException

Считывает следующий атрибут в потоке и возвращает его как число двойной точности в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает 0

Исключения:

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

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

С тех пор:

1.2

readBigDecimal

BigDecimal readBigDecimal()
                   throws SQLException

Считывает следующий атрибут в потоке и возвращает его как объект BigDecimal в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readBytes

byte[] readBytes()
          throws SQLException

Считывает следующий атрибут в потоке и возвращает его как массив байтов в языке программирования Java.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readDate

Date readDate()
       throws SQLException

Считывает следующий атрибут в потоке и возвращает его как объект Date.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readTime

Time readTime()
       throws SQLException

Считывает следующий атрибут в потоке и возвращает его как объект Time.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readTimestamp

Timestamp readTimestamp()
                 throws SQLException

Считывает следующий атрибут в потоке и возвращает его как объект Timestamp.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readCharacterStream

Reader readCharacterStream()
                    throws SQLException

Считывает следующий атрибут в потоке и возвращает его как поток символов Unicode.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readAsciiStream

InputStream readAsciiStream()
                     throws SQLException

Считывает следующий атрибут в потоке и возвращает его как поток символов ASCII.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readBinaryStream

InputStream readBinaryStream()
                      throws SQLException

Считывает следующий атрибут в потоке и возвращает его как поток необработанных байтов.

Возвращает:

атрибут; если значение является SQL NULL, возвращает null

Исключения:

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

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

С тех пор:

1.2

readObject

Object readObject()
           throws SQLException

Возвращает:

данные в начале потока как объект в языке программирования Java;null если данные являются SQL NULL

Исключения:

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

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

С тех пор:

1.2

readRef

Ref readRef()
     throws SQLException

Считывает значение SQL REF из потока и возвращает его как объект Ref в языке программирования Java.

Возвращает:

объект Ref, представляющий значение SQL REF в начале потока; null если прочитанное значение является SQL NULL

Исключения:

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

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

С тех пор:

1.2

readBlob

Blob readBlob()
       throws SQLException

Считывает значение SQL BLOB из потока и возвращает его как объект Blob в языке программирования Java.

Возвращает:

объект Blob, представляющий данные значения SQL BLOB в начале потока; null если прочитанное значение является SQL NULL

Исключения:

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

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

С тех пор:

1.2

readClob

Clob readClob()
       throws SQLException

Считывает значение SQL CLOB из потока и возвращает его как объект Clob в языке программирования Java.

Возвращает:

объект Clob, представляющий данные значения SQL CLOB в начале потока; null если прочитанное значение является SQL NULL

Исключения:

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

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

С тех пор:

1.2

readArray

Array readArray()
         throws SQLException

Считывает значение SQL ARRAY из потока и возвращает его в виде объекта Array на языке программирования Java.

Возвращает:

объект Array, представляющий данные значения SQL ARRAY в начале потока; null если считанное значение — SQL NULL

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.2

wasNull

boolean wasNull()
         throws SQLException

Возвращает, было ли последнее считанное значение SQL NULL.

Возвращает:

true если последнее считанное значение SQL было SQL NULL; false в противном случае

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.2

readURL

URL readURL()
     throws SQLException

Считывает значение SQL DATALINK из потока и возвращает его в виде объекта java.net.URL на языке программирования Java.

Возвращает:

объект java.net.URL.

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных или URL некорректен

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

С момента:

1.4

readNClob

NClob readNClob()
         throws SQLException

Считывает значение SQL NCLOB из потока и возвращает его в виде объекта NClob на языке программирования Java.

Возвращает:

объект NClob, представляющий данные значения SQL NCLOB в начале потока; null если считанное значение — SQL NULL

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.6

readNString

String readNString()
            throws SQLException

Считывает следующий атрибут из потока и возвращает его как String на языке программирования Java. Предназначен для использования при доступе к столбцам NCHAR, NVARCHAR и LONGNVARCHAR.

Возвращает:

атрибут; если значение — SQL NULL, возвращает null

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.6

readSQLXML

SQLXML readSQLXML()
           throws SQLException

Считывает значение SQL XML из потока и возвращает его в виде объекта SQLXML на языке программирования Java.

Возвращает:

объект SQLXML, представляющий данные значения SQL XML в начале потока; null если считанное значение — SQL NULL

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.6

readRowId

RowId readRowId()
         throws SQLException

Считывает значение SQL ROWID из потока и возвращает его в виде объекта RowId на языке программирования Java.

Возвращает:

объект RowId, представляющий данные значения SQL ROWID в начале потока; null если считанное значение — SQL NULL

Использует исключения:

SQLException — если произошла ошибка доступа к базе данных

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

С момента:

1.6

readObject

default <T> T readObject(Class<T> type)
                  throws SQLException

Параметры типа:

T - тип класса, моделируемого этим объектом Class

Параметры:

type - класс, представляющий тип данных Java, в который необходимо преобразовать атрибут.

Возвращает:

атрибут в начале потока как Object на языке программирования Java; null если атрибут является SQL NULL

Использует исключения:

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

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

С момента:

1.8