Перейти к содержанию

BSL250 — Вызов функции КаталогВременныхФайлов()

← Все правила

Кратко

Вызов функции КаталогВременныхФайлов()

Идентификаторы

Поле Значение
Код правила BSL250
Совместимый псевдоним TempFilesDir
Серьёзность WARNING
Включено по умолчанию Да
Реализовано Да
Теги standard, badpractice

Поведение

  • Публичный идентификатор BSL250 и псевдоним TempFilesDir стабильны.
  • Правило сообщает о случаях, описанных на этой странице.
  • Подавления и проектная конфигурация применяются до публикации результата.
  • Для выполнения правила не требуется внешний анализатор или сетевой доступ.

Настройка и подавление

Код BSL### — основной стабильный идентификатор. Совместимый псевдоним принимается в select, ignore и совместимых блоковых комментариях.

[tool.onec-hbk-bsl]
select = ["BSL250"]
ignore = ["TempFilesDir"]

Все три семейства подавлений работают для текущей строки и диапазона. Если открывающий комментарий стоит после кода, он действует только на эту строку. Используйте любой один вариант:

  • noqa:
Значение = "пример";  // noqa: BSL250
  • bsl-disable (совместимый вариант):
Значение = "пример";  // bsl-disable: BSL250
  • совместимый BSLLS-вариант:
Значение = "пример";  // BSLLS:TempFilesDir-off

Если тот же открывающий комментарий стоит на отдельной строке, он начинает диапазон. Закройте его парным маркером того же семейства:

// noqa: BSL250
// код без этой диагностики
// noqa-enable: BSL250

// bsl-disable: BSL250
// код без этой диагностики
// bsl-enable: BSL250

// BSLLS:TempFilesDir-off
// код без этой диагностики
// BSLLS:TempFilesDir-on

Чтобы отключить правило до конца файла, не добавляйте закрывающий noqa-enable, bsl-enable или BSLLS:…-on.

Открывающий и закрывающий маркеры должны принадлежать одному семейству.

Описание диагностики

При использовании метода ПолучитьИмяВременногоФайла() платформа 1С:Предприятие сохраняет контроль над такими файлами и автоматически удаляет их при перезапуске рабочего процесса (если файл был создан на стороне сервера) или клиентского приложения (если файл был создан на стороне клиента).

Если же имя временного файла было сформировано каким-то другим способом, и прикладной код не удалил (либо по какой-то причине не смог удалить) ранее созданный временный файл, то платформа такой файл не контролирует, и он остается в файловой системе на неопределенное время. Накапливание «потерянных» временных файлов может представлять серьезную проблему, особенно для информационных баз с большим количеством активно работающих пользователей (например, при работе в режиме сервиса).

Примеры

Неправильно:

Каталог = КаталогВременныхФайлов();
ИмяФайла = Строка(Новый УникальныйИдентификатор) + ".xml";
ИмяПромежуточногоФайла = Каталог + ИмяФайла;
Данные.Записать(ИмяПромежуточногоФайла);

Правильно:

ИмяПромежуточногоФайла = ПолучитьИмяВременногоФайла("xml");
Данные.Записать(ИмяПромежуточногоФайла);

Для создания временного каталога рекомендуется также использовать имя, полученное при помощи метода ПолучитьИмяВременногоФайла (исключение составляет веб-клиент).

Неправильно:

Архив = Новый ЧтениеZipФайла(ИмяФайлаАрхива);
КаталогАрхива = КаталогВременныхФайлов()+"main_zip\";
СоздатьКаталог(КаталогАрхива);
Архив.ИзвлечьВсе(КаталогАрхива);

Правильно:

Архив = Новый ЧтениеZipФайла(ИмяФайлаАрхива);
КаталогАрхива = ПолучитьИмяВременногоФайла() + "\main_zip\";
СоздатьКаталог(КаталогАрхива);
Архив.ИзвлечьВсе(КаталогАрхива);

Источники