Cara Menyisipkan Watermark di Excel dengan Java - Langkah demi Langkah

Muat Workbook dengan ExcelLoadOptions

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

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

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

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

5. 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:

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.

Baca Selengkapnya

• Konversi Excel ke Gambar di Java
• AutoFit Baris atau Kolom di Excel menggunakan Java
• Konversi Gambar ke Grayscale di Java