javadoc

src/main/java/com/github/_1c_syntax/bsl/languageserver/codelenses/AbstractRunTestsCodeLensSupplier.java

@@ -71,9 +71,17 @@ public void handleEvent(LanguageServerInitializeRequestReceivedEvent event) {
     clientIsSupported = "Visual Studio Code".equals(clientName);
   }
 
+  /**
+   * Обработчик события {@link LanguageServerConfigurationChangedEvent}.
+   * <p>
+   * Сбрасывает кеш при изменении конфигурации.
+   *
+   * @param event Событие
+   */
   @EventListener
   @CacheEvict(allEntries = true)
   public void handleLanguageServerConfigurationChange(LanguageServerConfigurationChangedEvent event) {
+    // No-op. Служит для сброса кеша при изменении конфигурации
   }
 
   /**
@@ -89,8 +97,21 @@ public boolean isApplicable(DocumentContext documentContext) {
       && clientIsSupported;
   }
 
+  /**
+   * Получить self-injected экземпляр себя для работы механизмов кэширования.
+   *
+   * @return Управляемый Spring'ом экземпляр себя
+   */
   protected abstract AbstractRunTestsCodeLensSupplier<T> getSelf();
 
+  /**
+   * Получить список каталогов с тестами с учетом корня рабочей области.
+   * <p>
+   * public для работы @Cachable.
+   *
+   * @param configurationRoot Корень конфигурации
+   * @return Список исходных файлов тестов
+   */
   @Cacheable
   public Set<URI> getTestSources(@Nullable Path configurationRoot) {
     var configurationRootString = Optional.ofNullable(configurationRoot)

src/main/java/com/github/_1c_syntax/bsl/languageserver/codelenses/RunAllTestsCodeLensSupplier.java

@@ -52,6 +52,7 @@ public class RunAllTestsCodeLensSupplier
   private final TestRunnerAdapter testRunnerAdapter;
   private final Resources resources;
 
+  // Self-injection для работы кэша в базовом классе.
   @Autowired
   @Lazy
   @Getter

src/main/java/com/github/_1c_syntax/bsl/languageserver/codelenses/RunTestCodeLensSupplier.java

@@ -59,6 +59,7 @@ public class RunTestCodeLensSupplier
   private final TestRunnerAdapter testRunnerAdapter;
   private final Resources resources;
 
+  // Self-injection для работы кэша в базовом классе.
   @Autowired
   @Lazy
   @Getter

src/main/java/com/github/_1c_syntax/bsl/languageserver/codelenses/testrunner/TestRunnerAdapter.java

@@ -65,6 +65,13 @@ public class TestRunnerAdapter {
 
   private final LanguageServerConfiguration configuration;
 
+  /**
+   * Обработчик события {@link LanguageServerConfigurationChangedEvent}.
+   * <p>
+   * Очищает кэш при изменении конфигурации.
+   *
+   * @param event Событие
+   */
   @EventListener
   @CacheEvict(allEntries = true)
   public void handleEvent(LanguageServerConfigurationChangedEvent event) {

src/main/java/com/github/_1c_syntax/bsl/languageserver/infrastructure/CacheConfiguration.java

@@ -24,6 +24,9 @@
 import org.springframework.cache.annotation.EnableCaching;
 import org.springframework.context.annotation.Configuration;
 
+/**
+ * Spring-конфигурация кэширования.
+ */
 @Configuration
 @EnableCaching
 public class CacheConfiguration {