Spec-Zone.ru › OpenJDK 27

Класс SerialBlob

java.lang.Object
javax.sql.rowset.serial.SerialBlob
Все реализуемые интерфейсы:
Serializable, AutoCloseable, Cloneable, Blob
public class SerialBlob extends Object implements Blob, Serializable, Cloneable
Сериализованное отображение значения SQL BLOB на языке программирования Java.

Класс SerialBlob предоставляет конструктор для создания экземпляра из объекта Blob. Обратите внимание, что объект Blob должен был передать данные значения SQL BLOB на клиент до создания из него объекта SerialBlob. Данные значения SQL BLOB можно материализовать на клиенте в виде массива байтов (с помощью метода Blob.getBytes) или потока необработанных байтов (с помощью метода Blob.getBinaryStream).

Методы SerialBlob позволяют создать копию объекта SerialBlob в виде массива байтов или потока. Они также позволяют найти заданный шаблон байтов или объект Blob внутри объекта SerialBlob, а также обновить или усечь объект Blob.

Потокобезопасность

SerialBlob небезопасен для использования несколькими параллельными потоками. Если SerialBlob используется более чем одним потоком, доступ к нему следует контролировать с помощью соответствующей синхронизации.

С версии:
1.5
См. также:
  • Сериализованная форма

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

Конструктор Описание
SerialBlob(byte[] b)
Создает объект SerialBlob, представляющий собой сериализованную версию заданного массива byte.
SerialBlob(Blob blob)
Создает объект SerialBlob, представляющий собой сериализованную версию заданного объекта Blob.

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

Модификатор и тип Метод Описание
Object clone()
Возвращает клон этого объекта SerialBlob.
boolean equals(Object obj)
Сравнивает этот SerialBlob с указанным объектом.
void free()
Этот метод освобождает объект SerialBlob и высвобождает удерживаемые им ресурсы.
InputStream getBinaryStream()
Возвращает этот объект SerialBlob в виде входного потока.
InputStream getBinaryStream(long pos, long length)
Возвращает объект InputStream, содержащий частичное значение Blob, начиная с байта, указанного параметром pos; длина объекта составляет length байт.
byte[] getBytes(long pos, int length)
Копирует указанное число байтов, начиная с заданной позиции, из этого объекта SerialBlob в другой массив байтов.
int hashCode()
Возвращает хеш-код этого объекта SerialBlob.
long length()
Возвращает число байтов в массиве байтов этого объекта SerialBlob.
long position(byte[] pattern, long start)
Возвращает позицию в этом объекте SerialBlob, с которой начинается заданный шаблон байтов; поиск начинается с указанной позиции.
long position(Blob pattern, long start)
Возвращает позицию в этом объекте SerialBlob, с которой начинается заданный объект 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 length)
Записывает весь заданный массив byte или его часть в значение BLOB, представленное этим объектом Blob, и возвращает число записанных байтов.
void truncate(long length)
Усекает значение BLOB, представленное этим объектом Blob, до длины len байт.

Методы, объявленные в классе Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected void finalize()
Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии.
Финализация устарела и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого объекта Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.

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

close
Модификатор и тип Метод Описание
default void close()
Закрывает объект Blob и освобождает удерживаемые им ресурсы.

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

SerialBlob

public SerialBlob(byte[] b) throws SerialException, SQLException
Создает объект SerialBlob, представляющий собой сериализованную версию заданного массива byte.

Новый объект SerialBlob инициализируется данными из массива byte, что позволяет автономным объектам RowSet создавать сериализованные объекты Blob, не обращаясь к источнику данных.

Параметры:
b — массив byte, содержащий данные для сериализуемого объекта Blob
Исключения:
SerialException — если во время сериализации произошла ошибка
SQLException — если произошла ошибка SQL

SerialBlob

public SerialBlob(Blob blob) throws SerialException, SQLException
Создает объект SerialBlob, представляющий собой сериализованную версию заданного объекта Blob.

Новый объект SerialBlob инициализируется данными из объекта Blob; следовательно, объект Blob должен был предварительно передать данные значения SQL BLOB из базы данных на клиент. В противном случае новый объект SerialBlob не будет содержать данных.

Параметры:
blob — объект Blob, из которого должен быть создан этот объект SerialBlob; не может быть равен null.
Исключения:
SerialException — если во время сериализации произошла ошибка
SQLException — если переданный этому конструктору параметр Blob имеет значение null.
См. также:
  • Blob

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

getBytes

public byte[] getBytes(long pos, int length) throws SerialException
Копирует указанное число байтов, начиная с заданной позиции, из этого объекта SerialBlob в другой массив байтов.

