Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Blob
BLOB
значение. SQL BLOB
встроенный тип, который хранит Большой двоичный объект как значение столбца подряд таблицы базы данных. Реализацией драйверов значения по умолчанию Blob
использование SQL locator(BLOB)
, что означает это a Blob
объект содержит логический указатель на SQL BLOB
данные, а не данные непосредственно. A Blob
объект допустим для продолжительности транзакции, в которой, создавался. Методы в интерфейсах ResultSet
, CallableStatement
, и PreparedStatement
, такой как getBlob
и setBlob
позвольте программисту получать доступ к SQL BLOB
значение. Blob
интерфейс обеспечивает методы для того, чтобы они получили длину SQL BLOB
(Большой двоичный объект) значение, для того, чтобы осуществить a BLOB
значение на клиенте, и для того, чтобы определить позицию образца байтов в пределах a BLOB
значение. Кроме того, у этого интерфейса есть методы для того, чтобы обновить a BLOB
значение.
Все методы на Blob
интерфейс должен быть полностью реализован, если драйвер JDBC поддерживает тип данных.
Модификатор и Тип | Метод и Описание |
---|---|
void |
free()
Этот метод освобождает
Blob возразите и высвобождает средства, которые это содержит. |
InputStream |
getBinaryStream()
Получает
BLOB значение определяется этим Blob экземпляр как поток. |
InputStream |
getBinaryStream(long pos, long length)
Возвраты
InputStream объект, который содержит частичное Blob значение, запускающееся с байта, определенного на месте продажи, который является байтами длины в длине. |
byte[] |
getBytes(long pos, int length)
Получает все или часть
BLOB значение, что это Blob объект представляет как массив байтов. |
long |
length()
Возвращает число байтов в
BLOB значение определяется этим Blob объект. |
long |
position(Blob pattern, long start)
Получает позицию байта в
BLOB значение определяется этим Blob объект тот, в который pattern начинается. |
long |
position(byte[] pattern, long start)
Получает позицию байта в который указанный байтовый массив
pattern начинается в пределах BLOB значение, что это Blob объект представляет. |
OutputStream |
setBinaryStream(long pos)
Получает поток, который может использоваться, чтобы записать в
BLOB значение, что это Blob объект представляет. |
int |
setBytes(long pos, byte[] bytes)
Пишет данный массив байтов к
BLOB значение, что это Blob объект представляет, запускаясь в позиции pos , и возвращает число записанных байтов. |
int |
setBytes(long pos, byte[] bytes, int offset, int len)
Записи все или часть данного
byte выстройте к BLOB значение, что это Blob объект представляет и возвращает число записанных байтов. |
void |
truncate(long len)
Усекает
BLOB значение, что это Blob объект представляет, чтобы быть len байты в длине. |
long length() throws SQLException
BLOB
значение определяется этим Blob
объект.BLOB
в байтахSQLException
- если есть ошибка, получая доступ к длине BLOB
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методbyte[] getBytes(long pos, int length) throws SQLException
BLOB
значение, что это Blob
объект представляет как массив байтов. Это byte
массив содержит до length
последовательные байты, запускающиеся в позиции pos
.pos
- порядковая позиция первого байта в BLOB
значение, которое будет извлечено; первый байт в позиции 1length
- число последовательных байтов, которые будут скопированы; значение для длины должно быть 0 или большеlength
последовательные байты от BLOB
значение определяется этим Blob
объект, запускающийся с байта в позиции pos
SQLException
- если есть ошибка, получая доступ BLOB
значение; если на месте продажи меньше чем 1, или длина - меньше чем 0SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методsetBytes(long, byte[])
InputStream getBinaryStream() throws SQLException
BLOB
значение определяется этим Blob
экземпляр как поток.BLOB
данныеSQLException
- если есть ошибка, получая доступ BLOB
значениеSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методsetBinaryStream(long)
long position(byte[] pattern, long start) throws SQLException
pattern
начинается в пределах BLOB
значение, что это Blob
объект представляет. Поиск pattern
начинается в позиции start
.pattern
- байтовый массив, который можно искатьstart
- позиция, в которой можно начать искать; первая позиция 1SQLException
- если есть ошибка, получая доступ BLOB
или если запуск - меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методlong position(Blob pattern, long start) throws SQLException
BLOB
значение определяется этим Blob
объект тот, в который pattern
начинается. Поиск начинается в позиции start
.pattern
- Blob
объект, определяющий BLOB
значение, которое можно искатьstart
- позиция в BLOB
значение, в котором можно начать искать; первая позиция 1SQLException
- если есть ошибка, получая доступ BLOB
значение или если запуск - меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методint setBytes(long pos, byte[] bytes) throws SQLException
BLOB
значение, что это Blob
объект представляет, запускаясь в позиции pos
, и возвращает число записанных байтов. Массив байтов перезапишет существующие байты в Blob
объект, запускающийся в позиции pos
. Если конец Blob
значение достигается при записи массиву байтов, тогда длина Blob
значение будет увеличено, чтобы разместить дополнительные байты.
Отметьте: Если значение, определенное для pos
больше тогда length+1 BLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция в BLOB
объект, в котором можно начать писать; первая позиция 1bytes
- массив байтов, которые будут записаны BLOB
значение, что это Blob
объект представляетSQLException
- если есть ошибка, получая доступ BLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetBytes(long, int)
int setBytes(long pos, byte[] bytes, int offset, int len) throws SQLException
byte
выстройте к BLOB
значение, что это Blob
объект представляет и возвращает число записанных байтов. Запись запускается в позиции pos
в BLOB
значение; len
байты от данного байтового массива пишутся. Массив байтов перезапишет существующие байты в Blob
объект, запускающийся в позиции pos
. Если конец Blob
значение достигается при записи массиву байтов, тогда длина Blob
значение будет увеличено, чтобы разместить дополнительные байты.
Отметьте: Если значение, определенное для pos
больше тогда length+1 BLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция в BLOB
объект, в котором можно начать писать; первая позиция 1bytes
- массив байтов, которые будут записаны этому BLOB
объектoffset
- смещение в массив bytes
в котором можно начать читать байты, которые будут установленыlen
- число байтов, которые будут записаны BLOB
значение от массива байтов bytes
SQLException
- если есть ошибка, получая доступ BLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetBytes(long, int)
OutputStream setBinaryStream(long pos) throws SQLException
BLOB
значение, что это Blob
объект представляет. Поток начинается в позиции pos
. Байты, записанные потоку, перезапишут существующие байты в Blob
объект, запускающийся в позиции pos
. Если конец Blob
значение достигается при записи в поток, тогда длина Blob
значение будет увеличено, чтобы разместить дополнительные байты.
Отметьте: Если значение, определенное для pos
больше тогда length+1 BLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция в BLOB
значение, в котором можно начать писать; первая позиция 1java.io.OutputStream
возразите, которому могут быть записаны данныеSQLException
- если есть ошибка, получая доступ BLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetBinaryStream()
void truncate(long len) throws SQLException
BLOB
значение, что это Blob
объект представляет, чтобы быть len
байты в длине.
Отметьте: Если значение, определенное для pos
больше тогда length+1 BLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
len
- длина та, в байтах, к который BLOB
значение, что это Blob
объект представляет, должно быть усеченнымSQLException
- если есть ошибка, получая доступ BLOB
значение или если len - меньше чем 0SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid free() throws SQLException
Blob
возразите и высвобождает средства, которые это содержит. Объект недопустим однажды free
метод вызывают. После free
был вызван, любая попытка вызвать метод кроме free
приведет к a SQLException
быть брошенным. Если free
вызывается многократно, последующие звонки free
обрабатываются как нет.
SQLException
- если ошибка происходит, высвобождая средства БлобаSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методInputStream getBinaryStream(long pos, long length) throws SQLException
InputStream
объект, который содержит частичное Blob
значение, запускающееся с байта, определенного на месте продажи, который является байтами длины в длине.pos
- смещение к первому байту частичного значения, которое будет получено. Первый байт в Blob
в позиции 1length
- длина в байтах частичного значения, которое будет полученоInputStream
через который частичное Blob
значение может быть считано.SQLException
- если на месте продажи меньше чем 1 или если на месте продажи больше чем число байтов в Blob
или если на месте продажи + длина больше чем число байтов в Blob
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92