Перейти к основному содержимому

ДвоичныйОбъект

Стд::ОбъектноеХранилище::ДвоичныйОбъект Доступность: Сервер

Содержит описание двоичного объекта, содержимое которого, потенциально очень большого размера, хранится в специальном хранилище.

Сравнение ссылочное

Иерархия типа

Базовые типы: Объект


Примеры

метод ДобавитьИзображение(Запрос: HttpСервисЗапрос)
знч Код = Запрос.Параметры.ПолучитьПервый("image-code")
знч Размер = Запрос.Заголовки.ПолучитьПервый("Content-Length")
знч ТипСодержимого = Запрос.Заголовки.ПолучитьПервый("Content-Type")
знч ИмяФайла = Запрос.Заголовки.ПолучитьПервый("File-Name")

знч ИзображениеДанные: ДвоичныйОбъект = ОбъектноеХранилище.Загрузить(ИмяФайла, Запрос.Тело, новый Число(Размер), ТипСодержимого)

знч Изображение = новый Изображения.Объект()
Изображение.Код = Код
Изображение.Данные = ИзображениеДанные.Ссылка
Изображение.Записать()

Запрос.Ответ.УстановитьТело(ИзображениеДанные.Ссылка)
;

Свойства

Автор

Доступность: Сервер ТолькоЧтение

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


ЗагруженоСКлиента

Доступность: Сервер ТолькоЧтение

ЗагруженоСКлиента: Булево

Указывает, что двоичный объект был загружен с клиента.


ИмяФайла

Доступность: Сервер ТолькоЧтение

ИмяФайла: Строка?

Имя файла объекта, которое было указано при загрузке.


МоментЗагрузки

Доступность: Сервер ТолькоЧтение

МоментЗагрузки: Момент

Момент, когда двоичный объект был загружен в хранилище.


МоментУстаревания

Доступность: Сервер ТолькоЧтение

МоментУстаревания: Момент?

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


Размер

Доступность: Сервер ТолькоЧтение

Размер двоичного объекта в хранилище.


РасширениеФайла

Доступность: Сервер ТолькоЧтение

РасширениеФайла: Строка?

Расширение имени файла (символы после последней точки в имени файла), которое было указано при загрузке.


Свойства

Доступность: Сервер ТолькоЧтение

Возвращает прикладные свойства, которые описывают двоичный объект.


Ссылка

Доступность: Сервер ТолькоЧтение

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


ТипСодержимого

Доступность: Сервер ТолькоЧтение

ТипСодержимого: Строка

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


Хеш

Доступность: Сервер ТолькоЧтение

Хеш: Байты

Возвращает SHA-256 хеш содержимого двоичного объекта.


Методы

Записать

Доступность: Сервер

Записать(ВыходнойПоток: ПотокЗаписи)
Копирует содержимое двоичного объекта в поток записи ВыходнойПоток.

Исключения

ИсключениеДвоичногоОбъекта - при ошибке получения содержимого двоичного объекта из хранилища.


ОткрытьПотокЧтения

Доступность: Сервер

ОткрытьПотокЧтения(
От: Число? = Неопределено,
До: Число? = Неопределено
): ПотокЧтения
Возвращает поток чтения для всего содержимого объекта или указанный диапазон от От до До. Диапазон определяется индексами первого и последнего байтов содержимого объекта (включительно).

Исключения

ИсключениеДвоичногоОбъекта - при ошибке получения содержимого двоичного объекта из хранилища. ИсключениеНедопустимыйАргумент - если диапазон не содержит байтов объекта.


ПолучитьБайты

Доступность: Сервер

ПолучитьБайты(
От: Число? = Неопределено,
До: Число? = Неопределено
): Байты
Возвращает все содержимое объекта или указанный диапазон от От до До. Диапазон определяется индексами первого и последнего байтов содержимого объекта (включительно).

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

Исключения

ИсключениеДвоичногоОбъекта - при ошибке получения содержимого двоичного объекта из хранилища. ИсключениеНедопустимыйАргумент - если диапазон не содержит байтов объекта.


Список унаследованных методов

Объект

ВСтроку, ПолучитьТип, Представление