Chỉnh sửa bảng Excel qua REST trong Java

Việc chỉnh sửa tệp Excel bằng chương trình là một yêu cầu thường gặp khi xây dựng các ứng dụng Java dựa trên dữ liệu, đặc biệt khi bạn cần cập nhật báo cáo hoặc tạo bảng tính động ngay lập tức. GroupDocs.Editor Cloud SDK for Java cung cấp một thư viện mạnh mẽ dựa trên REST cho phép bạn thao tác các sổ làm việc XLSX mà không cần xử lý các định dạng tệp cấp thấp. Trong hướng dẫn này, bạn sẽ thấy một ví dụ mã Java đầy đủ, các lệnh cURL tương đương, các bước cài đặt và các tùy chọn cấu hình để tích hợp việc chỉnh sửa Excel vào các dự án Java của mình.

Chỉnh sửa bảng tính Excel qua REST trong Java - Ví dụ mã hoàn chỉnh

Ví dụ sau đây cho thấy cách tải một workbook Excel, thực hiện các thay đổi và lưu lại vào bộ nhớ lưu trữ bằng cách sử dụng GroupDocs.Editor Cloud SDK for Java.

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);
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (sample.xlsx, output.xlsx), xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển của bạn. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Chỉnh sửa Excel REST bằng các lệnh cURL

Nếu bạn muốn sử dụng cách tiếp cận REST thuần túy, cùng một thao tác có thể được thực hiện bằng cURL. Dưới đây là các bước điển hình.

1. Lấy token truy cập
   Thay thế YOUR_CLIENT_ID và YOUR_CLIENT_SECRET bằng thông tin xác thực của bạn.

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"

2. Tải lên tệp XLSX nguồn

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

3. Tải workbook để chỉnh sửa

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": {}
         }'

4. Lưu workbook đã chỉnh sửa

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": {}
         }'

Để biết thêm chi tiết về các thân yêu cầu và các tham số bổ sung, xem tài liệu API chính thức.

Hiểu về việc chỉnh sửa bảng tính Excel qua REST trong mã Java

Dưới đây là phân tích chi tiết từng bước của ví dụ Java:

1. Cấu hình API client - Đối tượng ApiClient lưu trữ URL cơ bản và thông tin xác thực.

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

2. Tạo thể hiện Editor API - EditorApi cung cấp các phương thức như loadDocument và saveDocument.

EditorApi editorApi = new EditorApi(apiClient);

3. Tải workbook Excel - LoadDocumentRequest xác định tên tệp; phản hồi chứa thông tin trang (sheet).

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

4. Chỉnh sửa sổ làm việc - Đối với Excel, mỗi sheet xuất hiện như một trang. Bạn có thể thao tác với biểu diễn HTML của một trang hoặc sử dụng các API chỉnh sửa khác. (Ví dụ này để lại phần này như một chỗ giữ chỗ.)

5. Lưu tệp đã chỉnh sửa - SaveDocumentRequest xác định các đường dẫn nguồn và đích.

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

Để xem danh sách đầy đủ các lớp và thuộc tính, tham khảo API reference.

Chuẩn bị môi trường

Thêm SDK vào dự án Maven của bạn:

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

Yêu cầu trước: Java 8 hoặc cao hơn, một tài khoản GroupDocs Cloud, và thông tin xác thực khách hàng hợp lệ (AppSid và AppKey). Tải xuống các tệp JAR mới nhất từ trang tải xuống.

Cấu hình các tùy chọn chỉnh sửa Excel

SDK cho phép bạn tinh chỉnh hành vi tải và lưu:

1. Tùy chọn tải - Kiểm soát việc sổ làm việc có được mở ở chế độ chỉ đọc hay không.

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

2. Tùy chọn lưu - Chọn định dạng đầu ra (XLSX, CSV, v.v.) và liệu có giữ lại công thức hay không.

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

3. Cài đặt xác thực - Bạn có thể đặt thời gian chờ tùy chỉnh hoặc proxy nếu cần.

apiClient.setTimeout(120000); // 2 minutes

Các tùy chọn này được truyền cho các đối tượng yêu cầu đã được hiển thị trước đó.

Kết luận

Việc chỉnh sửa một bảng tính Excel qua REST trong Java trở nên đơn giản với GroupDocs.Editor Cloud SDK for Java. SDK trừu tượng hoá các cuộc gọi REST, cho phép bạn tập trung vào logic nghiệp vụ trong khi xử lý xác thực, lưu trữ tệp và các chi tiết định dạng phía sau. Sau khi tích hợp ví dụ mã, bạn có thể mở rộng giải pháp để hỗ trợ xử lý hàng loạt, tùy chỉnh kiểu dáng cell hoặc đánh giá công thức. Hãy nhớ lấy giấy phép phù hợp cho môi trường sản xuất; chi tiết giá cả có trên trang sản phẩm, và bạn có thể yêu cầu giấy phép dùng thử tạm thời từ trang giấy phép tạm thời. Bắt đầu tự động hoá quy trình Excel của bạn ngay hôm nay và tăng năng suất cho các ứng dụng Java của bạn.

Câu hỏi thường gặp

• Làm thế nào để tôi có thể chỉnh sửa một bảng Excel qua REST trong Java bằng cách sử dụng GroupDocs.Editor?
  Sử dụng các phương thức loadDocument và saveDocument của SDK như được minh họa trong ví dụ mã. Thư viện xử lý việc giao tiếp REST, vì vậy bạn chỉ làm việc với các đối tượng Java.

• Phương thức xác thực nào mà REST API yêu cầu?
  API sử dụng luồng client‑credentials của OAuth2. Lấy token truy cập bằng AppSid và AppKey của bạn, sau đó đưa nó vào header Authorization: Bearer cho mọi cuộc gọi. Chi tiết có trong tài liệu chính thức.

• Tôi có thể chỉnh sửa nhiều bảng tính trong một yêu cầu duy nhất không?
  Có. Sau khi tải workbook, mỗi worksheet xuất hiện như một trang riêng trong LoadResult. Duyệt qua các trang, áp dụng các thay đổi và gọi saveDocument một lần để lưu lại tất cả các chỉnh sửa.

• Ở đâu tôi có thể tìm thông tin về giá và giấy phép?
  Truy cập trang chính của sản phẩm để xem các gói đăng ký và trang giấy phép tạm thời để lấy khóa dùng thử.

Đọc thêm

• Chỉnh sửa tệp PowerPoint bằng Thư viện Java
• Chỉnh sửa tài liệu Word hoặc Excel bằng REST API
• Chỉnh sửa bảng tính Excel bằng REST API trong Python