compact3

javax.sql.rowset.serial

Класс SerialBlob

java.lang. Объект

javax.sql.rowset.serial. SerialBlob

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Блоб

public class SerialBlob
extends Object
implements Blob, Serializable, Cloneable

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

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

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

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

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

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

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

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

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

Методы, наследованные от class java.lang. Объект

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

SerialBlob

public SerialBlob(byte[] b)
           throws SerialException,
                  SQLException

Конструкции a SerialBlob объект, который является сериализированной версией данного byte массив.

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

Параметры:

b - byte массив, содержащий данные для Blob объект, который будет сериализирован

Броски:

SerialException - если ошибка происходит во время сериализации

SQLException - если SQL ошибки происходит

SerialBlob

public SerialBlob(Blob blob)
           throws SerialException,
                  SQLException

Конструкции a SerialBlob объект, который является сериализированной версией данного Blob объект.

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

Параметры:

blob - Blob объект тот, от который это SerialBlob объект состоит в том, чтобы быть создан; не может быть нуль.

Броски:

SerialException - если ошибка происходит во время сериализации

SQLException - если Blob переданный к этому этому конструктору a 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[])

длина

public long length()
            throws SerialException

Получает число байтов в этом SerialBlob массив объекта байтов.

Определенный:

length в интерфейсе Blob

Возвраты:

a long указание на длину в байтах этого SerialBlob массив объекта байтов

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getBinaryStream

public InputStream getBinaryStream()
                            throws SerialException

Возвраты это SerialBlob возразите как входной поток. В отличие от связанного метода, setBinaryStream, поток производится независимо от ли SerialBlob создавался с a Blob объект или a byte массив.

Определенный:

getBinaryStream в интерфейсе Blob

Возвраты:

a java.io.InputStream объект, который содержит это SerialBlob массив объекта байтов

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

См. Также:

setBinaryStream(long)

позиция

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 значение от базы данных

позиция

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 объект.

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 значение; байты len от данного байтового массива пишутся.

Определенный:

setBytes в интерфейсе Blob

Параметры:

pos - позиция в BLOB объект, в котором можно начать писать. Первая позиция 1; не должны быть меньше чем 1 ни больше чем длина этого SerialBlob объект.

bytes - массив байтов, которые будут записаны BLOB значение

offset - смещение в byte массив, в котором можно начать читать байты. Первая позиция смещения 0; не должны быть меньше чем 0 ни больше чем длина byte массив

length - число байтов, которые будут записаны BLOB значение от массива байтов байтов.

Возвраты:

число записанных байтов

Броски:

SerialException - если есть ошибка, получая доступ BLOB значение; если недопустимая позиция устанавливается; если недопустимое значение смещения устанавливается; если число байтов, которые будут записаны, больше чем SerialBlob длина; или общая стоимость длины и смещения больше чем буфер Блоба; если free был ранее вызван на этом объекте

SQLException - если есть ошибка, получая доступ BLOB значение от базы данных.

См. Также:

getBytes(long, int)

setBinaryStream

public OutputStream setBinaryStream(long pos)
                             throws SerialException,
                                    SQLException

Получает поток, который может использоваться, чтобы записать в BLOB значение, что это Blob объект представляет. Поток начинается в позиции pos. Этот метод вперед setBinaryStream() призовите к базовому Blob когда это SerialBlob объект инстанцируют с a Blob. Если это SerialBlob инстанцируется с a byte массив, a SerialException бросается.

Определенный:

setBinaryStream в интерфейсе Blob

Параметры:

pos - позиция в BLOB значение, в котором можно начать писать

Возвраты:

a java.io.OutputStream возразите, которому могут быть записаны данные

Броски:

SQLException - если есть ошибка, получая доступ BLOB значение

SerialException - если SerialBlob в не инстанцированный с a Blob объект, который поддерживает setBinaryStream(); если free был ранее вызван на этом объекте

См. Также:

getBinaryStream()

усеченный

public void truncate(long length)
              throws SerialException

Усекает BLOB значение, что это Blob объект представляет, чтобы быть len байты в длине.

Определенный:

truncate в интерфейсе Blob

Параметры:

length - длина та, в байтах, к который BLOB значение, что это Blob объект представляет, должно быть усеченным

Броски:

SerialException - если есть ошибка, получая доступ к значению Блоба; или длина, чтобы усечь больше что длина SerialBlob; если free был ранее вызван на этом объекте

getBinaryStream

public InputStream getBinaryStream(long pos,
                                   long length)
                            throws SQLException

Возвраты InputStream объект, который содержит частичное Blob значение, запускающееся с байта, определенного на месте продажи, который является байтами длины в длине.

Определенный:

getBinaryStream в интерфейсе Blob

Параметры:

pos - смещение к первому байту частичного значения, которое будет получено. Первый байт в Blob в позиции 1

length - длина в байтах частичного значения, которое будет получено

Возвраты:

InputStream через который частичное Blob значение может быть считано.

Броски:

SQLException - если на месте продажи меньше чем 1 или если на месте продажи больше чем число байтов в Blob или если на месте продажи + длина больше чем число байтов в Blob

SerialException - если free метод ранее вызвали на этом объекте

С тех пор:

1.6

свободный

public void free()
          throws SQLException

Этот метод освобождает SeriableBlob возразите и высвобождает средства, которые это содержит. Объект недопустим однажды free метод вызывают.

Если free вызывается многократно, последующие звонки free обрабатываются как нет.

Определенный:

free в интерфейсе Blob

Броски:

SQLException - если ошибка происходит, высвобождая средства Блоба

С тех пор:

1.6

равняется

public boolean equals(Object obj)

Сравнивает этот SerialBlob с указанным объектом. Результат true если и только если параметр не null и a SerialBlob объект, который представляет ту же самую последовательность байтов как этот объект.

Переопределения:

equals в class Object

Параметры:

obj - Объект сравнить это SerialBlob против

Возвраты:

true если данный объект представляет a SerialBlob эквивалентный этому SerialBlob, false иначе

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает хэш-код для этого SerialBlob.

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

клон

public Object clone()

Возвращает клона этого SerialBlob. Копия будет содержать ссылку на клона внутреннего байтового массива, не ссылку на исходный внутренний байтовый массив этого SerialBlob объект. Базовое Blob объект будет, устанавливают в NULL.

Переопределения:

clone в class Object

Возвраты:

клон этого SerialBlob

См. Также:

Cloneable