Создает объект чтения ZIP-архива и устанавливает поток для чтения архива.
Синтаксис
Новый ЧтениеZipФайла(<Поток>, <Пароль>)Полное описание, параметры и ограничения
ЧтениеZipФайла.На основании потока
ЧтениеZipФайла (ZipFileReader)
На основании потока
Не рекомендуется использовать, начиная с версии 8.3.26.
Рекомендуется использовать:
На основании потока
Доступен, начиная с версии 8.3.10.
Синтаксис:
Новый ЧтениеZipФайла(<Поток>, <Пароль>)
Параметры:
<Поток> (обязательный)
Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток, из которого будут прочитаны данные архива.
<Пароль> (необязательный)
Тип: Строка.
Пароль для доступа к ZIP-файлу, если файл зашифрован.
Описание:
Создает объект чтения ZIP-архива и устанавливает поток для чтения архива.
Использование в версии:
Доступен, начиная с версии 8.3.10.
Не рекомендуется использовать, начиная с версии 8.3.26.
Методическая информация
Практические примеры
Получить старый ZIP в памяти без открытого архивного файла
Упаковываем свой временный текст в двоичные данные, открываем поток архива и проверяем список файлов без распаковки.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Это разбор старого ZIP API для сопровождения существующих модулей. В справке 8.5 его использование не рекомендуется с 8.3.26; для нового кода выбирайте ЗаписьФайлаАрхива и ЧтениеФайлаАрхива.
Добавить принимает путь к файлу, поэтому создаётся один уникальный временный источник. Сам архив остаётся в памяти.
Для ПолучитьДвоичныеДанные создавайте запись без параметров и не вызывайте перед этим Открыть.
ИсходныйФайл = ПолучитьИмяВременногоФайла("txt");
Поток = Неопределено;
Чтение = Неопределено;
Попытка
Документ = Новый ТекстовыйДокумент;
Документ.УстановитьТекст("Учебный пакет");
Документ.Записать(ИсходныйФайл, КодировкаТекста.UTF8);
Запись = Новый ЗаписьZipФайла;
Запись.Добавить(ИсходныйФайл);
ДанныеАрхива = Запись.ПолучитьДвоичныеДанные();
Сообщить(ДанныеАрхива.Размер());
Поток = ДанныеАрхива.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеZipФайла(Поток);
Сообщить(Чтение.Элементы.Количество());
Для Каждого Элемент Из Чтение.Элементы Цикл
Сообщить(Элемент.Имя);
КонецЦикла;
Чтение.Закрыть();
Чтение = Неопределено;
Поток.Закрыть();
Поток = Неопределено;
// Второе открытие того же пакета через неинициализированное чтение.
Поток = ДанныеАрхива.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеZipФайла;
Чтение.Открыть(Поток);
Если Чтение.Элементы.Количество() <> 1 Тогда
ВызватьИсключение "Повторное чтение пакета не совпало";
КонецЕсли;
Чтение.Закрыть();
Чтение = Неопределено;
Поток.Закрыть();
Поток = Неопределено;
УдалитьФайлы(ИсходныйФайл);
Исключение
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Поток <> Неопределено Тогда
Поток.Закрыть();
КонецЕсли;
УчебныйФайл = Новый Файл(ИсходныйФайл);
Если УчебныйФайл.Существует() Тогда
УдалитьФайлы(ИсходныйФайл);
КонецЕсли;
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Сохраняем исходный текст в один собственный временный файл.
Неинициализированная запись собирает пакет; ПолучитьДвоичныеДанные возвращает готовый архив и завершает запись.
Открываем новый поток чтения двоичных данных и передаём его конструктору чтения архива.
После проверки количества закрываем чтение и поток; повторяем проверку через Новый без параметров и Открыть. Удаляем источник.
Как проверить результат
Размер пакета больше нуля; в коллекции ровно один элемент с расширением txt.
Оба открытия возвращают количество 1. Исходный временный файл удалён.
Не вызывайте ПолучитьДвоичныеДанные после конструктора записи по имени файла: это другой способ работы, запрещённый описанием данного метода.
Ожидаемый результат
Готовый архив хранится в ДвоичныеДанные; файловый архив не создаётся.
На что обратить внимание
Это разбор старого ZIP API для сопровождения существующих модулей. В справке 8.5 его использование не рекомендуется с 8.3.26; для нового кода выбирайте ЗаписьФайлаАрхива и ЧтениеФайлаАрхива.
Не закрывайте поток раньше объекта чтения архива. После завершения не используйте закрытые объекты.
Для больших пакетов память ограничена; потоковый или файловый вариант выбирается исходя из объёма данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.