Jak dodać przyrostek do nazwy pliku w GroupDocs Redaction Java

W tym groupdocs redaction java tutorial dowiesz się, jak automatycznie dodać przyrostek do nazwy pliku wyjściowego podczas redagowania dokumentów za pomocą GroupDocs.Redaction. Dodanie przyrostka eliminuje ręczne zmienianie nazw, zmniejsza ryzyko wycieku niezredagowanych plików i idealnie wpisuje się w potoki CI/CD, które opierają się na konwencjach nazewnictwa. Poradnik prowadzi Cię przez konfigurację Maven, ładowanie dokumentów w trybie strumieniowym, usuwanie adnotacji oraz konfigurowanie opcji zapisu — wszystko w zwięzłym, gotowym do produkcji kodzie.

Szybkie odpowiedzi

  • Co robi „add suffix to filename”?
    Gdy włączysz opcję przyrostka, SDK automatycznie dodaje zdefiniowany wcześniej ciąg (domyślnie „_redacted”) do podstawowej nazwy pliku wyjściowego przed rozszerzeniem. Dzięki temu od razu widać, które pliki zostały przetworzone, pomaga to zapobiec przypadkowemu rozpowszechnianiu oryginalnej treści i upraszcza automatyzację downstream, która opiera się na wzorcach nazewnictwa.
  • Czy mogę wczytać dokument ze strumienia?
    Tak — GroupDocs.Redaction obsługuje ładowanie z dowolnego InputStream, idealne dla przechowywania w chmurze lub przetwarzania w pamięci.
  • Czy potrzebuję licencji na tę funkcję?
    Darmowa wersja próbna działa dla podstawowego redagowania; tymczasowa lub pełna licencja odblokowuje wszystkie zaawansowane opcje, w tym obsługę przyrostka.
  • Jakie formaty są obsługiwane?
    Biblioteka obsługuje DOCX, PDF, PPTX, XLSX i wiele innych.
  • Czy rasteryzacja jest wymagana dla wyjścia PDF?
    Rasteryzacja jest opcjonalna; włącz ją, gdy potrzebujesz spłaszczyć dokument dla dodatkowego bezpieczeństwa.

Co robi „add suffix to filename”?

Gdy włączysz opcję przyrostka, SDK automatycznie dodaje zdefiniowany wcześniej ciąg (domyślnie „_redacted”) do podstawowej nazwy pliku wyjściowego przed rozszerzeniem. Dzięki temu od razu widać, które pliki zostały przetworzone, pomaga to zapobiec przypadkowemu rozpowszechnianiu oryginalnej treści i upraszcza automatyzację downstream, która opiera się na wzorcach nazewnictwa.

Dlaczego używać GroupDocs.Redaction do tego zadania?

GroupDocs.Redaction oferuje wysokowydajny interfejs Java API, który łączy akcje redakcji z elastycznymi opcjami obsługi plików, takimi jak automatyczne dodawanie przyrostka, obsługa strumieniowa i przetwarzanie wsadowe. Obsługuje ponad 50 formatów wejściowych i wyjściowych oraz może przetwarzać dokumenty wielostronicowe bez ładowania całego pliku do pamięci, zapewniając niskie zużycie pamięci i szybkie wykonanie.

Wymagania wstępne

  • Java Development Kit (JDK): Version 8 or higher.
  • GroupDocs.Redaction Library: Core library for redaction tasks.
  • IDE: IntelliJ IDEA, Eclipse, or any Java‑compatible editor.
  • Maven: For dependency management.

Wymagania wiedzy

Znajomość Java I/O oraz podstawowych koncepcji programowania obiektowego ułatwi zrozumienie przykładów.

Konfiguracja GroupDocs.Redaction dla Java

Konfiguracja Maven

Umieść następującą konfigurację w pliku pom.xml, aby uzyskać dostęp do bibliotek GroupDocs za pośrednictwem Maven:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/redaction/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-redaction</artifactId>
      <version>24.9</version>
   </dependency>
