Class DefaultWorkspaceManager

The workspace manager is responsible for finding source files in the workspace. This service is shared between all languages of a language server.

Implements

WorkspaceManager

Index

Constructors

constructor

new DefaultWorkspaceManager(services): DefaultWorkspaceManager
Parameters
- services: LangiumSharedCoreServices
Returns DefaultWorkspaceManager
- Defined in packages/langium/src/workspace/workspace-manager.ts:82

Properties

`Protected` `Readonly`_ready

_ready: Deferred<void> = ...

`Protected` `Readonly`documentBuilder

documentBuilder: DocumentBuilder

`Protected` `Readonly`fileSystemProvider

fileSystemProvider: FileSystemProvider

`Protected` `Optional`folders

folders?: WorkspaceFolder[]

initialBuildOptions

initialBuildOptions: BuildOptions = {}

The options used for the initial workspace build.

`Protected` `Readonly`langiumDocuments

langiumDocuments: LangiumDocuments

`Protected` `Readonly`mutex

mutex: WorkspaceLock

`Protected` `Readonly`serviceRegistry

serviceRegistry: ServiceRegistry

Accessors

ready

get ready(): Promise<void>
A promise that resolves when the workspace manager is ready to be used. Use this to ensure that the workspace manager has finished its initialization.

Returns Promise<void>
Implementation of WorkspaceManager.ready
- Defined in packages/langium/src/workspace/workspace-manager.ts:90

workspaceFolders

get workspaceFolders(): undefined | readonly WorkspaceFolder[]
The workspace folders of the current workspace. Available only after the ready promise resolves.

Returns undefined | readonly WorkspaceFolder[]
Implementation of WorkspaceManager.workspaceFolders
- Defined in packages/langium/src/workspace/workspace-manager.ts:94

Methods

`Protected`getRootFolder

getRootFolder(workspaceFolder): URI
Determine the root folder of the source documents in the given workspace folder. The default implementation returns the URI of the workspace folder, but you can override this to return a subfolder like src instead.
Parameters
- workspaceFolder: WorkspaceFolder
Returns URI
- Defined in packages/langium/src/workspace/workspace-manager.ts:155

`Protected`includeEntry

includeEntry(_workspaceFolder, entry, fileExtensions): boolean
Determine whether the given folder entry shall be included while indexing the workspace.
Parameters
- _workspaceFolder: WorkspaceFolder
- entry: FileSystemNode
- fileExtensions: string[]
Returns boolean
- Defined in packages/langium/src/workspace/workspace-manager.ts:180

initialize

initialize(params): void
When used in a language server context, this method is called when the server receives the initialize request.
Parameters
- params: InitializeParams
Returns void
Implementation of WorkspaceManager.initialize
- Defined in packages/langium/src/workspace/workspace-manager.ts:98

initialized

initialized(_params): Promise<void>
When used in a language server context, this method is called when the server receives the initialized notification.
Parameters
- _params: InitializedParams
Returns Promise<void>
Implementation of WorkspaceManager.initialized
- Defined in packages/langium/src/workspace/workspace-manager.ts:102

initializeWorkspace

initializeWorkspace(folders, cancelToken?): Promise<void>
Does the initial indexing of workspace folders. Collects information about exported and referenced AstNodes in each language file and stores it locally.
Parameters
- folders: WorkspaceFolder[]
  The set of workspace folders to be indexed.
- cancelToken: CancellationToken = CancellationToken.None
  A cancellation token that can be used to cancel the operation.
Returns Promise<void>
Throws
OperationCancelled if a cancellation event has been detected
Implementation of WorkspaceManager.initializeWorkspace
- Defined in packages/langium/src/workspace/workspace-manager.ts:108

`Protected`loadAdditionalDocuments

loadAdditionalDocuments(_folders, _collector): Promise<void>
Load all additional documents that shall be visible in the context of the given workspace folders and add them to the collector. This can be used to include built-in libraries of your language, which can be either loaded from provided files or constructed in memory.
Parameters
- _folders: WorkspaceFolder[]
- _collector: ((document: LangiumDocument<AstNode>) => void)
  - - (document): void
    - Parameters
      document: LangiumDocument<AstNode>
      Returns void
Returns Promise<void>
- Defined in packages/langium/src/workspace/workspace-manager.ts:146

`Protected`performStartup

performStartup(folders): Promise<LangiumDocument<AstNode>[]>
Performs the uninterruptable startup sequence of the workspace manager. This methods loads all documents in the workspace and other documents and returns them.
Parameters
- folders: WorkspaceFolder[]
Returns Promise<LangiumDocument<AstNode>[]>
- Defined in packages/langium/src/workspace/workspace-manager.ts:120

`Protected`traverseFolder

traverseFolder(workspaceFolder, folderPath, fileExtensions, collector): Promise<void>
Traverse the file system folder identified by the given URI and its subfolders. All contained files that match the file extensions are added to the collector.
Parameters
- workspaceFolder: WorkspaceFolder
- folderPath: URI
- fileExtensions: string[]
- collector: ((document: LangiumDocument<AstNode>) => void)
  - - (document): void
    - Parameters
      document: LangiumDocument<AstNode>
      Returns void
Returns Promise<void>
- Defined in packages/langium/src/workspace/workspace-manager.ts:163

Class DefaultWorkspaceManager

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns DefaultWorkspaceManager

Properties

Protected Readonly_ready

Protected ReadonlydocumentBuilder

Protected ReadonlyfileSystemProvider

Protected Optionalfolders

initialBuildOptions

Protected ReadonlylangiumDocuments

Protected Readonlymutex

Protected ReadonlyserviceRegistry

Accessors

ready

Returns Promise<void>

workspaceFolders

Returns undefined | readonly WorkspaceFolder[]

Methods

ProtectedgetRootFolder

Parameters

Returns URI

ProtectedincludeEntry

Parameters

Returns boolean

initialize

Parameters

Returns void

initialized

Parameters

Returns Promise<void>

initializeWorkspace

Parameters

Returns Promise<void>

Throws

ProtectedloadAdditionalDocuments

Parameters

Parameters

Returns void

Returns Promise<void>

ProtectedperformStartup

Parameters

Returns Promise<LangiumDocument<AstNode>[]>

ProtectedtraverseFolder

Parameters

Parameters

Returns void

Returns Promise<void>

Settings

On This Page

`Protected` `Readonly`_ready

`Protected` `Readonly`documentBuilder

`Protected` `Readonly`fileSystemProvider

`Protected` `Optional`folders

`Protected` `Readonly`langiumDocuments

`Protected` `Readonly`mutex

`Protected` `Readonly`serviceRegistry

`Protected`getRootFolder

`Protected`includeEntry

`Protected`loadAdditionalDocuments

`Protected`performStartup

`Protected`traverseFolder