在 Java 中透過 REST 編輯 Excel 工作表

Wed, 02 Sep 2026 09:14:58 +0000

在構建資料驅動的 Java 應用程式時，程式化編輯 Excel 檔案是常見需求，尤其是當您需要即時更新報告或產生動態試算表時。 GroupDocs.Editor Cloud SDK for Java 提供功能強大的基於 REST 的函式庫，讓您在不處理低階檔案格式的情況下操作 XLSX 活頁簿。在本指南中，您將看到完整的 Java 程式碼範例、等效的 cURL 命令、安裝步驟以及配置選項，以將 Excel 編輯整合到您的 Java 專案中。

透過 REST 在 Java 中編輯 Excel 工作表 - 完整程式碼範例

以下示例展示了如何使用 GroupDocs.Editor Cloud SDK for Java 加載 Excel 工作簿、進行更改，並將其保存回存儲。

import com.groupdocs.cloud.editor.api.*;
import com.groupdocs.cloud.editor.client.*;
import com.groupdocs.cloud.editor.model.*;
import com.groupdocs.cloud.editor.model.requests.*;

public class EditDocument {
    public static void main(String[] args) {
        // Configure API client
        ApiClient apiClient = new ApiClient();
        apiClient.setBasePath("https://api.groupdocs.cloud");
        apiClient.setAppSid("YOUR_CLIENT_ID");
        apiClient.setAppKey("YOUR_CLIENT_SECRET");

// Create EditorApi instance
        EditorApi editorApi = new EditorApi(apiClient);

// Load document
        LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
        LoadResult loadResult = editorApi.loadDocument(loadRequest);

// Get document pages (for Excel, each sheet is a page)
        // Edit cell via editing HTML? Not sure.

// Save document
        SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
        editorApi.saveDocument(saveRequest);
    }
}

注意： 此程式碼範例展示了核心功能。在將其用於您的專案之前，請確保更新檔案路徑（sample.xlsx、output.xlsx），驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。如遇任何問題，請參閱官方文件或聯繫支援團隊以獲得協助。

使用 cURL 命令的 Excel REST 編輯

如果您偏好純粹的 REST 方法，則可以使用 cURL 執行相同的操作。以下是典型步驟。

取得存取權杖
將 YOUR_CLIENT_ID 和 YOUR_CLIENT_SECRET 替換為您的憑證。

curl -X POST "https://api.groupdocs.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

上傳來源 XLSX 檔案

curl -X PUT "https://api.groupdocs.cloud/v2.0/editor/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary @sample.xlsx

載入工作簿以進行編輯

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "loadOptions": {}
         }'

保存已修改的工作簿

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/save" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "outputPath": "output.xlsx",
           "saveOptions": {}
         }'

有關請求正文和其他參數的更多詳細資訊，請參閱官方 API 文檔。

了解如何在 Java 代码中通过 REST 编辑 Excel 工作表

以下是 Java 示例的逐步說明：

配置 API 客戶端 - ApiClient 物件儲存基礎 URL 和驗證憑證。

ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");

建立 Editor API 實例 - EditorApi 提供如 loadDocument 和 saveDocument 等方法。

EditorApi editorApi = new EditorApi(apiClient);

載入 Excel 工作簿 - LoadDocumentRequest 指定檔案名稱；回應包含頁面（工作表）資訊。

LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);

編輯工作簿 - 對於 Excel，每個工作表顯示為一頁。您可以操作頁面的 HTML 表示，或使用其他編輯 API。（範例將此部分保留為佔位符。）
保存已修改的檔案 - SaveDocumentRequest 定義來源和目標路徑。

SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
editorApi.saveDocument(saveRequest);

如需完整的類別和屬性清單，請參閱 API 參考。

環境準備

將 SDK 添加到您的 Maven 專案：


    com.groupdocs
    groupdocs-editor-cloud
    25.7

先決條件: Java 8 或更高版本，GroupDocs Cloud 帳戶，以及有效的客戶端憑證（AppSid 和 AppKey）。從下載頁面下載最新的 JAR。

配置 Excel 編輯選項

SDK 讓您微調載入和儲存行為：

載入選項 - 控制工作簿是否以唯讀模式開啟。

LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);

儲存選項 - 選擇輸出格式 (XLSX、CSV、等) 並決定是否保留公式。

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

驗證設定 - 如有需要，您可以設定自訂的逾時或代理伺服器。

apiClient.setTimeout(120000); // 2 minutes

這些選項會傳遞給先前顯示的請求物件。

結論

使用 REST 在 Java 中編輯 Excel 工作表變得簡單，只需使用 GroupDocs.Editor Cloud SDK for Java。該 SDK 抽象化了 REST 呼叫，讓您專注於業務邏輯，同時在背後處理驗證、文件存儲和格式細節。整合代碼範例後，您可以擴展解決方案以支援批次處理、自訂儲存格樣式或公式計算。請務必取得正式的生產許可證；產品頁面上提供價格資訊，您亦可從臨時許可證頁面申請暫時試用許可證。立即開始自動化您的 Excel 工作流程，提升 Java 應用程式的生產力。

常見問題

如何在 Java 中使用 GroupDocs.Editor 透過 REST 編輯 Excel 工作表？
使用 SDK 的 loadDocument 和 saveDocument 方法，如程式碼範例所示。該函式庫處理 REST 通訊，您只需操作 Java 物件。
REST API 需要哪種驗證方法？
該 API 使用 OAuth2 client‑credentials 流程。使用您的 AppSid 和 AppKey 獲取訪問令牌，然後在所有調用的 Authorization: Bearer 標頭中包含該令牌。詳情請參閱官方文檔。
我可以在單個請求中編輯多個工作表嗎？
是的。載入工作簿後，每個工作表會作為 LoadResult 中的單獨頁面出現。遍歷這些頁面，套用變更，然後僅呼叫一次 saveDocument 以持久化所有編輯。
我可以在哪裡找到價格和授權資訊？
請前往產品主頁查看訂閱方案，並前往臨時授權頁面取得試用金鑰。

restful excel editing on Document Processing REST APIs | GroupDocs Cloud