Java kullanarak Excel'e Filigran Ekle

Bir elektronik tabloya filigran eklemek, hassas verileri korumaya yardımcı olur ve belge sahipliğini gösterir. Conholdate.Total for Java birkaç satır kodla Java’da Excel’e Filigran eklemenizi sağlayan basit bir API sunar. Bu kılavuz, gerekli kurulumu, tam uygulamayı ve ana yapılandırma seçeneklerini adım adım göstererek Excel çalışma kitaplarınızı etkili bir şekilde güvence altına almanızı sağlar.

Java’da Excel’e Filigran Ekleme - Adım Adım

ExcelLoadOptions ile Çalışma Kitabını Yükleme

Excel çalışma kitabını yükleyin: Dosyayı açmak için Watermarker‘ı ExcelLoadOptions ile birlikte kullanın.

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

Watermarker sınıfı API referansında belgelenmiştir. ExcelLoadOptions ile yükleme, bellek kullanımını kontrol etmenizi sağlar; bu, büyük çalışma kitapları için çok önemlidir.

Metin Filigranı Oluşturma ve Stil Verme

Metin filigranı oluşturun: Yazı tipi, renk, opaklık, dönüş ve hizalamayı tanımlayın.

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

opacity değerini 0.3 olarak ayarlamak filigranı yarı saydam yapar, 45‑derecelik dönüş ise filigranı sayfa boyunca çapraz konumlandırır. Bu değerleri marka yönergelerine veya uyumluluk gereksinimlerine göre ayarlayabilirsiniz.

Suyazısını Tüm Çalışma Sayfalarına Uygula

Suyazısını çalışma kitabına ekle: add yöntemi, tek bir çağrıda tüm çalışma sayfalarına uygular.

watermarker.add(watermark);

Eğer sayfa bazında kontrol ihtiyacınız varsa, watermarker.getWorksheets() aracılığıyla bireysel çalışma sayfalarını alabilir ve her birine ayrı ayrı add çağrısı yapabilirsiniz.

Su İşaretli Çalışma Kitabını Kaydet

Su işaretli çalışma kitabını kaydedin: Çıktı formatını kontrol etmek ve orijinal meta verileri korumak için ExcelSaveOptions seçin.

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

ExcelSaveOptions nesnesi, orijinal dosya sürümünü tutup tutmayacağınızı veya en son XLSX standardına yükseltip yükseltmeyeceğinizi belirtmenizi sağlar.

Bellek Sızıntılarını Önlemek İçin Kaynakları Serbest Bırakın

Watermarker’ı Kapatın: Özellikle bir toplu işlemde çok sayıda dosya işlenirken, bellek sızıntılarını önlemek için kaynakları serbest bırakın.

watermarker.close();

Watermarker‘ı kapatmak ayrıca bekleyen yazma işlemlerini de temizler, çıktı dosyasının bozulmasını önler.

Bu adımlar, Java’da Excel’e Watermark eklemeyi, görünüm ve performans üzerinde kontrol sağlayarak gösterir.

Tam Kod Örneği: Java’da Excel’e Filigran Ekleme - Tam Java Filigranı

Aşağıdaki kod, çalışma kitabını yüklemeden sonucun kaydedilmesine kadar tüm süreci gösterir.

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();
            }
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.xlsx, output_watermarked.xlsx) gerçek dosya konumlarınıza göre güncellediğinizden emin olun, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğrulayın ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Ortamı Hazır Hale Getirme

Maven Deposu ve Bağımlılığı Ekle

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

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

En son JAR dosyalarını doğrudan indirme sayfasından da indirebilirsiniz. SDK, Java 8 veya daha üst bir sürüm gerektirir ve IntelliJ IDEA veya Eclipse gibi uyumlu bir IDE, hata ayıklamayı kolaylaştırır.

Lisanslandırmayı Yapılandırma (Üretim Kullanımı)

Üretim ortamında watermark kodunu çalıştırmadan önce lisans dosyanızı uygulayın:

import com.groupdocs.watermark.License;

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

Değerlendirme için geçici bir lisans, geçici lisans sayfasında mevcuttur. Uzun vadeli projeler için, doğru planı seçmek amacıyla fiyatlandırma sayfasını inceleyin.

Conholdate.Total for Java’yı Excel Filigranlama İçin Uygun Kılan Özellikler

Kapsamlı XLS/XLSX Desteği

Kütüphane, dönüştürme gerektirmeden hem eski XLS hem de modern XLSX formatlarını işleyerek formülleri, grafikleri ve makroları korur.

Büyük Çalışma Kitapları için Verimli Akış Modu

Binlerce satır içeren çalışma kitaplarıyla çalışırken, loadOptions.setLoadAllWorksheets(false) ayarlayarak akışı etkinleştirin. Bu, bellek tüketimini önemli ölçüde azaltır.

Zengin Filigran Stil Seçenekleri

