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

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

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

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

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

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

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

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.

Read More

• Java’da Excel’i Görüntüye Dönüştür
• Java kullanarak Excel’de Satırları veya Sütunları Otomatik Sığdır
• Java’da Görüntüyü Gri Tonlamaya Dönüştür