Jak wstawić znak wodny w Excelu w Javie - krok po kroku

Załaduj skoroszyt przy użyciu ExcelLoadOptions

1. Załaduj skoroszyt Excel: Użyj Watermarker razem z ExcelLoadOptions, aby otworzyć plik.

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

Klasa Watermarker jest udokumentowana w odniesieniu API. Ładowanie przy użyciu ExcelLoadOptions daje kontrolę nad zużyciem pamięci, co jest niezbędne przy dużych skoroszytach.

Utwórz znak wodny tekstowy ze stylizacją

2. Utwórz znak wodny tekstowy: Zdefiniuj czcionkę, kolor, przezroczystość, obrót i wyrównanie.

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

Ustawienie opacity na 0,3 sprawia, że znak wodny jest półprzezroczysty, a obrót o 45 stopni umieszcza go ukośnie na arkuszu. Możesz dostosować te wartości, aby spełniały wytyczne brandingowe lub wymogi zgodności.

Zastosuj znak wodny do wszystkich arkuszy

3. Dodaj znak wodny do skoroszytu: Metoda add stosuje go do każdego arkusza w jednym wywołaniu.

watermarker.add(watermark);

Jeśli potrzebujesz kontroli na poziomie poszczególnych arkuszy, możesz pobrać indywidualne arkusze za pomocą watermarker.getWorksheets() i wywołać add na każdym z nich osobno.

Zapisz skoroszyt z znakiem wodnym

4. Zapisz skoroszyt z znakiem wodnym: Wybierz ExcelSaveOptions, aby kontrolować format wyjściowy i zachować oryginalne metadane.

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

Obiekt ExcelSaveOptions pozwala określić, czy zachować oryginalną wersję pliku, czy zaktualizować do najnowszego standardu XLSX standard.

Zwolnij zasoby, aby uniknąć wycieków pamięci

5. Zamknij Watermarker: Zwolnij zasoby, aby uniknąć wycieków pamięci, szczególnie przy przetwarzaniu wielu plików w partii.

watermarker.close();

Zamknięcie Watermarker również opróżnia wszystkie oczekujące operacje zapisu, zapewniając, że plik wyjściowy nie zostanie uszkodzony.

Te kroki ilustrują, jak wstawić znak wodny w Excelu w Javie, dając jednocześnie kontrolę nad wyglądem i wydajnością.

Pełny przykład kodu: Wstawianie znaku wodnego w Excelu w Javie – Pełny znak wodny w Javie

Poniższy kod demonstruje cały proces, od wczytania skoroszytu po zapisanie wyniku.

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

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input.xlsx, output_watermarked.xlsx), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Przygotowanie środowiska

Dodaj repozytorium Maven i zależność

Dodaj repozytorium Maven Conholdate oraz zależność SDK do swojego pom.xml:

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

Możesz również pobrać najnowsze pliki JAR bezpośrednio ze strona pobierania. SDK wymaga Java 8 lub nowszej, a kompatybilne IDE, takie jak IntelliJ IDEA lub Eclipse, ułatwi debugowanie.

Konfiguracja licencjonowania (użycie produkcyjne)

Przed uruchomieniem kodu znakowania wodnego w środowisku produkcyjnym, zastosuj swój plik licencyjny:

import com.groupdocs.watermark.License;

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

Tymczasowa licencja jest dostępna do oceny na stronie tymczasowej licencji. Dla długoterminowych projektów zapoznaj się ze stroną cenową, aby wybrać odpowiedni plan.

Co sprawia, że Conholdate.Total for Java jest odpowiedni do znakowania w Excelu

Kompleksowe wsparcie XLS/XLSX

Biblioteka obsługuje zarówno starsze formaty XLS jak i nowoczesne formaty XLSX bez konieczności konwersji, zachowując formuły, wykresy i makra.

Efektywny tryb strumieniowania dla dużych skoroszytów

Podczas pracy z skoroszytami zawierającymi tysiące wierszy, włącz strumieniowanie, ustawiając loadOptions.setLoadAllWorksheets(false). To znacząco zmniejsza zużycie pamięci.

Zaawansowane opcje stylizacji znaków wodnych

Możesz kontrolować rodzinę czcionki, rozmiar, kolor, przezroczystość, kąt obrotu i wyrównanie. Poniższa tabela podsumowuje najczęściej modyfikowane właściwości:

Automatyczne pokrycie arkuszy

Jedno wywołanie watermarker.add(watermark) propaguje znak wodny do każdego arkusza, oszczędzając Ci pisania powtarzalnych pętli.

Simple Save Options

ExcelSaveOptions pozwala zachować oryginalny format pliku lub zaktualizować do najnowszej wersji XLSX, a także możesz określić, czy zachować makra.

Wszystkie te możliwości są opisane szczegółowo w oficjalnej dokumentacji.

Podsumowanie

W tym samouczku dowiedziałeś się, jak wstawić znak wodny w Excelu w Javie, korzystając z potężnych funkcji Conholdate.Total for Java. Postępując zgodnie z przewodnikiem krok po kroku, możesz chronić swoje arkusze kalkulacyjne własnym tekstem, kontrolować wygląd i efektywnie obsługiwać duże pliki. Do wdrożeń produkcyjnych potrzebna będzie licencjonowana wersja; zapoznaj się z cennikiem na stronie cennika i uzyskaj tymczasową licencję ze strony tymczasowej licencji aby ocenić SDK.

FAQ

• Jak dodać znak wodny w postaci obrazu zamiast tekstu?
  Użyj klasy ImageWatermark, ustaw jej przezroczystość i wyrównanie, a następnie dodaj ją do instancji Watermarker, tak jak w przykładzie z tekstem. Obraz może być w formacie PNG, JPEG, lub BMP, a także możesz go skalować, aby dopasować do arkusza. Zobacz referencję API po więcej szczegółów.

• Czy znak wodny będzie widoczny po konwersji skoroszytu do PDF?
  Tak. Znak wodny jest osadzony w skoroszycie i pojawi się w każdym formacie, do którego później konwertujesz, takim jak PDF, przy użyciu Conholdate.Total for Java. Proces konwersji zachowuje wszystkie elementy wizualne, w tym znaki wodne.

• Czy mogę kontrolować znak wodny na poziomie poszczególnych arkuszy?
  SDK domyślnie nakłada znak wodny na wszystkie arkusze, ale możesz załadować poszczególne arkusze przy użyciu watermarker.getWorksheets().get_Item(index) i wywołać add na każdym z nich selektywnie. Daje to precyzyjną kontrolę w raportach, które wymagają innego brandingu w zależności od arkusza.

• Czy potrzebuję licencji do rozwoju i testowania?
  Tymczasowa licencja jest dostępna do oceny na stronie tymczasowej licencji. Do użytku komercyjnego należy zakupić pełną licencję poprzez stronę cenową. Plik licencji musi być załadowany w czasie wykonywania, jak pokazano w sekcji Setup.

Czytaj więcej

• Konwertuj Excel na obraz w Javie
• Automatyczne dopasowanie wierszy lub kolumn w Excelu przy użyciu Javy
• Konwertuj obraz na odcienie szarości w Javie