在 Java 中编辑 Word 文档

Mon, 28 Sep 2026 16:09:16 +0000

在构建协作式 Java 应用程序时，远程编辑 Microsoft Word 文件是一个常见的挑战。GroupDocs.Editor Cloud SDK for Java 提供了一个强大的基于 REST 的库，使您能够在 Java 中编辑 Word 文档，而无需自行处理文件解析。在本指南中，您将学习如何进行身份验证、替换文本、调用编辑端点，并下载更新后的 DOCX，所有内容均配有清晰的代码示例和性能技巧。

如何在 Java 中编辑 Word 文档 - 步骤指南

使用您的凭据配置 API 客户端：创建一个 Configuration 对象，设置 clientId、clientSecret 和基础 URL，然后实例化 ApiClient 和所需的 API。

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
config.setBaseUrl("https://api.groupdocs.cloud");

ApiClient apiClient = new ApiClient(config);
EditorApi editorApi = new EditorApi(apiClient);
FilesApi filesApi = new FilesApi(apiClient);

准备源 DOCX 的 FileInfo: 定义存储在 GroupDocs Cloud 中的输入文件的路径。

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.docx");

定义 ReplaceText 操作: 创建一个 ReplaceText 实例，使用您想要替换的文本，并将其添加到列表中。

ReplaceText replace = new ReplaceText();
replace.setOldValue("Hello");
replace.setNewValue("Hi");
List<ReplaceText> replaceList = new ArrayList<>();
replaceList.add(replace);

构建 EditDocumentOptions 并调用 editDocument：合并文件信息、编辑选项和输出设置，然后调用 editDocument 方法。这是实际在 Java 中编辑 Word 文档的核心步骤。

EditOptions editOptions = new EditOptions();
editOptions.setReplaceText(replaceList);

EditDocumentOptions options = new EditDocumentOptions();
options.setFileInfo(fileInfo);
options.setOutputPath("output.docx");
options.setFormat("docx");
options.setEditOptions(editOptions);

EditDocumentRequest editRequest = new EditDocumentRequest(options);
EditDocumentResult editResult = editorApi.editDocument(editRequest);
System.out.println("Document edited. Document ID: " + editResult.getDocumentId());

下载已编辑的 DOCX 文件: 使用 FilesApi 从云存储检索已编辑的文件。

DownloadFileRequest downloadRequest = new DownloadFileRequest("output.docx");
InputStream inputStream = filesApi.downloadFile(downloadRequest);
try (FileOutputStream outputStream = new FileOutputStream("downloaded_output.docx")) {
    byte[] buffer = new byte[8192];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
    }
    System.out.println("Edited document downloaded as downloaded_output.docx");
}

有关详细的类信息，请参阅 EditorApi 参考页面。

完整的 Java 中编辑 Word 文档的工作示例

以下示例演示了如何使用 GroupDocs.Editor Cloud SDK for Java 通过替换文本来编辑 DOCX 文件。

import com.groupdocs.editor.cloud.api.EditorApi;
import com.groupdocs.editor.cloud.api.FilesApi;
import com.groupdocs.editor.cloud.client.ApiClient;
import com.groupdocs.editor.cloud.client.ApiException;
import com.groupdocs.editor.cloud.client.Configuration;
import com.groupdocs.editor.cloud.model.EditDocumentOptions;
import com.groupdocs.editor.cloud.model.EditDocumentResult;
import com.groupdocs.editor.cloud.model.EditOptions;
import com.groupdocs.editor.cloud.model.FileInfo;
import com.groupdocs.editor.cloud.model.ReplaceText;
import com.groupdocs.editor.cloud.model.requests.EditDocumentRequest;
import com.groupdocs.editor.cloud.model.requests.DownloadFileRequest;

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

public class GroupDocsEditorExample {
    public static void main(String[] args) {
        // Configuration – replace with your actual credentials
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        config.setBaseUrl("https://api.groupdocs.cloud");

ApiClient apiClient = new ApiClient(config);
        EditorApi editorApi = new EditorApi(apiClient);
        FilesApi filesApi = new FilesApi(apiClient);

// Input and output file paths in the cloud storage
        String inputPath = "input.docx";
        String outputPath = "output.docx";

try {
            // Prepare file information
            FileInfo fileInfo = new FileInfo();
            fileInfo.setFilePath(inputPath);

// Define replace text operation
            ReplaceText replace = new ReplaceText();
            replace.setOldValue("Hello");
            replace.setNewValue("Hi");
            List<ReplaceText> replaceList = new ArrayList<>();
            replaceList.add(replace);

// Set edit options
            EditOptions editOptions = new EditOptions();
            editOptions.setReplaceText(replaceList);

// Build edit document options
            EditDocumentOptions options = new EditDocumentOptions();
            options.setFileInfo(fileInfo);
            options.setOutputPath(outputPath);
            options.setFormat("docx");
            options.setEditOptions(editOptions);

// Execute edit operation
            EditDocumentRequest editRequest = new EditDocumentRequest(options);
            EditDocumentResult editResult = editorApi.editDocument(editRequest);
            System.out.println("Document edited. Document ID: " + editResult.getDocumentId());

// Download the edited document
            DownloadFileRequest downloadRequest = new DownloadFileRequest(outputPath);
            InputStream inputStream = filesApi.downloadFile(downloadRequest);
            try (FileOutputStream outputStream = new FileOutputStream("downloaded_output.docx")) {
                byte[] buffer = new byte[8192];
                int bytesRead;
                while ((bytesRead = inputStream.read(buffer)) != -1) {
                    outputStream.write(buffer, 0, bytesRead);
                }
                System.out.println("Edited document downloaded as downloaded_output.docx");
            } finally {
                if (inputStream != null) {
                    inputStream.close();
                }
            }
        } catch (ApiException apiEx) {
            System.err.println("API error: " + apiEx.getMessage());
        } catch (IOException ioEx) {
            System.err.println("IO error: " + ioEx.getMessage());
        }
    }
}