Обратите внимание: если заданное число копируемых байтов превышает длину массива байтов этого объекта SerialBlob, указанное число будет сокращено до длины массива.

Определен в:
getBytes в интерфейсе Blob
Параметры:
pos — порядковый номер первого байта в этом объекте SerialBlob, который требуется скопировать; нумерация начинается с 1; значение не должно быть меньше 1 и должно быть меньше или равно длине этого объекта SerialBlob
length — число копируемых байтов
Возвращает:
массив байтов, являющийся копией области этого объекта SerialBlob, которая начинается с заданной позиции и содержит указанное число последовательных байтов
Исключения:
SerialException — если заданная начальная позиция находится вне допустимого диапазона; если ранее для этого объекта был вызван free
См. также:
  • Blob.setBytes(long, byte[])

length

public long length() throws SerialException
Возвращает число байтов в массиве байтов этого объекта SerialBlob.
Определен в:
length в интерфейсе Blob
Возвращает:
значение long, указывающее длину в байтах массива байтов этого объекта SerialBlob
Исключения:
SerialException — если произошла ошибка; если ранее для этого объекта был вызван free

getBinaryStream

public InputStream getBinaryStream() throws SerialException
Возвращает этот объект SerialBlob в виде входного потока. В отличие от связанного метода setBinaryStream, поток создается независимо от того, был ли объект SerialBlob создан с объектом Blob или массивом byte.
Определен в:
getBinaryStream в интерфейсе Blob
Возвращает:
объект java.io.InputStream, содержащий массив байтов этого объекта SerialBlob
Исключения:
SerialException — если произошла ошибка; если ранее для этого объекта был вызван free
См. также:
  • setBinaryStream(long)

position

public long position(byte[] pattern, long start) throws SerialException, SQLException
Возвращает позицию в этом объекте SerialBlob, с которой начинается заданный шаблон байтов; поиск начинается с указанной позиции.
Определен в:
position в интерфейсе Blob
Параметры:
pattern — шаблон байтов для поиска
start — позиция байта в этом объекте SerialBlob, с которой следует начать поиск; первая позиция — 1; значение не должно быть меньше 1 или больше длины этого объекта SerialBlob
Возвращает:
позицию в этом объекте SerialBlob, с которой начинается заданный шаблон, начиная с указанной позиции; -1, если шаблон не найден или заданная начальная позиция находится вне допустимого диапазона; нумерация позиций возвращаемого значения начинается с 1
Исключения:
SerialException — если при сериализации блоба произошла ошибка; если ранее для этого объекта был вызван free
SQLException — если произошла ошибка при доступе к значению BLOB из базы данных

position

public long position(Blob pattern, long start) throws SerialException, SQLException
Возвращает позицию в этом объекте SerialBlob, с которой начинается заданный объект Blob; поиск начинается с указанной позиции.
Определен в:
position в интерфейсе Blob
Параметры:
pattern — объект Blob для поиска;
start — позиция байта в этом объекте SerialBlob, с которой следует начать поиск; первая позиция — 1; значение не должно быть меньше 1 или больше длины этого объекта SerialBlob
Возвращает:
позицию в этом объекте SerialBlob, с которой начинается заданный объект Blob, начиная с указанной позиции; -1, если шаблон не найден или заданная начальная позиция находится вне допустимого диапазона; нумерация позиций возвращаемого значения начинается с 1
Исключения:
SerialException — если при сериализации блоба произошла ошибка; если ранее для этого объекта был вызван free
SQLException — если произошла ошибка при доступе к значению BLOB из базы данных

setBytes

public int setBytes(long pos, byte[] bytes) throws SerialException, SQLException
Записывает заданный массив байтов в значение BLOB, представленное этим объектом Blob, начиная с позиции pos, и возвращает число записанных байтов.
Определен в:
setBytes в интерфейсе Blob
Параметры:
pos — позиция в значении SQL BLOB, с которой следует начать запись. Первая позиция — 1; значение не должно быть меньше 1 или больше длины этого объекта SerialBlob плюс 1.
bytes — массив байтов для записи в значение BLOB, представленное этим объектом Blob
Возвращает:
число записанных байтов
Исключения:
SerialException — если произошла ошибка при доступе к значению BLOB; если задана недопустимая позиция; если ранее для этого объекта был вызван free
SQLException — если произошла ошибка при доступе к значению BLOB из базы данных
См. также:
  • getBytes(long, int)

setBytes

