Tambahkan watermark ke excel menggunakan GroupDocs.Watermark Java

Memberi watermark pada file Excel Anda dapat menjadi pengubah permainan—baik Anda perlu melindungi data sensitif, memberi merek pada laporan, atau sekadar menambahkan sentuhan profesional. Dalam tutorial ini Anda akan belajar cara menambahkan watermark ke excel pada spreadsheet menggunakan GroupDocs.Watermark untuk Java, dengan penjelasan yang jelas, contoh penggunaan dunia nyata, dan tips untuk menghindari jebakan umum.

Jawaban Cepat

• Perpustakaan apa yang saya butuhkan? GroupDocs.Watermark untuk Java (versi terbaru).
• Format Excel apa yang didukung? file .xlsx dan .xls (tidak terenkripsi).
• Bisakah saya menambahkan watermark gambar? Ya – SDK mendukung watermark teks dan gambar.
• Apakah saya memerlukan lisensi untuk produksi? Lisensi komersial diperlukan untuk penerapan non‑trial.
• Berapa lama implementasinya? Sekitar 10‑15 menit untuk watermark teks dasar.

Apa itu add watermark to excel?

Menambahkan watermark ke workbook Excel berarti menempelkan teks atau gambar yang terlihat (atau semi‑transparan) pada setiap lembar kerja atau dokumen tersemat. Ini membantu Anda menegaskan kepemilikan, menunjukkan kerahasiaan, atau memperkuat merek di seluruh file.

Mengapa menggunakan GroupDocs.Watermark untuk Java?

GroupDocs.Watermark menawarkan API tingkat tinggi yang menyederhanakan kompleksitas penanganan struktur Office Open XML. Ini memungkinkan Anda:

• Menerapkan watermark ke beberapa lembar kerja dalam satu panggilan.
• Menangani lampiran tersemat (mis., PDF tersemat) secara otomatis.
• Mempertahankan format dan rumus asli.
• Bekerja dengan watermark teks dan gambar (mis., add image watermark java).

Prasyarat

• Lingkungan Pengembangan Java – Java 8 atau lebih tinggi (JDK).
• GroupDocs.Watermark untuk Java SDK – unduh rilis terbaru dari here.
• IDE – IntelliJ IDEA, Eclipse, atau editor kompatibel Java apa pun.
• Spreadsheet contoh – file .xlsx yang ingin Anda lindungi.

Anda dapat menambahkan SDK ke proyek Anda melalui Maven, Gradle, atau dengan menempatkan file JAR secara manual pada classpath.

Impor Paket

Impor ini memberi Anda akses ke kelas watermark inti, penanganan spreadsheet, dan utilitas font.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.examples.Constants;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.document.IDocumentInfo;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

Cara watermark spreadsheet – Panduan Langkah‑per‑Langkah

Berikut adalah panduan praktis berurutan yang menunjukkan secara tepat cara watermark spreadsheet dengan Java. Setiap langkah mencakup penjelasan singkat diikuti oleh blok kode asli (tidak diubah).

Langkah 1: Siapkan Objek Watermark Anda

Mengapa? Objek ini menentukan tampilan visual stempel yang akan Anda terapkan.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));

Langkah 2: Muat Spreadsheet

Mengapa? Membuka workbook memberikan SDK pegangan untuk diedit.

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("your-file-path.xlsx", loadOptions);

Langkah 3: Akses Konten Spreadsheet dan Lembar Kerja

Mengapa? File Excel dapat berisi banyak lembar; Anda perlu mengiterasi setiap lembar.

SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
    // Process each worksheet
}

Langkah 4: Loop Melalui Lampiran di Setiap Lembar Kerja

Mengapa? Beberapa lembar kerja menyematkan dokumen lain (mis., PDF). Menangani mereka memastikan watermark konsisten di seluruh file.

for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
    IDocumentInfo info = attachment.getDocumentInfo();
    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
        // Process the supported attachment
    }
}

Langkah 5: Watermark Setiap Dokumen Terlampir

Mengapa? Anda menginginkan stempel “Confidential” yang sama pada setiap file tersemat.

Watermarker attachedWatermarker = attachment.createWatermarker();
attachedWatermarker.add(watermark);
attachment.updateContent(attachedWatermarker);
attachedWatermarker.close();

Langkah 6: Simpan Semua Perubahan

Mengapa? Menyimpan perubahan ke workbook baru.

watermarker.save("your-output-file.xlsx");

Langkah 7: Tutup Sumber Daya

Mengapa? Membebaskan sumber daya mencegah kebocoran memori, terutama saat memproses workbook besar.

watermarker.close();

Menggabungkan Semua: Contoh Lengkap

Kelas berikut menggabungkan setiap langkah menjadi satu program yang dapat dijalankan. Jangan ubah blok kode – blok tersebut identik dengan contoh asli.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

public class WatermarkSpreadsheet {
    public static void main(String[] args) {
        try {
            // Step 1: Create watermark
            TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));
            
            // Step 2: Load spreadsheet
            SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
            Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx", loadOptions);
            
            // Step 3: Access content and worksheets
            SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
            for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
                
                // Step 4: Loop attachments
                for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
                    DocumentInfo info = attachment.getDocumentInfo();
                    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
                        
                        // Step 5: Watermark attached documents
                        Watermarker attachedWatermarker = attachment.createWatermarker();
                        attachedWatermarker.add(watermark);
                        attachment.updateContent(attachedWatermarker);
                        attachedWatermarker.close(); // Clean up
                    }
                }
            }
            // Step 6: Save modifications
            watermarker.save("path/to/output/spreadsheet_watermarked.xlsx");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // Step 7: Close resources
            // (Ensure resources are closed)
        }
    }
}

Masalah Umum dan Solusinya

Pertanyaan yang Sering Diajukan

T: Bisakah saya menambahkan watermark gambar alih-alih teks?
J: Ya. Gunakan ImageWatermark dari SDK dan berikan instance java.awt.Image. Ini mencakup skenario add image watermark java.

T: Bagaimana saya mengontrol posisi watermark?
J: Kelas TextWatermark (atau ImageWatermark) menyediakan properti seperti setHorizontalAlignment, setVerticalAlignment, dan setOpacity untuk menyesuaikan penempatan dan transparansi.

T: Apakah memungkinkan untuk memberi watermark pada beberapa file Excel dalam satu kali jalankan?
J: Tentu saja. Bungkus seluruh alur kerja dalam loop for yang mengiterasi direktori file, menggunakan kembali instance TextWatermark yang sama.

T: Apa yang terjadi jika spreadsheet berisi grafik?
J: Grafik diperlakukan sebagai objek gambar terpisah; watermark diterapkan pada kanvas lembar kerja, sehingga grafik tidak terpengaruh tetapi tetap tertutup oleh stempel transparan.

T: Bisakah saya menghapus watermark yang ditambahkan sebelumnya?
J: SDK menyertakan metode watermarker.remove(watermark), tetapi Anda harus menyimpan referensi ke objek watermark asli atau mencari berdasarkan teks/konten untuk mengidentifikasinya.

Terakhir Diperbarui: 2026-03-27
Diuji Dengan: GroupDocs.Watermark 23.12 (Java)
Penulis: GroupDocs