Class ReferenceIndexFiller

java.lang.Object

com.github._1c_syntax.bsl.languageserver.references.ReferenceIndexFiller

@Component
public class ReferenceIndexFiller
extends Object

Заполнитель индекса ссылок.

Обрабатывает события изменения контекста документов и обновляет индекс ссылок на символы.

Constructor Summary

Constructors

Constructor	Description
ReferenceIndexFiller(ReferenceIndex index, LanguageServerConfiguration configuration, OScriptLibraryIndex oScriptLibraryIndex, GlobalScopeProvider globalScopeProvider, SelfMemberResolver selfMemberResolver)

Method Summary

Modifier and Type	Method	Description
void	fill(DocumentContext documentContext)	Переиндексировать обращения к символам, расположенные в документе.
void	handleEvent(ConfigurationTypesRegisteredEvent event)	Переиндексирует self-члены документов после (пере)регистрации конфигурационных типов.
void	handleEvent(DocumentContextConfigurationBindingChangedEvent event)
void	handleEvent(DocumentContextContentChangedEvent event)
void	handleEvent(ServerContextDocumentRemovedEvent event)	Обрабатывает событие удаления документа из контекста сервера.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ReferenceIndexFiller

@ConstructorProperties({"index","configuration","oScriptLibraryIndex","globalScopeProvider","selfMemberResolver"})
public ReferenceIndexFiller(ReferenceIndex index,
 LanguageServerConfiguration configuration,
 OScriptLibraryIndex oScriptLibraryIndex,
 GlobalScopeProvider globalScopeProvider,
 SelfMemberResolver selfMemberResolver)

Method Details

handleEvent

@Order(200)
@EventListener
public void handleEvent(DocumentContextContentChangedEvent event)

handleEvent

@Order(200)
@EventListener
public void handleEvent(DocumentContextConfigurationBindingChangedEvent event)

handleEvent

@EventListener
public void handleEvent(ServerContextDocumentRemovedEvent event)

Обрабатывает событие удаления документа из контекста сервера.

При удалении документа очищает все зарегистрированные в индексе ссылки, исходящие из этого документа (вызовы методов, использование переменных и т.д.). Если контекст очищается целиком, индекс очищается разом при первом таком событии.

Parameters:

event - событие удаления документа

handleEvent

@EventListener
public void handleEvent(ConfigurationTypesRegisteredEvent event)

Переиндексирует self-члены документов после (пере)регистрации конфигурационных типов.

Проход self-членов в fill(DocumentContext) резолвит их через TypeRegistry: документ, наполненный ДО регистрации типов (либо до их перерегистрации при будущем reload конфигурации), самих self-членов ещё не проиндексировал — здесь их подхватываем, чем и обеспечивается обещанное SelfMemberResolverImpl/ReferenceIndex восстановление подсветки/резолва. Перебираем только уже наполненные документы с self-типом.

Типы регистрируются в фоне, и к концу регистрации документы уже могут быть наполнены, а часть из них — и освобождена. Документ с текстом наполняется заново под своей блокировкой на чтение; у освобождённого снимается отметка о наполнении, чтобы следующий разбор, даже того же текста, наполнил его заново: перечитывать файл ради одних ссылок здесь не стоит.

Parameters:

event - событие успешной регистрации конфигурационных типов.

fill

public void fill(DocumentContext documentContext)

Переиндексировать обращения к символам, расположенные в документе.

Новый набор вхождений собирается в буфер и применяется атомарной заменой (ReferenceIndex.replaceReferences(URI, Iterable)): конкурентные читатели ни в какой момент не видят «пустой» индекс документа. Если обход AST завершился исключением, прежнее содержимое индекса остаётся нетронутым.