Repository files navigation

The Java Debug Server is an implementation of Visual Studio Code (VSCode) Debug Protocol. It can be used in Visual Studio Code to debug Java programs.

• Launch/Attach
• Breakpoints
• Exceptions
• Pause & Continue
• Step In/Out/Over
• Variables
• Callstacks
• Threads
• Debug console

The Java Debug Server is the bridge between VSCode and JVM. The implementation is based on JDI (Java Debug Interface). It works withEclipse JDT Language Server as an add-on to provide debug functionalities.

• com.microsoft.java.debug.core - the core logic of the debug server
• com.microsoft.java.debug.plugin - wraps the debug server into an Eclipse plugin to work with Eclipse JDT Language Server

mvnw.cmd clean install

./mvnw clean install

To usejava-debug as ajdt.ls plugin, anLSP client has to launchjdt.ls withinitializationOptions that contain the path to the builtjava-debug jar within abundles array:

{    "initializationOptions": {        "bundles": [            "path/to/microsoft/java-debug/com.microsoft.java.debug.plugin/target/com.microsoft.java.debug.plugin-<version>.jar"        ]    }}

Editor extensions likevscode-java take care of this.

Onceeclipse.jdt.ls launched, the client can send aCommand to the server to start a debug session:

{  "command": "vscode.java.startDebugSession"}

The response to this request will contain a port number on which the debug adapter is listening, and to which a client implementing the debug-adapter protocol can connect to.

EPL 1.0, SeeLICENSE file.