Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
a0725b9
fix(types): модули заимствованного объекта в основной конфигурации и …
Nov 13, 2026
f6197fb
test(types): дерево модуля расширения, построенное по устаревшему осн…
claude Nov 15, 2026
a911f0a
fix(types): дерево модуля, построенное по устаревшему соседнему модул…
claude Nov 15, 2026
48be7b2
refactor(types): перепроверку модулей одного типа вынести из Configur…
claude Nov 15, 2026
aed1a92
Revert "refactor(types): перепроверку модулей одного типа вынести из …
claude Nov 15, 2026
346fe22
fix(types): перепроверенный модуль освобождается снова, кэши по симво…
claude Nov 15, 2026
1d1e0ad
test(cli): documentIsAnalyzedUnderItsLock задаёт путь к конфигурации сам
claude Nov 15, 2026
957723a
refactor(context): перестройка дерева по прежнему тексту — отдельное …
claude Nov 17, 2026
b603c14
fix(context): событие перестройки дерева после перепроверки — под бло…
claude Nov 17, 2026
0a16063
Merge remote-tracking branch 'origin/develop' into ccr-e759ef42-5ksmjb
claude Nov 22, 2026
841a72b
fix(context): удаление документа синхронизировано с его писателями
claude Nov 22, 2026
b674be9
fix(context): писатель документа берёт действующую блокировку URI
claude Nov 22, 2026
03ad666
refactor(context): писатели ServerContext держат блокировку документа…
claude Nov 22, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@
import com.github._1c_syntax.bsl.languageserver.context.events.ConfigurationTypesRegisteredEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.DocumentContextConfigurationBindingChangedEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.DocumentContextContentChangedEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.DocumentContextSymbolTreeRebuiltEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.ServerContextDocumentAddedEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.ServerContextDocumentClearedEvent;
import com.github._1c_syntax.bsl.languageserver.context.events.ServerContextDocumentClosedEvent;
Expand Down Expand Up @@ -143,6 +144,10 @@
var documentContext = (DocumentContext) joinPoint.getThis();
publishEvent(new DocumentContextContentChangedEvent(
documentContext, documentContext.isContentChangedOnLastRebuild()));
// Тот же текст, но дерево построено заново: символы не равны прежним.
if (documentContext.isSymbolTreeRebuiltOnLastRebuild()) {
publishEvent(new DocumentContextSymbolTreeRebuiltEvent(documentContext));
}
}

@AfterReturning(
Expand All @@ -157,6 +162,19 @@
}
}

// Перехватывается метод документа, а не ServerContext.refreshSymbolTree: он возвращается, пока
// вызывающий ещё держит блокировку документа на запись, и слушатели, читающие дерево разбора,
// успевают отработать раньше, чем другой писатель освободит документ.
@AfterReturning(
pointcut = "Pointcuts.isDocumentContext() && Pointcuts.isRefreshSymbolTreeCall()",
returning = "symbolTreeRebuilt"
)
public void documentContextSymbolTreeRefreshed(JoinPoint joinPoint, boolean symbolTreeRebuilt) {

Check warning on line 172 in src/main/java/com/github/_1c_syntax/bsl/languageserver/aop/EventPublisherAspect.java

View check run for this annotation

SonarQubeCloud / SonarCloud Code Analysis

Provide multiple methods instead of using "symbolTreeRebuilt" to determine which action to take.

See more on https://sonarcloud.io/project/issues?id=1c-syntax_bsl-language-server&issues=AaHqRdpekCOvxKDCjZbV&open=AaHqRdpekCOvxKDCjZbV&pullRequest=4959
if (symbolTreeRebuilt) {
publishEvent(new DocumentContextSymbolTreeRebuiltEvent((DocumentContext) joinPoint.getThis()));
}
}

