Merge branch 'master' into jinbo_bugfix

Author: testforstephen

README.md

@@ -35,6 +35,36 @@ mvnw.cmd clean install
 ./mvnw clean install
 ```
 
+
+## Usage with eclipse.jdt.ls
+
+To use `java-debug` as a [jdt.ls](https://github.com/eclipse/eclipse.jdt.ls) plugin, an [LSP client](https://langserver.org/) has to launch [jdt.ls](https://github.com/eclipse/eclipse.jdt.ls) with `initializationOptions` that contain the path to the built `java-debug` jar within a `bundles` array:
+
+
+```
+{
+    "initializationOptions": {
+        "bundles": [
+            "path/to/microsoft/java-debug/com.microsoft.java.debug.plugin/target/com.microsoft.java.debug.plugin-<version>.jar"
+        ]
+    }
+}
+```
+
+Editor extensions like [vscode-java](https://github.com/redhat-developer/vscode-java) take care of this.
+
+
+Once `eclipse.jdt.ls` launched, the client can send a [Command](https://microsoft.github.io/language-server-protocol/specifications/specification-current/#command) 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.
+
+
 License
 -------
 EPL 1.0, See [LICENSE](LICENSE.txt) file.

com.microsoft.java.debug.plugin/plugin.xml

@@ -17,6 +17,7 @@
             <command id="vscode.java.resolveBuildFiles"/>
             <command id="vscode.java.isOnClasspath"/>
             <command id="vscode.java.resolveJavaExecutable"/>
+            <command id="vscode.java.fetchPlatformSettings"/>
        </delegateCommandHandler>
    </extension>
 </plugin>

com.microsoft.java.debug.plugin/src/main/java/com/microsoft/java/debug/plugin/internal/JavaDebugDelegateCommandHandler.java

@@ -44,6 +44,7 @@ public class JavaDebugDelegateCommandHandler implements IDelegateCommandHandler
     public static final String RESOLVE_BUILD_FILES = "vscode.java.resolveBuildFiles";
     public static final String IS_ON_CLASSPATH = "vscode.java.isOnClasspath";
     public static final String RESOLVE_JAVA_EXECUTABLE = "vscode.java.resolveJavaExecutable";
+    public static final String FETCH_PLATFORM_SETTINGS = "vscode.java.fetchPlatformSettings";
 
     @Override
     public Object executeCommand(String commandId, List<Object> arguments, IProgressMonitor progress) throws Exception {
@@ -81,6 +82,8 @@ public Object executeCommand(String commandId, List<Object> arguments, IProgress
                 return isOnClasspath(arguments);
             case RESOLVE_JAVA_EXECUTABLE:
                 return ResolveJavaExecutableHandler.resolveJavaExecutable(arguments);
+            case FETCH_PLATFORM_SETTINGS:
+                return PlatformSettings.getPlatformSettings();
             default:
                 break;
         }

com.microsoft.java.debug.plugin/src/main/java/com/microsoft/java/debug/plugin/internal/PlatformSettings.java

@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2020 Microsoft Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *     Microsoft Corporation - initial API and implementation
+ *******************************************************************************/
+
+package com.microsoft.java.debug.plugin.internal;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import org.eclipse.jdt.core.JavaCore;
+
+public class PlatformSettings {
+
+    /**
+     * Resolve the JDT platform settings.
+     */
+    public static Map<String, String> getPlatformSettings() {
+        Map<String, String> result = new HashMap<>();
+        result.put("latestSupportedJavaVersion", JavaCore.latestSupportedJavaVersion());
+        return result;
+    }
+}