Runtime Server Protocol UI installs statistics

Runtime Server Protocol UI

A Visual Studio Code extension that provides a unified UI for any RSP (Runtime Server Protocol) provider to contribute their RSP implementation to.

Warning: Not a standalone extension

This extension on its own provides no support for any specific runtimes. If you install only this extension, the views and actions may appear not to function.

To be used properly, this extension requires other contributing extensions that provide implementations that start or stop specific RSP instances and are capable of managing specific server or runtime types.

Commands and features

This extension supports a number of commands for interacting with supported server adapters; these are accessible via the command menu (Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows and Linux) and may be bound to keys in the normal way.

Available Commands

• Add Server Location - Selects the path of the server location and display in the SERVERS Explorer stack. • Start - From the list of servers present, select the server to start. • Restart - From the list of servers present, select the server to restart. • Stop - From the list of servers present, select the server to stop. • Remove - From the list of servers present, select the server to be removed. • Debug - From the list of servers present, select the server to run in Debug mode. • Add Deployment to Server - Add a deployable file or folder to the server to be published. • Remove Deployment from Server - Remove a deployment from the server. • Publish Server (Full) - Publish the server, synchronizing the content of deployments from your workspace to the server. • Show Output Channel - Select a particular server from the list to show its output channel in the editor. • Edit Server - View a JSON representation of your server in an editor, and submit changes to properties back to the RSP. • Download Runtime - Some server types may expose to the user methods to download a version of specific runtimes or frameworks, extract them, and set them up to be used by the RSP. • Server Actions - Some server types may expose to the user arbitrary actions that the user may invoke, such as changing some configuration options, opening a web browser, or editing a configuration file. These server-contributed actions have few restrictions placed on them by the framework other than what may be done on the client-side. • Run on Server - By selecting an application (e.g war file) directly from the explorer context view, the application will be deployed and the server started. • Debug on Server - By selecting an application (e.g war file) directly from the explorer context view, the application will be deployed and the server started in Debug mode.

Extension Settings

This extension contributes the following settings:

• vscodeAdapters.showChannelOnServerOutput: enable/disable the server output channel logs • rsp-ui.rsp.java.home: Specifies the path to a full JDK (version 11 or newer) which will be used to launch the Runtime Server Protocol (RSP) Server, as well as be the default java to launch any Java-based runtimes that the RSP will control. On Windows, backslashes must be escaped, i.e. "rsp-ui.rsp.java.home":"C:\\Program Files\\Java\\jdk-11.0.13" • rsp-ui.enableStartServerOnActivation: Specifies which RSP Server have to be automatically started during activation. If option is disabled, user will have to manually start the RSP Server through command palette or context menu • rsp-ui.enableAsyncPublish: enable/disable async publishing • rsp-ui.enableCustomServerLocation: when enabled, server definitions are stored in the path specified by rsp-ui.customServerLocation instead of the RSP data directory • rsp-ui.customServerLocation: path where server definitions are stored when rsp-ui.enableCustomServerLocation is enabled. If relative, resolved against the first workspace folder. If absolute, used as-is. Default: .rsp/servers

Server Parameters

To change Server Parameters, right-click on the server you want to edit and select Edit Server

Global Server Parameters

These settings are valid for all servers

• "id" - id server (read-only field, it cannot be changed) • "server.home.dir" - the path where the server runtime is stored (read-only field, it cannot be changed) • "server.autopublish.enabled" - Enable the autopublisher • "server.autopublish.inactivity.limit" - Set the inactivity limit before the autopublisher runs • "server.timeout.startup" - set how long (ms) to wait for a server to be recognized as started before giving up • "server.timeout.shutdown" - set how long (ms) to wait for a server to be recognized as stopped before giving up • "vm.install.path" - A string representation pointing to a java home. If not set, rsp-ui.rsp.java.home will be used instead • "deployables" - the list of deployables. It contains all informations related to each deployable.

Provisional Global Server Parameters…

Description from the VS Code Marketplace listing.