Class AbstractHostedInstanceManager`Abstract`

Is responsible for running and handling separate Theia instance with given plugin.

Hierarchy (View Summary)

AbstractHostedInstanceManager
- NodeHostedPluginRunner
- ElectronNodeHostedPluginRunner

Implements

HostedInstanceManager

Constructors

constructor

new AbstractHostedInstanceManager(): AbstractHostedInstanceManager
Returns AbstractHostedInstanceManager

Properties

`Protected`hostedInstanceProcess

hostedInstanceProcess: ChildProcess

`Protected` `Readonly`hostedPluginProcess

hostedPluginProcess: HostedPluginProcess

`Protected` `Readonly`hostedPluginSupport

hostedPluginSupport: HostedPluginSupport

`Protected`instanceOptions

instanceOptions: Omit<RequestOptions, "url">

`Protected`instanceUri

instanceUri: URI

`Protected`isPluginRunning

isPluginRunning: boolean = false

`Protected` `Readonly`metadata

metadata: MetadataScanner

`Protected`pluginUri

pluginUri: URI

`Protected` `Readonly`request

request: RequestService

Methods

checkInstanceUriReady

checkInstanceUriReady(): Promise<void>
Checks that the instanceUri is responding before exiting method

Returns Promise<void>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:189

debug

debug(pluginUri: URI, debugConfig: PluginDebugConfiguration): Promise<URI>
Runs specified by the given uri plugin with debug in separate Theia instance.
Parameters
- pluginUri: URI
  uri to the plugin source location
- debugConfig: PluginDebugConfiguration
  debug configuration
Returns Promise<URI>
uri where new Theia instance is run
Implementation of HostedInstanceManager.debug
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:126

getInstanceURI

getInstanceURI(): URI
Returns uri where hosted instance is run. Throws error if instance is not running.

Returns URI
Implementation of HostedInstanceManager.getInstanceURI
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:172

getPluginURI

getPluginURI(): URI
Returns uri where plugin loaded into hosted instance is located. Throws error if instance is not running.

Returns URI
Implementation of HostedInstanceManager.getPluginURI
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:179

`Protected`getStartCommand

getStartCommand(
port?: number,
debugConfig?: PluginDebugConfiguration,
): Promise<string[]>
Parameters
- Optionalport: number
- OptionaldebugConfig: PluginDebugConfiguration
Returns Promise<string[]>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:242

isPluginValid

isPluginValid(uri: URI): Promise<boolean>
Checks whether given uri points to a valid plugin.
Parameters
- uri: URI
  uri to the plugin source location
Returns Promise<boolean>
Implementation of HostedInstanceManager.isPluginValid
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:228

`Protected`isPortFree

isPortFree(port: number): Promise<boolean>
Parameters
- port: number
Returns Promise<boolean>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:347

isRunning

isRunning(): boolean
Checks whether hosted instance is run.

Returns boolean
Implementation of HostedInstanceManager.isRunning
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:118

`Protected`postProcessInstanceOptions

postProcessInstanceOptions(
options: Omit<RequestOptions, "url">,
): Promise<Omit<RequestOptions, "url">>
Parameters
- options: Omit<RequestOptions, "url">
Returns Promise<Omit<RequestOptions, "url">>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:291

`Protected`postProcessInstanceUri

postProcessInstanceUri(uri: URI): Promise<URI>
Parameters
- uri: URI
Returns Promise<URI>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:287

run

run(pluginUri: URI, port?: number): Promise<URI>
Runs specified by the given uri plugin in separate Theia instance.
Parameters
- pluginUri: URI
  uri to the plugin source location
- Optionalport: number
  port on which new instance of Theia should be run. Optional.
Returns Promise<URI>
uri where new Theia instance is run
Implementation of HostedInstanceManager.run
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:122

`Protected`runHostedPluginTheiaInstance

runHostedPluginTheiaInstance(
command: string[],
options: SpawnOptions,
): Promise<URI>
Parameters
- command: string[]
- options: SpawnOptions
Returns Promise<URI>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:295

terminate

terminate(): void
Terminates hosted plugin instance. Throws error if instance is not running.

Returns void
Implementation of HostedInstanceManager.terminate
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:162

`Protected`validatePort

validatePort(port: number): Promise<void>
Parameters
- port: number
Returns Promise<void>
- Defined in plugin-dev/src/node/hosted-instance-manager.ts:337

Class AbstractHostedInstanceManagerAbstract

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Returns AbstractHostedInstanceManager

Properties

ProtectedhostedInstanceProcess

Protected ReadonlyhostedPluginProcess

Protected ReadonlyhostedPluginSupport

ProtectedinstanceOptions

ProtectedinstanceUri

ProtectedisPluginRunning

Protected Readonlymetadata

ProtectedpluginUri

Protected Readonlyrequest

Methods

checkInstanceUriReady

Returns Promise<void>

debug

Parameters

Returns Promise<URI>

getInstanceURI

Returns URI

getPluginURI

Returns URI

ProtectedgetStartCommand

Parameters

Returns Promise<string[]>

isPluginValid

Parameters

Returns Promise<boolean>

ProtectedisPortFree

Parameters

Returns Promise<boolean>

isRunning

Returns boolean

ProtectedpostProcessInstanceOptions

Parameters

Returns Promise<Omit<RequestOptions, "url">>

ProtectedpostProcessInstanceUri

Parameters

Returns Promise<URI>

run

Parameters

Returns Promise<URI>

ProtectedrunHostedPluginTheiaInstance

Parameters

Returns Promise<URI>

terminate

Returns void

ProtectedvalidatePort

Parameters

Returns Promise<void>

Settings

On This Page

Class AbstractHostedInstanceManager`Abstract`

`Protected`hostedInstanceProcess

`Protected` `Readonly`hostedPluginProcess

`Protected` `Readonly`hostedPluginSupport

`Protected`instanceOptions

`Protected`instanceUri

`Protected`isPluginRunning

`Protected` `Readonly`metadata

`Protected`pluginUri

`Protected` `Readonly`request

`Protected`getStartCommand

`Protected`isPortFree

`Protected`postProcessInstanceOptions

`Protected`postProcessInstanceUri

`Protected`runHostedPluginTheiaInstance

`Protected`validatePort