Menyisipkan Watermark di Excel menggunakan Java

Menyematkan watermark pada spreadsheet membantu melindungi data sensitif dan menandakan kepemilikan dokumen. Conholdate.Total for Java menyediakan API yang sederhana yang memungkinkan Anda menyisipkan Watermark di Excel dengan Java hanya dengan beberapa baris kode. Panduan ini memandu Anda melalui pengaturan yang diperlukan, implementasi lengkap, dan opsi konfigurasi utama sehingga Anda dapat mengamankan workbook Excel Anda secara efisien.

Cara Menyisipkan Watermark di Excel dengan Java - Langkah demi Langkah

Muat Workbook dengan ExcelLoadOptions

Muat workbook Excel: Gunakan Watermarker bersama dengan ExcelLoadOptions untuk membuka file.

Watermarker watermarker = new Watermarker(inputPath, new ExcelLoadOptions());

Kelas Watermarker didokumentasikan dalam referensi API. Memuat dengan ExcelLoadOptions memberi Anda kontrol atas penggunaan memori, yang penting untuk workbook besar.

Buat Watermark Teks dengan Gaya

Buat watermark teks: Tentukan font, warna, opasitas, rotasi, dan perataan.

Font font = new Font("Arial", 36);
TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
watermark.setColor(Color.RED);
watermark.setOpacity(0.3);
watermark.setRotationAngle(45);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);

Mengatur opacity menjadi 0.3 membuat watermark menjadi semi‑transparan, sementara rotasi 45‑derajat menempatkannya secara diagonal melintasi lembar. Anda dapat menyesuaikan nilai-nilai ini untuk memenuhi pedoman merek atau persyaratan kepatuhan.

Terapkan Watermark ke Semua Worksheet

Tambahkan watermark ke workbook: Metode add menerapkannya ke setiap worksheet dalam satu panggilan.

watermarker.add(watermark);

Jika Anda memerlukan kontrol per‑worksheet, Anda dapat mengambil worksheet individu melalui watermarker.getWorksheets() dan memanggil add pada masing‑masing secara terpisah.

Simpan Workbook yang Diberi Watermark

Simpan workbook yang diberi watermark: Pilih ExcelSaveOptions untuk mengontrol format output dan mempertahankan metadata asli.

watermarker.save(outputPath, new ExcelSaveOptions());

Objek ExcelSaveOptions memungkinkan Anda menentukan apakah akan mempertahankan versi file asli atau meningkatkan ke standar XLSX terbaru.

Lepaskan Sumber Daya untuk Menghindari Kebocoran Memori

Tutup Watermarker: Lepaskan sumber daya untuk menghindari kebocoran memori, terutama saat memproses banyak file dalam satu batch.

watermarker.close();

Menutup Watermarker juga memaksa semua operasi penulisan yang tertunda, memastikan file output tidak rusak.

Langkah-langkah ini menggambarkan cara menyisipkan Watermark di Excel menggunakan Java sambil memberi Anda kontrol atas tampilan dan kinerja.

Contoh Kode Lengkap: Menyisipkan Watermark di Excel dengan Java - Watermark Java Lengkap

Kode berikut menunjukkan seluruh proses mulai dari memuat workbook hingga menyimpan hasil.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.TextWatermark;
import com.groupdocs.watermark.common.Font;
import com.groupdocs.watermark.common.Color;
import com.groupdocs.watermark.contents.HorizontalAlignment;
import com.groupdocs.watermark.contents.VerticalAlignment;
import com.groupdocs.watermark.options.load.ExcelLoadOptions;
import com.groupdocs.watermark.options.save.ExcelSaveOptions;