</dependencies>

Bezpośrednie pobranie

Alternatywnie, pobierz najnowszą wersję bezpośrednio z GroupDocs.Redaction for Java releases.

Uzyskanie licencji

  1. Free trial: Access basic functionality without restrictions.
  2. Temporary license: Obtain a temporary license to explore advanced features.
  3. Purchase: For long‑term use, consider purchasing a full license.

Podstawowa inicjalizacja i konfiguracja

Zainicjalizuj projekt, dodając niezbędne importy:

import com.groupdocs.redaction.Redactor;

Po tej konfiguracji jesteś gotowy do implementacji funkcji redagowania dokumentów.

Przewodnik implementacji

Funkcja 1: wczytaj dokument ze strumienia

Przegląd: Dowiedz się, jak wczytywać dokumenty do InputStream w celu przetwarzania.

InputStream to klasa Java I/O reprezentująca strumień bajtów, umożliwiająca odczyt danych z plików, połączeń sieciowych lub innych źródeł bez ładowania całej zawartości do pamięci.

Krok 1.1: utwórz inputstream

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}
  • Dlaczego: Użycie InputStream pozwala obsługiwać dokumenty przechowywane w różnych miejscach — chmurowe zasobniki, bazy danych lub buforach w pamięci — bez konieczności najpierw zapisywania ich na dysku. To podejście jest niezbędne, gdy musisz load document from stream w architekturach mikroserwisowych.

Funkcja 2: zastosuj usuwanie adnotacji redakcją

Przegląd: Usuń adnotacje z dokumentu przy użyciu DeleteAnnotationRedaction.

DeleteAnnotationRedaction to operacja redakcji, która usuwa wszystkie adnotacje — takie jak komentarze, podświetlenia i notatki — z dokumentu.

Krok 2.1: zastosuj deleteannotationredaction

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}
  • Dlaczego: Ten krok zapewnia usunięcie wszelkich wrażliwych adnotacji (komentarzy, podświetleń lub ukrytych notatek) z dokumentu, zwiększając prywatność i zgodność.

Funkcja 3: zapisz dokument z opcjami

Przegląd: Dowiedz się, jak zapisać przetworzony dokument z określonymi opcjami, takimi jak rasteryzacja i add suffix filename java.

SaveOptions zawiera ustawienia kontrolujące sposób zapisu zredagowanego dokumentu, w tym format, rasteryzację i konwencje nazewnictwa.

Krok 3.1: skonfiguruj saveoptions

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}
  • Dlaczego: Dostosowanie opcji zapisu umożliwia elastyczne formaty wyjściowe i konwencje nazewnictwa. Włączenie setAddSuffix(true) adds suffix to filename, co jasno wskazuje, że plik został zredagowany.

Jak dodać przyrostek do nazwy pliku w Java przy zapisywaniu dokumentu?

Redactor to podstawowy komponent, który wczytuje dokument i stosuje operacje redakcji. SaveOptions definiuje, jak zapisywany jest zredagowany dokument, w tym format, rasteryzację i konwencje nazewnictwa. Utwórz instancję Redactor, zastosuj wymagane redakcje, a następnie skonfiguruj obiekt SaveOptions z setAddSuffix(true). Wywołaj redactor.save(outputPath, options). SDK automatycznie dodaje „_redacted” (lub skonfigurowany przyrostek) do nazwy pliku, więc nie musisz ręcznie zmieniać nazwy.

Przegląd zależności Maven GroupDocs

groupdocs maven dependency wprowadza cały Redaction SDK do Twojego projektu za pomocą jednego wpisu <dependency>. Obsługuje zależności tranzytywne, utrzymuje biblioteki aktualne i upraszcza automatyzację budowania. Deklarując zależność w pom.xml, unikasz ręcznego zarządzania plikami JAR i zapewniasz kompatybilność z najnowszymi poprawkami bezpieczeństwa.

