fix: expose stdio transport fallback (#300)

Author: chemzqm

Readme.md

@@ -131,6 +131,8 @@ The following coc.nvim settings are supported (checkout `:h coc-configuration` f
 - `java.jdt.ls.statusIcons`: Specifies the status icon for the Java Language Server. The status icon is displayed in the status bar when the Java Language Server is running. default to {"busy": "Busy", "ready": "OK", "warning": "Warning", "Error", "Error"} Default: `null`
 - `java.jdt.ls.java.home`: Specifies the folder path to the JDK (17 or more recent) used to launch the Java Language Server. This setting will replace the Java extension's embedded JRE to start the Java Language Server. On Windows, backslashes must be escaped, i.e. "java.jdt.ls.java.home":"C:\\Program Files\\Java\\jdk-17.0_3" Default: `null`
 - `java.jdt.ls.vmargs`: Specifies extra VM arguments used to launch the Java Language Server. Eg. use `-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx1G -Xms100m -Xlog:disable` to optimize memory usage with the parallel garbage collector Default: `"-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx1G -Xms100m -Xlog:disable"`
+- `java.transport`: Transport used to communicate with the Java Language Server. Use `"stdio"` when the default pipe transport cannot establish a connection. Default: `"pipe"`
+  Valid options: ["pipe","stdio"]
 - `java.errors.incompleteClasspath.severity`: Specifies the severity of the message when the classpath is incomplete for a Java file Default: `"warning"`
   Valid options: ["ignore","info","warning","error"]
 - `java.configuration.checkProjectSettingsExclusions`: Controls whether to exclude extension-generated project settings files (.project, .classpath, .factorypath, .settings/) from the file explorer. Default: `false`

package.json

@@ -118,6 +118,16 @@
           "description": "Specifies extra VM arguments used to launch the Java Language Server. Eg. use `-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx2G -Xms100m -Xlog:disable` to optimize memory usage with the parallel garbage collector",
           "scope": "machine-overridable"
         },
+        "java.transport": {
+          "type": "string",
+          "enum": [
+            "pipe",
+            "stdio"
+          ],
+          "default": "pipe",
+          "description": "Transport used to communicate with the Java Language Server. Use 'stdio' when the default pipe transport cannot establish a connection.",
+          "scope": "machine-overridable"
+        },
         "java.errors.incompleteClasspath.severity": {
           "type": [
             "string"

test/contracts.test.ts

@@ -164,11 +164,16 @@ describe('coc-java fast contracts', () => {
   it('loads every contributed Java setting and forwards it during initialization', () => {
     const properties = packageJson.contributes.configuration.properties as Record<string, ConfigurationSchema>
     const entries = Object.entries(properties)
-    assert.equal(entries.length, 133, 'update this contract when settings are intentionally added or removed')
+    assert.equal(entries.length, 134, 'update this contract when settings are intentionally added or removed')
+
+    const transport = properties['java.transport']
+    assert.equal(transport?.default, 'pipe')
+    assert.deepEqual(transport?.enum, ['pipe', 'stdio'])
 
     const javaSettings = virtualServer.getState().initializeParams?.initializationOptions?.settings?.java
     assert.ok(javaSettings, 'the virtual server should capture Java initialization settings')
     assert.equal(javaSettings.jdt.ls.kotlinSupport.enabled, true)
+    assert.equal(javaSettings.transport, 'stdio', 'the configured client transport should be forwarded')
     assert.equal(javaSettings.inlayHints.formatParameters.enabled, false)
     assert.equal(javaSettings.search.scope, 'all')
     assert.equal(