Канал обо всем, что связано с 1С.
readFileFromPathAndThrowExceptinIfNoSuchFile(Path absolutePathToFile). Ну круто же! Одна сигнатура уже говорит о том, что делается и тело метода даже читать не надо! Комментарии не нужны!
В какой-то степени это имеет смысл. За неимением лучшего можно писать так. Но что, если есть более простой и лаконичный способ? Я говорю про правильное разграничение ответственностей. Абстракции короче.
В выдуманном примере смешиваются несколько уровней абстракции: формат ошибки (exception), представление пути в файловой системе (Path), формат пути (absolute). Все это повышает когнитивную нагрузку на читателя. Представьте себе сто строк кода, написанных вот в таком стиле дедушки Боба! Брр...
Люди не могут держать большое количество деталей в голове одновременно. Я не могу думать о бизнес логике и в этот же момент видеть какие-то обработки ошибок, которые конкретно на бизнес логику не влияют. Я начинаю отсекать эти детали, чтобы просто не сойти с ума.
Мысль предельно проста. Давайте разделим код на уровни абстракции и будем использовать имена, которые соответствуют текущему уровню абстракции. Наверху у нас readFile, дальше идут проверки на корректность пути и бросание эксепшенов. Еще ниже сами придумайте.
За удивительной простотой мысли скрывается колоссальная сложность. Куда проще запихать поток мыслей в имя переменной, чем рассортировать этот поток на уровни и понять что действительно важно, а что можно скрыть за следующим уровнем абстракции. Это и есть искусство проектирования и написания кода.Функция Вып(Код, Параметр = Неопределено) Экспорт Выполнить Код; КонецФункцииФункция может быть сложнее и удобнее в использовании. Главное, чтобы она вызывала метод платформы
Выполнить(НашКод)
🤔 ГДЕ РАЗМЕСТИТЬ ВСПОМОГАТЕЛЬНУЮ ФУНКЦИЮ?
1️⃣ В своём инструменте
Да, самое очевидное - добавить метод там, где мы его будем использовать. В нашей обработке, например. Но такая функция будет доступна только внутри нашего инструмента. Не очень удобно
2️⃣ Общий модуль
Другой напрашивающийся способ - найти (или добавить) где-то в общем модуле. Это может потребовать доработки конфигурации или же установки расширения.
2️⃣ Внешняя обработка
Если бы всегда нам подходили первые два способа, то было бы не так интересно.
Но если мы по какой-то причине не хотим ставить расширение для таких целей, то можно пойти другим путём. Создать внешнюю обработку с таким же методом. Метод придётся разместить в модуле самой обработки и дополнительно в форме. Тогда он будет доступен и на сервере и на клиенте.
🤔 КАК ИСПОЛЬЗОВАТЬ ТАКУЮ ОБРАБОТКУ
Сначала нужно её открыть в режиме предприятия. Так мы "подключим" её к сеансу. А далее уже в коде можем создавать её объекты. Давайте выведем таким образом сообщение:
Для выполнения НаКлиенте можно делать так:
ПолучитьФорму("ВнешняяОбработка.Вып.Форма").Вып("Сообщить(Параметр)", "Текст");
А НаСервере так:
ВнешниеОбработки.Создать("Вып").Вып("Сообщить(Параметр)", "Текст")
Если же мы ведем отладку в фоновом задании, то открытие обработки в режиме предприятия нам не поможет. Но можно использовать и другой вызов:
ВнешниеОбработки.Создать("МойПутьКФайлу", Ложь).Вып("Сообщить(Параметр)", "Текст")
Главное в таком случае разместить обработку в доступном для сервера каталоге. Правда и тут может произойти проблема, если установлена "Защита от опасных действий". Тогда нужно при создании обработки передать ещё третий параметр - ОписаниеЗащитыОтОпасныхДействий. Для его создания обычно в типовых есть метод ОбщегоНазначения.ОписаниеЗащитыБезПредупреждений()
ВнешниеОбработки.Создать("МойПутьКФайлу", Ложь, ОбщегоНазначения.ОписаниеЗащитыБезПредупреждений()).Вып("Сообщить(Параметр
)", "Текст")
Да, выглядит костыльно, но иногда бывает полезно. Но вообще, если вам нужно просто в какой-то открытой форме изменить значение реквизита, видимость элемента и т.п., то легче вообще не открывать отладчик, а использовать специальные инструменты в режиме предприятия. Например, Менеджер открытых форм 1С.
_______________
@JuniorOneS