feat: add build workspace API

Author: s1n7ax

doc/ts-to-lua-guide.md

@@ -0,0 +1,35 @@
+# Personal Notes
+
+## Communication
+
+We are using `request` function of `vim.lsp.Client` function to communicate with
+the `jdtls`.
+
+```lua
+fun(method: string, params: table?, handler: lsp.Handler?, bufnr: integer?): boolean, integer?`)
+```
+
+This has almost 1 to 1 mapping with `vscode` APIs most of the time.
+
+```typescript
+await this.languageClient.sendRequest(
+  method: string,
+  params: any,
+  // handler is not passed since there is async / await
+  // buffer I'm guessing is set to current buffer by default???
+);
+```
+
+However, some APIs sends more arguments, to which we don't have a Neovim lua
+equivalent I'm guessing. Following is an example.
+
+```typescript
+await this.languageClient.sendRequest(
+  CompileWorkspaceRequest.type,
+  isFullCompile,
+  token,
+);
+```
+
+To make this request, probably `client.rpc.request` should be used without
+`request()` wrapper.

lua/java-core/ls/clients/java-debug-client.lua

@@ -71,20 +71,12 @@ function DebugClient:start_debug_session()
 	return self:workspace_execute_command('vscode.java.startDebugSession')
 end
 
----@enum CompileWorkspaceStatus
-DebugClient.CompileWorkspaceStatus = {
-	FAILED = 0,
-	SUCCEED = 1,
-	WITHERROR = 2,
-	CANCELLED = 3,
-}
-
 ---Build the workspace
 ---@param main_class string
 ---@param project_name? string
 ---@param file_path? string
 ---@param is_full_build boolean
----@return CompileWorkspaceStatus # compiled status
+---@return java-core.CompileWorkspaceStatus # compiled status
 function DebugClient:build_workspace(
 	main_class,
 	project_name,

lua/java-core/ls/clients/jdtls-client.lua

@@ -3,10 +3,11 @@ local class = require('java-core.utils.class')
 local async = require('java-core.utils.async')
 local await = async.wait_handle_error
 
----@alias jdtls.RequestMethod
+---@alias java-core.JdtlsRequestMethod
 ---| 'workspace/executeCommand'
 ---| 'java/inferSelection'
 ---| 'java/getRefactorEdit'
+---| 'java/buildWorkspace'
 
 ---@alias jdtls.CodeActionCommand
 ---| 'extractVariable'
@@ -55,7 +56,7 @@ function JdtlsClient:new(args)
 end
 
 ---Sends a LSP request
----@param method jdtls.RequestMethod
+---@param method java-core.JdtlsRequestMethod
 ---@param params lsp.ExecuteCommandParams
 ---@param buffer? number
 function JdtlsClient:request(method, params, buffer)
@@ -124,6 +125,16 @@ function JdtlsClient:java_get_refactor_edit(
 	return self:request('java/getRefactorEdit', params, buffer)
 end
 
+---Compile the workspace
+---@param is_full_compile boolean if true, a complete full compile of the
+---workspace will be executed
+---@param buffer number
+---@return java-core.CompileWorkspaceStatus
+function JdtlsClient:java_build_workspace(is_full_compile, buffer)
+	---@diagnostic disable-next-line: param-type-mismatch
+	return self:request('java/buildWorkspace', is_full_compile, buffer)
+end
+
 ---Returns the decompiled class file content
 ---@param uri string uri of the class file
 ---@return string # decompiled file content

lua/java-core/types/jdtls-types.lua

@@ -1,3 +1,11 @@
----@alias jdtls.RequestMethod
----| 'workspace/executeCommand'
----| 'java/inferSelection'
+local M = {}
+
+---@enum java-core.CompileWorkspaceStatus
+M.CompileWorkspaceStatus = {
+	FAILED = 0,
+	SUCCEED = 1,
+	WITHERROR = 2,
+	CANCELLED = 3,
+}
+
+return M