@AfterReturning("Pointcuts.isServerContext() && Pointcuts.isPopulateContextCall() && args(files)")
public void serverContextPopulated(JoinPoint joinPoint, Collection<File> files) {
publishEvent(new ServerContextPopulatedEvent((ServerContext) joinPoint.getThis()));
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,14 @@ public void isRebindDocumentCall() {
// no-op
}

/**
* Это вызов метода refreshSymbolTree.
*/
@Pointcut("isBSLLanguageServerScope() && execution(* refreshSymbolTree(..))")
public void isRefreshSymbolTreeCall() {
// no-op
}

/**
* Это вызов метода tryClearDocument.
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@

import com.github._1c_syntax.bsl.languageserver.configuration.GlobalLanguageServerConfiguration;
import com.github._1c_syntax.bsl.languageserver.configuration.LanguageServerConfiguration;
import com.github._1c_syntax.bsl.languageserver.context.DocumentContext;
import com.github._1c_syntax.bsl.languageserver.context.ServerContext;
import com.github._1c_syntax.bsl.languageserver.context.ServerContextProvider;
import com.github._1c_syntax.bsl.languageserver.infrastructure.WorkspaceContextHolder;
Expand Down Expand Up @@ -264,9 +265,22 @@ private void analyze(

private FileInfo getFileInfoFromFile(Path srcDir, File file, boolean metricCalculationRequired) {
var documentContext = serverContext.addDocument(Absolute.uri(file));
// Работа с документом — под его блокировкой на запись, как у остальных писателей: кто
// сам разбирает документ и освобождает его после работы, иначе отнял бы у анализа текст
// посреди расчёта.
var lock = serverContext.getDocumentLock(documentContext.getUri()).writeLock();
lock.lock();
try {
return analyzeDocument(srcDir, documentContext, metricCalculationRequired);
} finally {
lock.unlock();
}
}

private FileInfo analyzeDocument(Path srcDir, DocumentContext documentContext, boolean metricCalculationRequired) {
serverContext.rebuildDocument(documentContext);

var filePath = srcDir.relativize(Absolute.path(file));
var filePath = srcDir.relativize(Absolute.path(documentContext.getUri()));
var diagnostics = documentContext.getDiagnostics();
var metrics = metricCalculationRequired ? documentContext.getMetrics() : null;
var mdoRef = documentContext.getMdoRef();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,8 +75,8 @@
## События — `events/`

Spring `ApplicationEvent`: `ServerContextDocumentAdded/Removed/Closed/ClearedEvent`,
`DocumentContextContentChangedEvent`, `DocumentContextConfigurationBindingChangedEvent`,
`ServerContextPopulatedEvent`, `ConfigurationTypesRegisteredEvent`. Используются downstream-индексами (`references/`, `types/`)
`DocumentContextContentChangedEvent`, `DocumentContextSymbolTreeRebuiltEvent` (и его подкласс
`DocumentContextConfigurationBindingChangedEvent`), `ServerContextPopulatedEvent`, `ConfigurationTypesRegisteredEvent`. Используются downstream-индексами (`references/`, `types/`)
для инвалидации кэшей. События жизненного цикла workspace (`Workspace(Before)Added/RemovedEvent`)
вынесены в корневой пакет `events` и «похудели» до URI (контекст в payload не носят), чтобы от них
мог зависеть `configuration`, не образуя цикл `configuration↔context`; подписчики резолвят контекст
Expand All @@ -92,13 +92,25 @@ Spring `ApplicationEvent`: `ServerContextDocumentAdded/Removed/Closed/ClearedEve
поток не находит уже посчитанного (см. ишью 4429). Сбрасываться по перечитыванию обязаны только
те, чьи ключи — узлы AST: у них ключи после разбора другие.

**Перепривязка — третий вид изменения.** Документ, заведённый до прочтения конфигурации, после
него перепривязывается (`ServerContext.rebindDocument`): AST тот же, дерево символов построено
заново, публикуется `DocumentContextConfigurationBindingChangedEvent`. Здесь символы прежним
**не равны**, если сменился их вид: класс символа входит в `equals`, а обычный метод мог стать
обработчиком события или конструктором. Поэтому слушатели, чьи записи привязаны к символам или к
привязке документа, на это событие пересчитывают документ — в том же порядке, что и на правку.
Индексы на `AbstractDocumentLifecycleClearableIndex` сбрасывают по нему записи документа.
**Перестройка дерева по прежнему тексту — третий вид изменения.** Текст тот же, а дерево
символов построено заново, публикуется `DocumentContextSymbolTreeRebuiltEvent`. Здесь символы
прежним **не равны**, если сменился их вид: класс символа входит в `equals`, а обычный метод мог
стать обработчиком события или конструктором, голое присваивание — обращением к реквизиту.
Поэтому слушатели, чьи записи привязаны к символам, на это событие пересчитывают документ — в
том же порядке, что и на правку; индексы на `AbstractDocumentLifecycleClearableIndex` сбрасывают
по нему записи документа. Причины перестройки:
- **дерево устарело** — его вид зависит от ответов классификаторов (`SelfMemberClassifier`,
`EventHandlerClassifier`), а те — от членов чужих модулей. Перечитывание того же текста такое
дерево строит заново (`SymbolTreeComputer.isUpToDate`): `DocumentContextContentChangedEvent`
уходит с `isContentChanged() == false`, а следом — событие перестройки
(`isSymbolTreeRebuiltOnLastRebuild()`). Если перечитывать документ некому, его дерево
перепроверяет `ServerContext.refreshSymbolTree` — так `ConfigurationModuleMembersProvider` после
изменения членов модуля перепроверяет другие модули того же типа (объект в основной
конфигурации и в расширении);
- **сменилась привязка** — документ, заведённый до прочтения конфигурации, после него
перепривязывается (`ServerContext.rebindDocument`), публикуется подкласс
`DocumentContextConfigurationBindingChangedEvent`: от привязки зависят и символы, и тип,
членами которого становятся методы модуля.

**Эти события публикуются не вручную, а через AOP** — аспект `aop/EventPublisherAspect`
(AspectJ compile-time weaving) перехватывает вызовы методов-мутаторов `ServerContext`/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,13 @@ public class DocumentContext implements Comparable<DocumentContext> {
@Getter
private boolean contentChangedOnLastRebuild = true;

/**
* Построено ли при последнем разборе дерево символов заново по тому же тексту: прежнее
* устарело, хотя содержимое не менялось.
*/
@Getter
private boolean symbolTreeRebuiltOnLastRebuild;

@Getter
private int version;

Expand Down Expand Up @@ -408,6 +415,7 @@ protected void rebuild(String content, int version) {
// описывать его, а не то, что пришло: иначе следующий разбор того же текста счёл бы
// документ неизменившимся, и записи, построенные по прежнему дереву, остались бы жить.
contentChangedOnLastRebuild = false;
symbolTreeRebuiltOnLastRebuild = false;
clearDependantData();
return;
}
Expand All @@ -430,15 +438,18 @@ protected void rebuild(String content, int version) {
// Перечитывание того же текста — документ освобождали, а теперь он снова нужен проходу
// доразрешения или пакетному анализу — дерева не меняет, пока оно годно: строить его
// заново значило бы повторить заметную долю всего разбора ради того же результата.
if (contentChanged || !isSymbolTreeUpToDate()) {
symbolTree.set(computeSymbolTree());
var symbolTreeRebuilt = contentChanged || !isSymbolTreeUpToDate();
if (symbolTreeRebuilt) {
replaceSymbolTree();
}

// Отпечаток запоминается последним, когда содержимое уже применено и дерево построено:
// сорвавшийся разбор не должен выглядеть состоявшимся, иначе повторная попытка сочтёт
// текст прежним и работу не переделает.
contentFingerprint = fingerprint;
contentChangedOnLastRebuild = contentChanged;
// Новое дерево после правки текста — следствие правки и отдельно не отмечается.
symbolTreeRebuiltOnLastRebuild = symbolTreeRebuilt && !contentChanged;

} finally {
releaseLocks();
Expand Down Expand Up @@ -562,6 +573,55 @@ protected boolean rebindToConfiguration() {
}
}

/**
* Построить дерево символов заново по уже разобранному тексту, если прежнее устарело:
* классификаторы отвечают о методах и голых присваиваниях документа иначе, чем при его
* построении, — их ответы держатся на членах чужих модулей. Вместе с деревом забываются
* диагностики и сложность, посчитанные по прежним символам.
*
* @return {@code true}, если дерево построено заново; {@code false}, если оно годно или
* текста у документа нет — тогда перестроить его не по чему.
*/
protected boolean refreshSymbolTree() {
acquireLocks();

try {
if (tokenizer == null || isSymbolTreeUpToDate()) {
return false;
}
replaceSymbolTree();
return true;
} finally {
releaseLocks();
}
}

/**
* Устарело ли построенное дерево символов: построение заново по тому же тексту дало бы
* другое дерево. Дерево, которое ещё не строилось, устаревшим не считается.
*
* @return {@code true}, если дерево построено и устарело.
*/
@Locked("computeLock")
protected boolean isSymbolTreeStale() {
return symbolTree.get().getBasis() != SymbolTree.Basis.NONE && !isSymbolTreeUpToDate();
}

/**
* Строит дерево символов заново и забывает посчитанное по символам прежнего: диагностики и
* сложность методов. Сложность хранится по символам, а вид символа входит в его равенство,
* поэтому у метода, ставшего обработчиком события, посчитанная сложность не нашлась бы.
* Замороженный документ, перечитанный с тем же текстом, иначе этого не сбрасывает.
* <p>
* Убедитесь, что локи установлены корректно перед вызовом метода.
*/
private void replaceSymbolTree() {
symbolTree.set(computeSymbolTree());
clearDependantData();
cognitiveComplexityData.clear();
cyclomaticComplexityData.clear();
}

/**
* Убедитесь, что локи установлены корректно перед вызовом метода.
*/
Expand Down
Loading
Loading