public int setBytes(long pos, byte[] bytes, int offset, int length) throws SerialException, SQLException
Записывает весь заданный массив byte или его часть в значение BLOB, представленное этим объектом Blob, и возвращает число записанных байтов. Запись начинается с позиции pos в значении BLOB; из заданного массива байтов записывается length байт.
Определен в:
setBytes в интерфейсе Blob
Параметры:
pos — позиция в объекте BLOB, с которой следует начать запись. Первая позиция — 1; значение не должно быть меньше 1 или больше длины этого объекта SerialBlob плюс 1.
bytes — массив байтов для записи в значение BLOB
offset — смещение в массиве bytes, с которого следует начать считывать записываемые байты. Первое смещение — 0; значение не должно быть меньше 0 или больше длины массива bytes
length — число байтов, которые следует записать в значение BLOB из массива байтов bytes
Возвращает:
число записанных байтов
Исключения:
SerialException — если произошла ошибка при доступе к значению BLOB; если задана недопустимая позиция; если задано недопустимое значение смещения; если сумма значений length и offset превышает длину bytes; если ранее для этого объекта был вызван free
SQLException — если произошла ошибка при доступе к значению BLOB из базы данных.
См. также:
  • getBytes(long, int)

setBinaryStream

public OutputStream setBinaryStream(long pos) throws SerialException, SQLException
Получает поток, который можно использовать для записи значения BLOB, представленного этим объектом Blob. Поток начинается с позиции pos. Если этот объект SerialBlob создан с объектом Blob, данный метод передает вызов setBinaryStream() нижележащему Blob. Если этот SerialBlob создан с массивом byte, выбрасывается SerialException.
Определен в:
setBinaryStream в интерфейсе Blob
Параметры:
pos — позиция в значении BLOB, с которой следует начать запись
Возвращает:
объект java.io.OutputStream, в который можно записывать данные
Исключения:
SQLException — если произошла ошибка при доступе к значению BLOB
SerialException — если SerialBlob создан не с объектом Blob, поддерживающим setBinaryStream(); если ранее для этого объекта был вызван free
См. также:
  • getBinaryStream()

truncate

public void truncate(long length) throws SerialException
Усекает значение BLOB, представленное этим объектом Blob, до длины len байт.
Определен в:
truncate в интерфейсе Blob
Параметры:
length — длина в байтах, до которой следует усечь значение BLOB, представленное этим объектом Blob
Исключения:
SerialException — если произошла ошибка при доступе к значению Blob или длина усечения превышает длину SerialBlob; если ранее для этого объекта был вызван free

getBinaryStream

public InputStream getBinaryStream(long pos, long length) throws SQLException
Возвращает объект InputStream, содержащий частичное значение Blob, начиная с байта, указанного параметром pos; длина объекта составляет length байт.
Определен в:
getBinaryStream в интерфейсе Blob
Параметры:
pos — смещение первого байта извлекаемого частичного значения. Первый байт в Blob находится в позиции 1
length — длина извлекаемого частичного значения в байтах
Возвращает:
InputStream, из которого можно прочитать частичное значение Blob.
Исключения:
SQLException — если pos меньше 1, если pos больше числа байтов в Blob или если pos + length превышает число байтов в Blob
SerialException — если ранее для этого объекта был вызван метод free
С версии:
1.6

free

public void free() throws SQLException
Этот метод освобождает объект SerialBlob и высвобождает удерживаемые им ресурсы. После вызова метода free объект становится недействительным.

При многократном вызове free последующие вызовы free не выполняют никаких действий.

Определен в:
free в интерфейсе Blob
Исключения:
SQLException — если при освобождении ресурсов Blob произошла ошибка
С версии:
1.6
См. также:
  • Blob.close()

equals

public boolean equals(Object obj)
Сравнивает этот SerialBlob с указанным объектом. Результат равен true тогда и только тогда, когда аргумент не равен null и является объектом SerialBlob, представляющим ту же последовательность байтов, что и этот объект.
Переопределяет:
equals в классе Object
Параметры:
obj — объект, с которым сравнивается этот объект SerialBlob
Возвращает:
true, если заданный объект представляет SerialBlob, эквивалентный этому SerialBlob; в противном случае — false
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает хеш-код этого объекта SerialBlob.
Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода этого объекта.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

clone

public Object clone()
Возвращает клон этого объекта SerialBlob. Копия будет содержать ссылку на клон внутреннего массива байтов, а не ссылку на исходный внутренний массив байтов этого объекта SerialBlob. Для нижележащего объекта Blob будет установлено значение null.
Переопределяет:
clone в классе Object
Возвращает:
клон этого SerialBlob
См. также:
  • Cloneable

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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