Note: 这段代码示例演示了核心功能。在将其用于项目之前，请确保更新所有文件路径和配置值以匹配实际环境，验证已正确安装所有必需的依赖项，并在开发环境中进行彻底测试。如果遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

通过 REST 在 Java 中使用 cURL 修改 Word 文档

下面是一个 cURL 工作流，它执行相同的文本替换操作，而无需编写 Java 代码。它对于快速测试或与其他服务的集成非常有用。

获取访问令牌（将占位符替换为您的凭据）。

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

上传源 DOCX 到您的云存储。

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/local/input.docx"

调用 editDocument 端点，使用定义替换操作的 JSON 负载。

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit/document" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfo": { "filePath": "input.docx" },
        "outputPath": "output.docx",
        "format": "docx",
        "editOptions": {
            "replaceText": [
                { "oldValue": "Hello", "newValue": "Hi" }
            ]
        }
      }'

下载已编辑的文件 操作成功后。

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o downloaded_output.docx

有关完整的 REST 规范，请参阅 API 参考。

安装和配置 GroupDocs.Editor Cloud SDK for Java

使用提供的依赖代码段将 SDK 添加到您的 Maven 项目中。


    com.groupdocs
    groupdocs-editor-cloud
    25.7

从下载页面下载最新的 JAR 包。
确保您的 Java 运行时版本为 8 或更高，并且拥有有效的 GroupDocs Cloud 帐户以及客户端 ID 和密钥。

GroupDocs.Editor Cloud SDK for Java 的关键特性

Full Word Editing - 替换 DOCX、DOC 和 ODT 格式中的文本、图像和表格。
Cloud Storage Integration - 直接与 GroupDocs Cloud 存储配合使用，消除本地文件处理。
REST API Powered - 所有操作均通过安全的 HTTP 调用完成，适用于微服务架构。
Streaming Download - 大文档以流式方式下载，避免高内存消耗。
Extensible Options - 通过 EditOptions 微调编辑行为（例如，替换文本、删除批注）。

如需更深入的细节，请参阅官方文档。

配置文档编辑选项

EditOptions 对象允许您指定要应用的更改。在示例中我们使用了 replaceText，但您也可以配置其他操作，例如删除注释或更新字段。

EditOptions editOptions = new EditOptions();
editOptions.setReplaceText(replaceList); // replaceList defined earlier

其他选项，如 removeComments 或 updateFields，已在 API 参考中记录。

通过 REST 编辑 Word 的性能考虑

Use Streaming: SDK 对文件内容进行流式处理，可降低大型 DOCX 文件的堆内存使用。
Batch Replacements: 在单个请求中合并多个 ReplaceText 对象，以避免重复的网络调用。
Keep Files in Cloud: 直接在云端存储的文件上执行编辑操作，可避免多次上传和下载大型二进制文件的开销。
Reuse ApiClient: 只实例化一次 ApiClient，并在多个编辑操作中重复使用，以受益于连接池。

结论

在 Java 中编辑 Word 文档变得简单，只需使用 GroupDocs.Editor Cloud SDK for Java。按照此处提供的步骤、代码示例和 cURL 工作流，您可以将强大的文档编辑功能集成到任何 Java 后端服务中。请确保保护您的客户端凭据，使用来自临时许可证页面的临时许可证进行测试，并在迁移到生产环境时升级为正式许可证。祝编码愉快！

常见问题

如何在 Java 中使用 REST API 编辑 Word 文档？
使用 GroupDocs.Editor Cloud SDK for Java 的 editDocument 端点。发送定义替换操作的 JSON 负载，服务将返回已编辑的 DOCX。
什么是对 Editor API 调用进行身份验证的最佳方式？
创建一个包含您的客户端 ID 和客户端密钥的 Configuration 对象，然后让 SDK 自动获取 OAuth 令牌。请参阅官方文档了解更多详情。
我可以在一次请求中替换多个占位符吗？
是的。向 EditOptions 中的 replaceText 列表添加多个 ReplaceText 条目。SDK 会在一次编辑调用中处理所有替换。
我可以编辑的 Word 文件大小是否有限制？
云服务可以处理高达几百兆字节的文件，但为获得最佳性能，请将文件保持在 100 MB 以下，并使用流式下载以避免内存峰值。

rest document editing on Document Processing REST APIs | GroupDocs Cloud