Yazı tipi ailesi, boyutu, rengi, opaklığı, döndürme açısı ve hizalamayı kontrol edebilirsiniz. Aşağıdaki tablo, en sık ayarlanan özelliklerin özetini sunar:

Özellik	Örnek Değer	Etki
Font	`new Font("Arial", 36)`	Filigran metninin görsel stilini belirler.
Color	`Color.RED`	Filigran rengini ayarlar; herhangi bir RGB değeri kabul edilir.
Opacity	`0.3` (30%)	Şeffaflığı kontrol eder; daha düşük değerler filigranı daha az müdahaleci yapar.
Rotation Angle	`45` degrees	Filigranı daha iyi kapsama için diyagonal olarak konumlandırır.
Horizontal Alignment	`HorizontalAlignment.Center`	Filigranı yatay olarak yerleştirir.
Vertical Alignment	`VerticalAlignment.Center`	Filigranı dikey olarak yerleştirir.

Otomatik Çalışma Sayfası Kapsamı

Tek bir watermarker.add(watermark) çağrısı, filigranı her sayfaya yayar, tekrarlayan döngüler yazmaktan sizi kurtarır.

Basit Kaydetme Seçenekleri

ExcelSaveOptions orijinal dosya formatını korumanıza veya en son XLSX sürümüne yükseltmenize olanak tanır ve ayrıca makroları koruyup korumayacağınızı belirtebilirsiniz.

Bu yeteneklerin tümü resmi belgelerde ayrıntılı olarak açıklanmıştır.

Sonuç

Bu öğreticide Java’da Excel’e Watermark eklemeyi, Conholdate.Total for Java ürününün güçlü özelliklerini kullanarak öğrendiniz. Adım adım rehberi izleyerek, elektronik tablolarınızı özel metinle koruyabilir, görünümü kontrol edebilir ve büyük dosyaları verimli bir şekilde işleyebilirsiniz. Üretim dağıtımları için lisanslı bir sürüme ihtiyacınız olacak; fiyatlandırmayı fiyatlandırma sayfasında inceleyebilir ve SDK’yı değerlendirmek için geçici lisans sayfasından geçici bir lisans alabilirsiniz.

SSS

Metin yerine bir resim filigranı nasıl eklerim?
Metin örneği gibi ImageWatermark sınıfını kullanın, saydamlığını ve hizalamasını ayarlayın ve Watermarker örneğine ekleyin. Görüntü, bir PNG, JPEG, veya BMP olabilir ve ayrıca çalışma sayfasına sığacak şekilde ölçeklendirebilirsiniz. Ayrıntılar için API referansına bakın.
Çalışma kitabını PDF‘ye dönüştürdükten sonra filigran görünecek mi?
Evet. Filigran çalışma kitabına gömülüdür ve daha sonra PDF gibi herhangi bir formata dönüştürdüğünüzde, Conholdate.Total for Java kullanırken görünecektir. Dönüştürme işlemi, filigranlar dahil tüm görsel öğeleri korur.
Bir çalışma sayfası bazında filigranı kontrol edebilir miyim?
SDK, varsayılan olarak filigranı tüm çalışma sayfalarına uygular, ancak watermarker.getWorksheets().get_Item(index) kullanarak tek tek çalışma sayfalarını yükleyebilir ve her birine seçerek add çağırabilirsiniz. Bu, sayfa başına farklı marka gerektiren raporlar için ayrıntılı kontrol sağlar.
Geliştirme ve test için lisansa ihtiyacım var mı?
Değerlendirme için geçici bir lisans geçici lisans sayfasında mevcuttur. Ticari kullanım için, tam lisansı fiyatlandırma sayfasından satın alın. Lisans dosyası, Kurulum bölümünde gösterildiği gibi çalışma zamanında yüklenmelidir.

Java’da Excel’e Filigran Ekleme - Adım Adım#

ExcelLoadOptions ile Çalışma Kitabını Yükleme#

Metin Filigranı Oluşturma ve Stil Verme#

Suyazısını Tüm Çalışma Sayfalarına Uygula#

Su İşaretli Çalışma Kitabını Kaydet#

Bellek Sızıntılarını Önlemek İçin Kaynakları Serbest Bırakın#

Tam Kod Örneği: Java’da Excel’e Filigran Ekleme - Tam Java Filigranı#

Ortamı Hazır Hale Getirme#

Maven Deposu ve Bağımlılığı Ekle#

Lisanslandırmayı Yapılandırma (Üretim Kullanımı)#

Conholdate.Total for Java’yı Excel Filigranlama İçin Uygun Kılan Özellikler#

Kapsamlı XLS/XLSX Desteği#

Büyük Çalışma Kitapları için Verimli Akış Modu#

Zengin Filigran Stil Seçenekleri#

Otomatik Çalışma Sayfası Kapsamı#

Basit Kaydetme Seçenekleri#

Sonuç#

SSS#

Read More#