Блоб (Платформа Java SE 7)

Все Известные Классы с реализацией:

SerialBlob
```
public interface Blob
```
Представление (отображающееся) в языке программирования ^JavaTM SQL 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 поддерживает тип данных.

С тех пор:

1.2

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

Методы
Модификатор и Тип	Метод и Описание
`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 не поддерживает этот метод
    С тех пор:
    
    1.2
  - getBytes
```
byte[] getBytes(long pos,
              int length)
                throws SQLException
```
    Получает все или часть BLOB значение, что это Blob объект представляет как массив байтов. Это byte массив содержит до length последовательные байты, запускающиеся в позиции pos.
    
    Параметры:
    pos - порядковая позиция первого байта в BLOB значение, которое будет извлечено; первый байт в позиции 1
    length - число последовательных байтов, которые будут скопированы; значение для длины должно быть 0 или больше
    
    Возвраты:
    байтовый массив, содержащий до length последовательные байты от BLOB значение определяется этим Blob объект, запускающийся с байта в позиции pos
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение; если на месте продажи меньше чем 1, или длина - меньше чем 0
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.2
    
    См. Также:
    setBytes(long, byte[])
  - getBinaryStream
```
InputStream getBinaryStream()
                            throws SQLException
```
    Получает BLOB значение определяется этим Blob экземпляр как поток.
    
    Возвраты:
    поток, содержащий BLOB данные
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.2
    
    См. Также:
    setBinaryStream(long)
  - позиция
```
long position(byte[] pattern,
            long start)
              throws SQLException
```
    Получает позицию байта в который указанный байтовый массив pattern начинается в пределах BLOB значение, что это Blob объект представляет. Поиск pattern начинается в позиции start.
    
    Параметры:
    pattern - байтовый массив, который можно искать
    start - позиция, в которой можно начать искать; первая позиция 1
    
    Возвраты:
    позиция, в которой образец появляется, еще-1
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB или если запуск - меньше чем 1
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.2
  - позиция
```
long position(Blob pattern,
            long start)
              throws SQLException
```
    Получает позицию байта в BLOB значение определяется этим Blob объект тот, в который pattern начинается. Поиск начинается в позиции start.
    
    Параметры:
    pattern - Blob объект, определяющий BLOB значение, которое можно искать
    start - позиция в BLOB значение, в котором можно начать искать; первая позиция 1
    
    Возвраты:
    позиция, в которой образец начинается, еще-1
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение или если запуск - меньше чем 1
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.2
  - setBytes
```
int setBytes(long pos,
           byte[] bytes)
             throws SQLException
```
    Пишет данный массив байтов к BLOB значение, что это Blob объект представляет, запускаясь в позиции pos, и возвращает число записанных байтов. Массив байтов перезапишет существующие байты в Blob объект, запускающийся в позиции pos. Если конец Blob значение достигается при записи массиву байтов, тогда длина Blob значение будет увеличено, чтобы разместить дополнительные байты.
    Отметьте: Если значение, определенное для pos больше тогда length+1 BLOB значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException в то время как другие драйверы могут поддерживать эту работу.
    
    Параметры:
    pos - позиция в BLOB объект, в котором можно начать писать; первая позиция 1
    bytes - массив байтов, которые будут записаны BLOB значение, что это Blob объект представляет
    
    Возвраты:
    число записанных байтов
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение или если на месте продажи меньше чем 1
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.4
    
    См. Также:
    getBytes(long, int)
  - setBytes
```
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 объект, в котором можно начать писать; первая позиция 1
    bytes - массив байтов, которые будут записаны этому BLOB объект
    offset - смещение в массив bytes в котором можно начать читать байты, которые будут установлены
    len - число байтов, которые будут записаны BLOB значение от массива байтов bytes
    
    Возвраты:
    число записанных байтов
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение или если на месте продажи меньше чем 1
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.4
    
    См. Также:
    getBytes(long, int)
  - setBinaryStream
```
OutputStream setBinaryStream(long pos)
                             throws SQLException
```
    Получает поток, который может использоваться, чтобы записать в BLOB значение, что это Blob объект представляет. Поток начинается в позиции pos. Байты, записанные потоку, перезапишут существующие байты в Blob объект, запускающийся в позиции pos. Если конец Blob значение достигается при записи в поток, тогда длина Blob значение будет увеличено, чтобы разместить дополнительные байты.
    Отметьте: Если значение, определенное для pos больше тогда length+1 BLOB значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException в то время как другие драйверы могут поддерживать эту работу.
    
    Параметры:
    pos - позиция в BLOB значение, в котором можно начать писать; первая позиция 1
    
    Возвраты:
    a java.io.OutputStream возразите, которому могут быть записаны данные
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение или если на месте продажи меньше чем 1
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.4
    
    См. Также:
    getBinaryStream()
  - усеченный
```
void truncate(long len)
              throws SQLException
```
    Усекает BLOB значение, что это Blob объект представляет, чтобы быть len байты в длине.
    Отметьте: Если значение, определенное для pos больше тогда length+1 BLOB значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException в то время как другие драйверы могут поддерживать эту работу.
    
    Параметры:
    len - длина та, в байтах, к который BLOB значение, что это Blob объект представляет, должно быть усеченным
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ BLOB значение или если len - меньше чем 0
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.4
  - свободный
```
void free()
          throws SQLException
```
    Этот метод освобождает Blob возразите и высвобождает средства, которые это содержит. Объект недопустим однажды free метод вызывают.
    После free был вызван, любая попытка вызвать метод кроме free приведет к a SQLException быть брошенным. Если free вызывается многократно, последующие звонки free обрабатываются как нет.
    
    Броски:
    
    SQLException - если ошибка происходит, высвобождая средства Блоба
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - getBinaryStream
```
InputStream getBinaryStream(long pos,
                          long length)
                            throws SQLException
```
    Возвраты InputStream объект, который содержит частичное Blob значение, запускающееся с байта, определенного на месте продажи, который является байтами длины в длине.
    
    Параметры:
    pos - смещение к первому байту частичного значения, которое будет получено. Первый байт в Blob в позиции 1
    length - длина в байтах частичного значения, которое будет получено
    
    Возвраты:
    InputStream через который частичное Blob значение может быть считано.
    
    Броски:
    
    SQLException - если на месте продажи меньше чем 1 или если на месте продажи больше чем число байтов в Blob или если на месте продажи + длина больше чем число байтов в Blob
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6

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

Интерфейсный Блоб

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

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

длина

getBytes

getBinaryStream

позиция

позиция

setBytes

setBytes

setBinaryStream

усеченный

свободный

getBinaryStream