public class ExcelWatermarkExample {
    public static void main(String[] args) {
        String inputPath = "input.xlsx";
        String outputPath = "output_watermarked.xlsx";

Watermarker watermarker = null;
        try {
            // Load the Excel workbook (works for both XLS and XLSX)
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            // For very large workbooks you can enable streaming mode:
            // loadOptions.setLoadAllWorksheets(false);
            watermarker = new Watermarker(inputPath, loadOptions);

// Create a text watermark with desired appearance
            Font font = new Font("Arial", 36);
            TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
            watermark.setColor(Color.RED);
            watermark.setOpacity(0.3);               // 30% opacity
            watermark.setRotationAngle(45);          // diagonal
            watermark.setHorizontalAlignment(HorizontalAlignment.Center);
            watermark.setVerticalAlignment(VerticalAlignment.Center);

// Apply the watermark to all worksheets
            watermarker.add(watermark);

// Save the watermarked workbook
            ExcelSaveOptions saveOptions = new ExcelSaveOptions();
            watermarker.save(outputPath, saveOptions);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (watermarker != null) {
                watermarker.close();
            }
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.xlsx, output_watermarked.xlsx) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menyiapkan Lingkungan

Tambahkan Repository Maven dan Dependensi

Tambahkan repository Maven Conholdate dan dependensi SDK ke pom.xml Anda:

<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>

Anda juga dapat mengunduh JAR terbaru langsung dari halaman unduhan. SDK memerlukan Java 8 atau yang lebih tinggi, dan IDE yang kompatibel seperti IntelliJ IDEA atau Eclipse akan mempermudah proses debugging.

Konfigurasi Lisensi (Penggunaan Produksi)

Sebelum menjalankan kode watermark di lingkungan produksi, terapkan file lisensi Anda:

import com.groupdocs.watermark.License;

License license = new License();
license.setLicense("path/to/Conholdate.Total.Java.lic");

Lisensi sementara tersedia untuk evaluasi di halaman lisensi sementara. Untuk proyek jangka panjang, tinjau halaman harga untuk memilih paket yang tepat.

Apa yang Membuat Conholdate.Total for Java Cocok untuk Penandaan Air Excel

Dukungan XLS/XLSX yang Komprehensif

Perpustakaan ini menangani baik format XLS lama maupun format XLSX modern tanpa memerlukan konversi, serta mempertahankan rumus, diagram, dan makro.

Mode Streaming Efisien untuk Buku Kerja Besar

Saat bekerja dengan buku kerja yang berisi ribuan baris, aktifkan streaming dengan mengatur loadOptions.setLoadAllWorksheets(false). Ini secara dramatis mengurangi konsumsi memori.

Opsi Penataan Watermark yang Kaya

Anda dapat mengontrol keluarga font, ukuran, warna, opasitas, sudut rotasi, dan perataan. Tabel di bawah merangkum properti yang paling sering disesuaikan:

Properti	Contoh Nilai	Dampak
Font	`new Font("Arial", 36)`	Menentukan gaya visual teks watermark.
Color	`Color.RED`	Mengatur warna watermark; nilai RGB apa pun dapat diterima.
Opacity	`0.3` (30%)	Mengontrol transparansi; nilai yang lebih rendah membuat watermark kurang mengganggu.
Rotation Angle	`45` degrees	Menempatkan watermark secara diagonal untuk cakupan yang lebih baik.
Horizontal Alignment	`HorizontalAlignment.Center`	Menempatkan watermark secara horizontal.
Vertical Alignment	`VerticalAlignment.Center`	Menempatkan watermark secara vertikal.

Cakupan Lembar Kerja Otomatis

Satu panggilan tunggal ke watermarker.add(watermark) menyebarkan watermark ke setiap lembar, menghemat Anda dari menulis loop berulang.

Simple Save Options

ExcelSaveOptions memungkinkan Anda mempertahankan format file asli atau meningkatkan ke versi XLSX terbaru, dan Anda juga dapat menentukan apakah akan mempertahankan makro.

Semua kemampuan ini dijelaskan secara detail dalam dokumentasi resmi.

Kesimpulan

Dalam tutorial ini Anda belajar cara menyisipkan Watermark di Excel dengan Java menggunakan fitur kuat Conholdate.Total for Java. Dengan mengikuti panduan langkah‑by‑step, Anda dapat melindungi spreadsheet Anda dengan teks khusus, mengontrol tampilan, dan menangani file besar secara efisien. Untuk penerapan produksi Anda memerlukan versi berlisensi; jelajahi harga di halaman harga dan dapatkan lisensi sementara dari halaman lisensi sementara untuk mengevaluasi SDK.

FAQs

Bagaimana cara menambahkan watermark gambar alih-alih teks?
Gunakan kelas ImageWatermark, atur opacity dan alignment-nya, dan tambahkan ke instance Watermarker seperti contoh teks. Gambar dapat berupa PNG, JPEG, atau BMP, dan Anda juga dapat menskalakan agar sesuai dengan lembar kerja. Lihat API reference untuk detail.
Apakah watermark akan terlihat setelah mengonversi workbook ke PDF?
Ya. Watermark disematkan dalam workbook dan akan muncul dalam format apa pun yang Anda konversi nanti, seperti PDF, saat menggunakan Conholdate.Total for Java. Proses konversi mempertahankan semua elemen visual, termasuk watermark.
Bisakah saya mengontrol watermark per lembar kerja?
SDK secara default menerapkan watermark ke semua lembar kerja, tetapi Anda dapat memuat lembar kerja individual menggunakan watermarker.getWorksheets().get_Item(index) dan memanggil add pada masing‑masing secara selektif. Ini memberi Anda kontrol yang sangat detail untuk laporan yang memerlukan branding berbeda per lembar.
Apakah saya memerlukan lisensi untuk pengembangan dan pengujian?
Lisensi sementara tersedia untuk evaluasi di halaman lisensi sementara. Untuk penggunaan komersial, beli lisensi penuh melalui halaman harga. File lisensi harus dimuat pada runtime seperti yang ditunjukkan di bagian Setup.

Cara Menyisipkan Watermark di Excel dengan Java - Langkah demi Langkah#

Muat Workbook dengan ExcelLoadOptions#

Buat Watermark Teks dengan Gaya#

Terapkan Watermark ke Semua Worksheet#

Simpan Workbook yang Diberi Watermark#

Lepaskan Sumber Daya untuk Menghindari Kebocoran Memori#

Contoh Kode Lengkap: Menyisipkan Watermark di Excel dengan Java - Watermark Java Lengkap#

Menyiapkan Lingkungan#

Tambahkan Repository Maven dan Dependensi#

Konfigurasi Lisensi (Penggunaan Produksi)#

Apa yang Membuat Conholdate.Total for Java Cocok untuk Penandaan Air Excel#

Dukungan XLS/XLSX yang Komprehensif#

Mode Streaming Efisien untuk Buku Kerja Besar#

Opsi Penataan Watermark yang Kaya#

Cakupan Lembar Kerja Otomatis#

Simple Save Options#

Kesimpulan#

FAQs#

Baca Selengkapnya#