Class ServerContext

java.lang.Object
com.github._1c_syntax.bsl.languageserver.context.ServerContext
@Component @Scope("prototype") public class ServerContext extends Object
Контекст сервера - центральное хранилище информации о рабочей области.

Управляет коллекцией всех документов проекта, метаданными конфигурации 1С, обеспечивает доступ к контекстам отдельных документов и их синхронизацию.

  • Constructor Details

    • ServerContext

      @ConstructorProperties({"documentContextProvider","workDoneProgressHelper","globalConfiguration","computeConfigurationExecutor","populateContextExecutor","commonModuleCache"}) public ServerContext(ObjectProvider<DocumentContext> documentContextProvider, WorkDoneProgressHelper workDoneProgressHelper, GlobalLanguageServerConfiguration globalConfiguration, @Qualifier("computeConfigurationExecutor") ExecutorService computeConfigurationExecutor, @Qualifier("populateContextExecutor") ExecutorService populateContextExecutor, Cache<String, Optional<CommonModule>> commonModuleCache)
      Creates a new ServerContext instance.
      Parameters:
      documentContextProvider -
      workDoneProgressHelper -
      globalConfiguration -
      computeConfigurationExecutor -
      populateContextExecutor -
      commonModuleCache - Ограниченный кэш резолва общего модуля по имени (имя -> Optional<CommonModule>, кэшируются и промахи) — workspace-scoped бин (см. CacheConfiguration#commonModuleCache). Резолв зависит только от конфигурации воркспейса, а findCommonModule вызывается на каждый идентификатор при заполнении индекса ссылок — memo снимает повторное сворачивание регистра в CaseInsensitiveMap конфигурации. Сбрасывается в clear().

  • Method Details

    • populateContext

      public void populateContext()

    • populateContext

      public void populateContext(Collection<File> files)

    • getDocuments

      public Map<URI, DocumentContext> getDocuments()

    • getDocument

      public Optional<DocumentContext> getDocument(String mdoRef, com.github._1c_syntax.bsl.types.ModuleType moduleType)

    • getDocument

      public @Nullable DocumentContext getDocument(URI uri)
      Получить документ по URI.

      URI должен быть уже нормализован (например, получен из DocumentContext или через Absolute.uri).

      Parameters:
      uri - нормализованный URI документа
      Returns:
      Контекст документа или null, если документ не найден

    • getDocumentNoLock

      public @Nullable DocumentContext getDocumentNoLock(URI uri)
      Получить документ по URI без захвата блокировки.

      Этот метод предоставляет прямой доступ к хранилищу документов без синхронизации. Используйте его только в случаях, когда:

      • блокировка уже захвачена вызывающим кодом;
      • операция только на чтение и допускается eventual consistency;
      • критична производительность и накладные расходы на блокировку недопустимы.

      Внимание: использование этого метода без внешней синхронизации может привести к состояниям гонки, если другой поток одновременно модифицирует документ или коллекцию.

      Parameters:
      uri - нормализованный URI документа
      Returns:
      Контекст документа или null, если документ не найден
      See Also:

    • getDocumentUnsafe

      public @Nullable DocumentContext getDocumentUnsafe(URI uri)
      Получить документ по URI с нормализацией.

      Используется для внешних вызовов (CLI, Service), где URI может быть не нормализован.

      Parameters:
      uri - URI документа (будет нормализован)
      Returns:
      Контекст документа или null, если документ не найден

    • getDocumentUnsafe

      public @Nullable DocumentContext getDocumentUnsafe(String uri)
      Получить документ по строковому URI с нормализацией.

      Используется для внешних вызовов (CLI, Service), где URI может быть не нормализован.

      Parameters:
      uri - строковый URI документа
      Returns:
      Контекст документа или null, если документ не найден

    • getDocuments

      public Map<com.github._1c_syntax.bsl.types.ModuleType, DocumentContext> getDocuments(String mdoRef)

    • addDocument

      public DocumentContext addDocument(URI uri)
      Добавить документ в контекст.

      URI должен быть уже нормализован.

      Parameters:
      uri - нормализованный URI документа
      Returns:
      Контекст документа

    • removeDocument

      public void removeDocument(URI uri)
      Удалить документ из контекста.

      URI должен быть уже нормализован.

      Parameters:
      uri - нормализованный URI документа

    • clear

      public void clear()
      Удалить все документы из контекста.

      Каждый документ удаляется через removeDocument(URI) — это даёт ServerContextDocumentRemovedEvent через AOP-аспект, на который подписаны downstream-индексы (ReferenceIndex, OScriptLibraryIndex и прочие singleton'ы со state, индексирующим документы).

      Open-документы сначала «закрываются» сбросом openedDocuments, чтобы removeDocument(URI) не падал на guard'е «document is opened». После — финальная очистка карт, не привязанных к конкретному URI (configurationMetadata).

    • getDocumentLock

      public ReadWriteLock getDocumentLock(URI uri)
      Получить блокировку для выполнения операций над документом по URI.

      Может использоваться для операций, требующих долгосрочной установки блокировки на изменение объекта.

      Parameters:
      uri - URI документа
      Returns:
      блокировка, связанная с URI документа.

    • openDocument

      public void openDocument(DocumentContext documentContext, String content, Integer version)
      Помечает документ как открытый и перестраивает его содержимое

      Документы, помеченные как открытые, не будут удаляться из контекста сервера при вызове removeDocument(URI), а так же не будут очищаться при вызове tryClearDocument(DocumentContext).

      Если вспомогательные данные документа был в "замороженном" состоянии, то перед перестроением документа они будут разморожены.

      Parameters:
      documentContext - документ, который необходимо открыть.
      content - новое содержимое документа.
      version - версия документа.

    • isDocumentOpened

      public boolean isDocumentOpened(DocumentContext documentContext)
      Проверяет, открыт ли документ в редакторе.

      Открытые документы управляются клиентом через события textDocument/didOpen, textDocument/didChange и textDocument/didClose. Для таких документов содержимое хранится в памяти сервера и может отличаться от содержимого файла на диске.

      Открытые документы не будут удалены при вызове removeDocument(URI) и не будут очищены при вызове tryClearDocument(DocumentContext).

      Parameters:
      documentContext - документ для проверки
      Returns:
      true, если документ открыт в редакторе, false в противном случае

    • getOpenedDocuments

      public Set<DocumentContext> getOpenedDocuments()
      Возвращает иммутабельный снимок открытых документов workspace (т.е. тех, для которых клиент прислал textDocument/didOpen и не прислал textDocument/didClose).

    • rebuildDocument

      public void rebuildDocument(DocumentContext documentContext)
      Перестроить документ. В качестве содержимого будут использоваться данные, прочитанные из файла, с которым связан документ.
      Parameters:
      documentContext - документ, который необходимо перестроить.

    • rebuildDocument

      public void rebuildDocument(DocumentContext documentContext, String content, Integer version)
      Перестроить документ, используя новое содержимое.
      Parameters:
      documentContext - документ, который необходимо перестроить.
      content - новое содержимое документа.
      version - версия документа.

    • tryClearDocument

      public boolean tryClearDocument(DocumentContext documentContext)
      Попытаться очистить документ, если он не открыт.
      Parameters:
      documentContext - документ, который необходимо попытаться закрыть.
      Returns:
      true, если вторичные данные документа были реально освобождены; false, если документ открыт в редакторе и очистка пропущена.

    • closeDocument

      public void closeDocument(DocumentContext documentContext)
      Закрыть документ и очистить его содержимое.
      Parameters:
      documentContext - документ, который необходимо закрыть.

    • getConfiguration

      public CF getConfiguration()

    • findCommonModule

      public Optional<CommonModule> findCommonModule(String name)
      Найти общий модуль по имени с мемоизацией (ограниченный кэш commonModuleCache). Эквивалентно getConfiguration().findCommonModule(name), но без повторного прохода по case-insensitive карте конфигурации на каждый вызов.

      Ключ кэша — сырой текст идентификатора (намеренно не нормализуется): на попадании это дешёвый lookup без сворачивания регистра — ровно то, ради чего кэш и нужен. toLowerCase на каждый вызов вернул бы посимвольное сворачивание + аллокацию строки на горячий путь, а экономия (схлопывание редких регистровых вариантов одного имени) — околонулевая. Сам резолв внутри остаётся регистронезависимым.

      Parameters:
      name - имя общего модуля
      Returns:
      общий модуль или Optional.empty(), если такого нет

    • getLanguageServerConfiguration

      public LanguageServerConfiguration getLanguageServerConfiguration()

    • setLanguageServerConfiguration

      public void setLanguageServerConfiguration(LanguageServerConfiguration languageServerConfiguration)

    • getWorkspaceUri

      public URI getWorkspaceUri()

    • setWorkspaceUri

      public void setWorkspaceUri(URI workspaceUri)

    • setConfigurationRoot

      public void setConfigurationRoot(@Nullable Path configurationRoot)

    • getConfigurationRoot

      public @Nullable Path getConfigurationRoot()