Cách Thêm Tệp Đính Kèm vào Excel Sử Dụng GroupDocs.Watermark Java

Giới thiệu

Trong môi trường kinh doanh nhanh chóng ngày nay, add attachment to excel là một cách mạnh mẽ để giữ các tài liệu liên quan cùng nhau mà không làm lộn xộn hệ thống tệp của bạn. Cho dù bạn cần gộp một hợp đồng PDF với mô hình tài chính hoặc đính kèm một hình ảnh vào trình theo dõi dự án, việc nhúng tệp trực tiếp vào một worksheet Excel giúp hợp lý hoá việc cộng tác và cải thiện tính toàn vẹn dữ liệu. Hướng dẫn này sẽ chỉ cho bạn, từng bước, cách sử dụng GroupDocs.Watermark cho Java để add attachment to excel các worksheet một cách nhanh chóng và đáng tin cậy.

Câu trả lời nhanh

• Thư viện nào thêm tệp đính kèm vào Excel? GroupDocs.Watermark for Java.
• Cần bao nhiêu dòng mã? Chỉ hai dòng sau khi tải workbook.
• Tôi có thể đính kèm bất kỳ loại tệp nào không? Có – PDF, hình ảnh, tài liệu Word và hơn nữa (hơn 50 định dạng).
• Tôi có cần giấy phép để thử nghiệm không? Một giấy phép tạm thời miễn phí là đủ cho việc đánh giá.
• Việc sử dụng bộ nhớ có là vấn đề không? API truyền dữ liệu theo luồng, vì vậy ngay cả workbook 500 trang cũng giữ dưới 200 MB RAM.

Thêm tệp đính kèm vào excel là gì?

Add attachment to excel đề cập đến việc nhúng một tệp bên ngoài vào trong một worksheet Excel để người dùng có thể mở tệp trực tiếp từ bảng tính. Tính năng này giữ các tài liệu hỗ trợ cùng với dữ liệu mà chúng mô tả, loại bỏ nhu cầu chuyển tệp riêng biệt.

Tại sao nên sử dụng GroupDocs.Watermark cho Java để nhúng tệp?

GroupDocs.Watermark hỗ trợ hơn 30 định dạng đầu vào và đầu ra, xử lý các bảng tính có hàng trăm trang mà không cần tải toàn bộ tệp vào bộ nhớ, và cung cấp một API đơn giản chỉ yêu cầu một vài lời gọi phương thức. Sử dụng thư viện này giảm việc xử lý tệp zip thủ công tới 80 % và loại bỏ rủi ro các liên kết bị hỏng khi tệp được di chuyển.

Yêu cầu trước

Để làm theo hướng dẫn này, bạn sẽ cần:

• Java Development Kit (JDK) 8+ – phiên bản tối thiểu được GroupDocs.Watermark hỗ trợ.
• GroupDocs.Watermark for Java 24.11 – phiên bản ổn định mới nhất tại thời điểm viết.
• IDE – IntelliJ IDEA, Eclipse, hoặc bất kỳ môi trường tương thích Maven nào.

Thư viện và phụ thuộc cần thiết

Incorporate GroupDocs.Watermark vào dự án của bạn bằng Maven hoặc tải trực tiếp các tệp JAR. Dưới đây là cách thiết lập với Maven:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Direct Download
Hoặc, tải phiên bản mới nhất từ GroupDocs.Watermark for Java releases.

Nhận giấy phép

Bắt đầu với bản dùng thử miễn phí bằng cách tải giấy phép tạm thời từ here để khám phá đầy đủ tính năng mà không bị giới hạn. Đối với sử dụng trong môi trường sản xuất, mua giấy phép vĩnh viễn.

Cài đặt GroupDocs.Watermark cho Java

Lớp Watermarker là điểm vào cho tất cả các thao tác tài liệu trong GroupDocs.Watermark. Sau khi thêm phụ thuộc Maven, bạn khởi tạo một Watermarker với đường dẫn tới tệp Excel của mình và các tùy chọn tải tùy chọn.