Dlaczego dodanie przyrostka ma znaczenie

Dodanie przyrostka zapewnia natychmiastowe wizualne potwierdzenie, że plik został przetworzony, co jest kluczowe dla ścieżek audytu, automatycznych przepływów pracy i zgodności regulacyjnej. Umożliwia skryptom filtrowanie zredagowanych plików, zapobiega przypadkowemu rozpowszechnianiu oryginalnej treści i spełnia wiele standardów branżowych wymagających wyraźnego oznaczenia dokumentów oczyszczonych.

Praktyczne zastosowania

  1. Redakcja dokumentów prawnych: Zabezpiecz umowy przed udostępnieniem klientowi.
  2. Obsługa rekordów medycznych: Chronić identyfikatory pacjentów, zachowując jednocześnie dane kliniczne.
  3. Raportowanie finansowe: Utrzymać poufność wrażliwych liczb podczas audytów zewnętrznych.
  4. Integracja CRM: Automatycznie usuwać dane klientów przed eksportem do narzędzi zewnętrznych.
  5. Narzędzia współpracy: Zapewnić, że udostępnione wersje robocze nie ujawniają ukrytych komentarzy ani metadanych.

Rozważania dotyczące wydajności

Optymalizacja wydajności

  • Używaj strumieniowania (load document from stream), aby uniknąć ładowania całych plików do pamięci.
  • Szybko zamykaj instancje Redactor, aby zwolnić zasoby.

Wytyczne dotyczące zużycia zasobów

  • Monitoruj CPU i pamięć podczas uruchamiania wsadowego.
  • Preferuj ByteArrayOutputStream przy zapisie w pamięci, gdy pracujesz z umiarkowanymi rozmiarami plików.

Najlepsze praktyki zarządzania pamięcią w Java

  • Ponownie używaj obiektów Redactor przy przetwarzaniu wielu plików tego samego typu.
  • Wywołuj close() w bloku try‑with‑resources, aby zapobiec wyciekom.

Typowe problemy i rozwiązania

IssueCauseFix
Przyrostek nie pojawia sięsetAddSuffix(false) lub brak wywołaniaUpewnij się, że options.setAddSuffix(true) jest ustawione przed save().
OutOfMemoryError przy dużym DOCXŁadowanie całego pliku do pamięciPrzejdź na ładowanie przy użyciu InputStream (zobacz Funkcję 1).
Adnotacje nadal widoczneRedakcja nie zastosowana przed zapisemWywołaj redactor.apply(new DeleteAnnotationRedaction()) przed save().
Rasteryzacja PDF nie zastosowanasetRasterizeToPDF(false) lub pominięteUstaw options.setRasterizeToPDF(true), gdy potrzebny jest spłaszczony PDF.

Najczęściej zadawane pytania

P: Czy mogę redagować dokumenty PDF przy użyciu GroupDocs.Redaction?
O: Tak, biblioteka obsługuje PDF, DOCX, PPTX, XLSX i wiele innych formatów.

P: Jaki jest najlepszy sposób obsługi dużych plików przy użyciu GroupDocs.Redaction?
O: Używaj strumieniowania (load document from stream) i szybko zamykaj zasoby, aby utrzymać niskie zużycie pamięci.

P: Czy można dostosować tekst przyrostka?
O: API automatycznie dodaje domyślny przyrostek (np. „_redacted”). Aby użyć własnego przyrostka, zmień nazwę pliku wyjściowego po zapisaniu.

P: Jak uzyskać tymczasową licencję dla GroupDocs.Redaction?
O: Odwiedź Temporary License page i postępuj zgodnie z instrukcjami.

P: Gdzie mogę uzyskać pomoc w razie problemów?
O: Dołącz do GroupDocs Support Forum, aby uzyskać pomoc ekspertów.

Zasoby


Ostatnia aktualizacja: 2026-11-02
Testowano z: GroupDocs.Redaction 24.9 for Java
Autor: GroupDocs

Powiązane samouczki