Chuyển đổi bảng tính Excel sang JSON là một yêu cầu thường gặp khi xây dựng các pipeline trao đổi dữ liệu hoặc cung cấp cho các API. Conholdate.Total for Java là một SDK mạnh mẽ giúp đơn giản hoá công việc này cho các nhà phát triển Java. Trong hướng dẫn này, bạn sẽ học cách thiết lập thư viện, đi qua một triển khai đầy đủ, và tinh chỉnh các tùy chọn chuyển đổi để phù hợp với nhu cầu dự án của bạn.

Các yêu cầu trước và cài đặt cho Conholdate.Total for Java

Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có:

  • Java 17 hoặc mới hơn đã được cài đặt.
  • Maven 3.6+ để quản lý phụ thuộc.
  • Một tệp Excel (.xlsx) mà bạn muốn chuyển đổi.

Thêm kho Maven của Conholdate.Total và phụ thuộc vào tệp pom.xml của bạn:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Bạn cũng có thể tải xuống các JAR mới nhất trực tiếp từ trang tải xuống. Với SDK đã sẵn sàng, bạn đã sẵn sàng bắt đầu chuyển đổi excel sang JSON trong Java.

Chuyển đổi Excel sang JSON trong Java: Hướng dẫn từng bước

Bước 1: Tải tài liệu Excel nguồn

Đầu tiên, chỉ định đường dẫn tới tệp XLSX nguồn và tạo một thể hiện Conversion. Khối try‑with‑resources đảm bảo đối tượng chuyển đổi được giải phóng đúng cách.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

Bước 2: Cấu hình các tùy chọn chuyển đổi JSON

Tạo một đối tượng JsonConvertOptions và điều chỉnh các cài đặt như pretty‑print, bao gồm tiêu đề, định dạng ngày và số tùy chỉnh, và kích thước batch. Các tùy chọn này kiểm soát cách chuyển đổi excel sang JSON trong Java định hình đầu ra cuối cùng.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

Bước 3: Thực hiện chuyển đổi

Cung cấp tên tệp JSON đích và gọi phương thức convert. SDK xử lý việc chuyển đổi bên trong.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

Bước 4: Xử lý kết quả và dọn dẹp

Sau khi chuyển đổi, xuất ra một thông báo xác nhận. Bất kỳ ngoại lệ nào cũng được bắt và in ra console.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

Với các bước này, việc chuyển đổi excel sang JSON trong Java đã hoàn thành, và bạn có thể tích hợp JSON đã tạo vào API hoặc quy trình xử lý dữ liệu của mình.

Triển khai đầy đủ: Chuyển đổi Excel sang JSON bằng Java

Ví dụ sau đây minh họa cách thực hiện chuyển đổi excel sang JSON trong Java bằng Conholdate.Total for Java.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

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 mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, 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. 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.

Tùy chọn và Cài đặt chuyển đổi

SDK cung cấp một số tùy chọn để tùy chỉnh đầu ra JSON:

  • Pretty Print - Cải thiện khả năng đọc bằng cách thêm thụt lề.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Sử dụng hàng đầu tiên của bảng tính làm tên thuộc tính.
    setIncludeHeaders(true) (xem API reference).
  • Custom Date Format - Định nghĩa mẫu ngày, ví dụ, "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Kiểm soát độ chính xác số, ví dụ, "#.##".
    setCustomNumberFormat("#.##").

Việc điều chỉnh các thiết lập này cho phép bạn căn chỉnh JSON được tạo ra với mong đợi của các dịch vụ hoặc cơ sở dữ liệu hạ tầng.

Kết luận

Bạn bây giờ đã có một chuyển đổi Excel sang JSON hoạt động trong triển khai Java nhờ Conholdate.Total for Java. SDK xử lý các công việc nặng, trong khi các tùy chọn có thể cấu hình cho phép bạn kiểm soát định dạng và hiệu suất. Hãy nhớ lấy giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; bạn có thể yêu cầu một trang giấy phép tạm thời để đánh giá thư viện hoặc xem xét toàn bộ trang giá để biết các điều khoản thương mại. Chúc bạn lập trình vui vẻ!

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

  • Làm thế nào để tôi thực hiện chuyển đổi Excel sang JSON trong Java với Conholdate.Total?
    Sử dụng lớp Conversion cùng với JsonConvertOptions như được minh họa trong ví dụ mã. SDK trừu tượng hoá việc xử lý tệp và cung cấp một lời gọi convert duy nhất.

  • Tôi có thể tùy chỉnh định dạng ngày và số trong quá trình chuyển đổi excel sang JSON trong Java không?
    Có. Các phương thức setCustomDateFormat và setCustomNumberFormat cho phép bạn định nghĩa các mẫu phù hợp với mong đợi của hệ thống đích.

  • Các tùy chọn cấp phép nào có sẵn cho Conholdate.Total for Java?
    Bạn có thể nhận giấy phép đánh giá tạm thời từ temporary license page hoặc mua giấy phép đầy đủ qua pricing page.

  • Có hỗ trợ xử lý theo lô cho các tệp Excel lớn không?
    Tùy chọn setRowsPerBatch cho phép bạn xử lý các worksheet theo từng khối, rất phù hợp cho các kịch bản chuyển đổi theo lô.

Read More