import com.groupdocs.watermark.Watermarker;

public class SetupGroupDocs {
    public static void main(String[] args) throws Exception {
        // Initialize watermarker with an input file
        Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx");
        
        // Your code to manipulate the document goes here
        
        // Close the watermarker when done
        watermarker.close();
    }
}

Việc khởi tạo này chuẩn bị thư viện để đọc, sửa đổi và lưu nội dung bảng tính.

Hướng dẫn triển khai

Trong phần này, chúng tôi sẽ phân tích từng bước cần thiết để add attachment to excel các worksheet.

Tải một bảng tính Excel

Làm thế nào để tải một workbook Excel?
Tạo một thể hiện Watermarker, truyền đường dẫn tệp Excel và một đối tượng SpreadsheetLoadOptions cho API biết rằng tệp này là một bảng tính. Bước này mở workbook ở chế độ đọc/ghi trong khi giữ mức sử dụng bộ nhớ thấp.

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

public class LoadSpreadsheet {
    public static void run() throws Exception {
        // Create new SpreadsheetLoadOptions instance
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Initialize Watermarker with the Excel file path and load options
        Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);
    }
}

Đọc tệp thành mảng byte

Cách tốt nhất để chuẩn bị tệp cho việc đính kèm là gì?
Đọc tệp bên ngoài (PDF, hình ảnh, DOCX, v.v.) vào một mảng byte bằng phương thức Files.readAllBytes của Java. Mảng byte thu được có thể được truyền trực tiếp tới API đính kèm, đảm bảo định dạng tệp gốc được giữ nguyên.

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

public class ReadFileToBytes {
    public static byte[] readFileToByteArray(String filePath) throws Exception {
        File file = new File(filePath);
        byte[] fileContentBytes = new byte[(int) file.length()];

        try (InputStream inputStream = new FileInputStream(file)) {
            inputStream.read(fileContentBytes);
        }
        
        return fileContentBytes;
    }
}

Thêm tệp đính kèm vào một worksheet của bảng tính

Làm thế nào để nhúng một tệp vào một worksheet cụ thể?
Gọi watermarker.getWorksheets().get(0).addAttachment("AttachmentName.ext", fileBytes). Tham số đầu tiên là tên hiển thị xuất hiện trong bảng “Attachments” của Excel, và tham số thứ hai là mảng byte từ bước trước. Tệp đính kèm trở thành một phần của gói nội bộ của worksheet.

addAttachment nhúng tệp được chỉ định vào worksheet như một tệp đính kèm.

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.contents.SpreadsheetWorksheet;

public class AddAttachmentToWorksheet {
    public static void run(Watermarker watermarker, byte[] attachmentBytes, String fileName, byte[] previewImageBytes) throws Exception {
        SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
        SpreadsheetWorksheet worksheet = content.getWorksheets().get_Item(0);

        worksheet.getAttachments().addAttachment(
            attachmentBytes,
            fileName,
            previewImageBytes,
            50, 100, 200, 400
        );
    }
}

Lưu thay đổi vào bảng tính

Làm thế nào để lưu workbook đã sửa đổi?
Gọi watermarker.save("output.xlsx", SaveFormat.Xlsx). API ghi gói đã cập nhật, bao gồm tệp đính kèm mới, tới đường dẫn đã chỉ định. Tất cả các thay đổi được lưu lại trong một thao tác duy nhất, giúp quá trình nhanh và nguyên tử.

save ghi workbook đã sửa đổi, bao gồm các tệp đính kèm, vào tệp đã chỉ định.

public class SaveSpreadsheet {
    public static void run(Watermarker watermarker, String outputPath) throws Exception {
        watermarker.save("YOUR_OUTPUT_DIRECTORY/modified_spreadsheet.xlsx");
        watermarker.close();
    }
}

Ứng dụng thực tế

