[NEW] Расширение дерева вызовов для длительных операций

[johnnyshut]

Описание назначения, идеи

Добавить возможность строить дерево вызовов с учетом вызова через длительные операции

ДлительнаяОперация = ДлительныеОперации.ВыполнитьВФоне(
	"Обработки.ФормированиеЭтаповПроизводства.СоздатьДокументыОтложенно",
	ПараметрыПроцедуры,
	ПараметрыВыполнения);

Если ДлительнаяОперация.Статус = "Выполняется" Тогда
	
	ОбработчикОжиданияДлительнойОперации = "СоздатьДокументыОтложенноЗавершение";
	НачатьОжиданиеДлительнойОперации = Истина;
	
Иначе
	
	СоздатьДокументыОтложенно(ДлительнаяОперация);
	
	НачатьОжиданиеДлительнойОперации = Ложь;
	ДлительнаяОперация = Неопределено;
	
КонецЕсли;

Сейчас при построении дерева вызовов нижней точкой является "СоздатьДокументыОтложенно", но это не цельная картина

Тип действия (смысловая составляющая)

• 💉 Исправление ошибки (QuickFix)
• ✂️ Рефакторинг кода (Refactor)
• 📝 Шаблон кода (Template, Snippet)
• 🍄 Другое

Область применения (привязка создаваемого действия)

• ⁉️ Замечание диагностики
• 📑 Выделенный пользователем блок кода
• 📖 Действие над файлом
• 👻 Другое

Дополнительная информация

Из VSCode не всегда четкая картина для понимания
и нейроболваны путаются при кодировании

[johnnyshut]

Технический контекст

Дерево вызовов строится в CallHierarchyProvider на основе ReferenceIndex. Ссылки заполняются в ReferenceIndexFiller, который обходит AST и регистрирует вызовы через ReferenceIndex.addMethodCall().

Сейчас учитываются:

• Прямые вызовы: Модуль.Метод(), ОбщийМодуль.Процедура() и т.п.
• Обработчики в ОписаниеОповещения — через visitNewExpression и NotifyDescription.

Вызовы длительных операций не учитываются, так как имя метода передаётся строковым литералом.

Куда вносить изменения

1. ReferenceIndexFiller
   Нужен новый visitor (или расширение существующего) для обработки вызовов:

   • ДлительныеОперации.ВыполнитьВФоне(...)
   • ДлительныеОперации.ВыполнитьПроцедуру(...)
   • `ДлительныеОперации.ВыполнитьФункцию(...)
   • ДлительныеОперации.ВыполнитьПроцедуруВНесколькоПотоков(...)

   При обнаружении такого вызова - из первого строкового аргумента парсить путь в формате "ТипМДО.ИмяОбъекта.ИмяМетода" и вызывать index.addMethodCall() для соответствующего метода.

2. Обработчик завершения
   Для присваиваний вида ОбработчикОжиданияДлительнойОперации = "ИмяМетодаЗавершения" - определять строковые литералы и добавлять ссылку на метод в том же модуле (форма/модуль объекта).

Формат строки в ВыполнитьВФоне

Первый параметр: "Обработки.ФормированиеЭтаповПроизводства.СоздатьДокументыОтложенно":

• Тип МДО: Обработки
• Объект: ФормированиеЭтаповПроизводства
• Метод: СоздатьДокументыОтложенно

Отсюда строится mdoRef (например, DataProcessor.ФормированиеЭтаповПроизводства) и symbolName для addMethodCall().

Референс реализации

Аналог - обработка ОписаниеОповещения в ReferenceIndexFiller.visitNewExpression() и утилита NotifyDescription. Для длительных операций имеет смысл сделать отдельную утилиту (например, LongRunningOperations) по тому же принципу.

Ожидаемый результат

• Входящие вызовы для СоздатьДокументыОтложенно: видны вызовы из ветки Иначе (прямой вызов) и из строки в ВыполнитьВФоне(...).
• Входящие вызовы для СоздатьДокументыОтложенноЗавершение: видно присваивание ОбработчикОжиданияДлительнойОперации = "СоздатьДокументыОтложенноЗавершение".
• Исходящие вызовы из процедуры с ВыполнитьВФоне: помимо обычных вызовов отображается целевой метод из строки.

PS (опционально)

Хотелось бы не ограничиваться только строковыми литералами и учитывать конкатенации/переменные

[johnnyshut]

• Иерархия вызовов: входящая цепочка не должна обрываться на процедуре, вызванной через длительную операцию; в дереве должны быть и вызов ВыполнитьВФоне/ВыполнитьПроцедуру, и метод, из которого он идёт (до метода на форме и т.д.). При просмотре «внутрь» с метода, где есть такой вызов, - показывать исходящие вызовы и в API длительных операций, и в целевую процедуру.
• Find references: по процедуре показывать в том числе вызовы из строк/переменных в ДлительныеОперации.ВыполнитьВФоне/ВыполнитьПроцедуру.
• Go to definition: по строковому литералу (и при возможности по переменной) с именем процедуры в вызове длительной операции - переход к определению этой процедуры, по аналогии с ОписаниеОповещения.