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

在構建資料驅動的 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 專案：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

先決條件: 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 以持久化所有編輯。
我可以在哪裡找到價格和授權資訊？
請前往產品主頁查看訂閱方案，並前往臨時授權頁面取得試用金鑰。

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

使用 cURL 命令的 Excel REST 編輯#

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

環境準備#

配置 Excel 編輯選項#

結論#

常見問題#

閱讀更多#