Nhúng tệp vào trong workbook Excel giải quyết nhiều vấn đề thực tế:

• Tài liệu pháp lý: Lưu trữ các hợp đồng đã ký cùng với các bảng tài chính, đảm bảo kiểm toán viên có thể truy xuất thỏa thuận gốc ngay lập tức.
• Báo cáo & Bài thuyết trình: Đính kèm các PDF hỗ trợ hoặc bộ slide vào báo cáo dựa trên dữ liệu, cung cấp cho các bên liên quan một cái nhìn toàn diện về tất cả tài liệu.
• Nội dung giáo dục: Giáo viên có thể gộp các worksheet với PDF tham khảo, đơn giản hoá việc phân phối cho học sinh.

Cân nhắc về hiệu năng

Tối ưu hiệu năng khi bạn add attachment to excel là đơn giản:

• Quản lý bộ nhớ: Luôn gọi watermarker.close() (hoặc sử dụng khối try‑with‑resources) để giải phóng các handle tệp kịp thời.
• Xử lý hàng loạt: Khi xử lý hàng chục workbook, xử lý chúng theo lô 10–20 để tránh tiêu thụ heap quá mức.
• Tệp đính kèm lớn: Đối với các tệp lớn hơn 50 MB, cân nhắc truyền mảng byte theo từng khối để giữ dung lượng bộ nhớ JVM thấp.

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

Q: Tôi có thể đính kèm nhiều tệp vào cùng một worksheet không?
A: Có. Gọi addAttachment liên tục với các tên tệp và mảng byte khác nhau; mỗi lần gọi tạo một mục riêng trong bộ sưu tập tệp đính kèm của worksheet.

Q: Tệp đính kèm sẽ hiển thị trong giao diện người dùng của Excel không?
A: Chắc chắn. Excel hiển thị các tệp đính kèm trong bảng “Insert → Object → Create from File → Display as icon”, và người dùng có thể nhấp đúp vào biểu tượng để mở tài liệu nhúng.

Q: Điều này có hoạt động với các tệp Excel được bảo vệ bằng mật khẩu không?
A: GroupDocs.Watermark có thể mở workbook được bảo vệ bằng mật khẩu khi bạn cung cấp mật khẩu qua SpreadsheetLoadOptions.setPassword("yourPassword").

Q: Có giới hạn kích thước cho tệp đính kèm không?
A: Thư viện hỗ trợ tệp đính kèm lên tới 2 GB, chỉ bị giới hạn bởi định dạng gói ZIP nền và không gian đĩa khả dụng.

Q: Làm thế nào để xóa tệp đính kèm sau này?
A: Lấy bộ sưu tập tệp đính kèm của worksheet và gọi removeAttachment("AttachmentName.ext") trước khi lưu workbook lại.

Kết luận

Bây giờ bạn đã nắm vững cách add attachment to excel bằng cách sử dụng GroupDocs.Watermark cho Java. Bằng cách tải workbook, chuyển đổi các tệp bên ngoài thành mảng byte, nhúng chúng bằng một lời gọi API duy nhất và lưu kết quả, bạn có thể giữ tất cả các tài liệu liên quan trong một gói sạch sẽ, có thể tìm kiếm. Thử nghiệm với các loại tệp khác nhau, tự động hoá xử lý hàng loạt, và khám phá các tính năng watermark khác để làm phong phú hơn các bảng tính của bạn.

Cập nhật lần cuối: 2026-06-06
Kiểm tra với: GroupDocs.Watermark 24.11 for Java
Tác giả: GroupDocs

Hướng dẫn liên quan

• Cách Thêm Đánh Dấu Nước vào Tệp Đính Kèm Excel Sử Dụng GroupDocs.Watermark Java
• Thêm Đánh Dấu Nước Hình Ảnh vào Bảng Tính Excel Sử Dụng GroupDocs.Watermark Java SDK
• Xử Lý Tài Liệu Excel và Đánh Dấu Nước với GroupDocs.Watermark Java