Come aggiungere un suffisso al nome file in GroupDocs Redaction Java

In questo groupdocs redaction java tutorial imparerai come aggiungere automaticamente un suffisso al nome del file di output durante la redazione dei documenti con GroupDocs.Redaction. L’aggiunta di un suffisso elimina la rinomina manuale, riduce il rischio di perdita di file non redatti e si integra perfettamente nei pipeline CI/CD che si basano su convenzioni di denominazione. La guida ti accompagna nella configurazione di Maven, nel caricamento in streaming dei documenti, nella rimozione delle annotazioni e nella configurazione delle opzioni di salvataggio — il tutto con codice conciso e pronto per la produzione.

Risposte rapide

  • Cosa fa “add suffix to filename”?
    Quando abiliti l’opzione suffisso, l’SDK aggiunge automaticamente una stringa predefinita (per impostazione predefinita “_redacted”) al nome base del file di output prima dell’estensione. Questo rende immediatamente evidente quali file sono stati elaborati, aiuta a prevenire la distribuzione accidentale del contenuto originale e semplifica l’automazione a valle che si basa su pattern di denominazione.
  • Posso caricare un documento dallo stream?
    Sì — GroupDocs.Redaction supporta il caricamento da qualsiasi InputStream, perfetto per archiviazione cloud o elaborazione in‑memoria.
  • È necessaria una licenza per questa funzionalità?
    Una prova gratuita funziona per la redazione di base; una licenza temporanea o completa sblocca tutte le opzioni avanzate, incluso il gestire il suffisso.
  • Quali formati sono supportati?
    La libreria gestisce DOCX, PDF, PPTX, XLSX e molti altri.
  • È necessaria la rasterizzazione per l’output PDF?
    La rasterizzazione è opzionale; abilitala quando devi appiattire il documento per una sicurezza aggiuntiva.

Cosa fa “add suffix to filename”?

Quando abiliti l’opzione suffisso, l’SDK aggiunge automaticamente una stringa predefinita (per impostazione predefinita “_redacted”) al nome base del file di output prima dell’estensione. Questo rende immediatamente evidente quali file sono stati elaborati, aiuta a prevenire la distribuzione accidentale del contenuto originale e semplifica l’automazione a valle che si basa su pattern di denominazione.

Perché usare GroupDocs.Redaction per questo compito?

GroupDocs.Redaction offre un’API Java ad alte prestazioni che combina azioni di redazione con opzioni flessibili di gestione dei file, come l’aggiunta automatica di suffisso, il supporto allo streaming e l’elaborazione batch. Supporta oltre 50 formati di input e output e può elaborare documenti di centinaia di pagine senza caricare l’intero file in memoria, garantendo un uso ridotto della memoria e un’esecuzione rapida.

Prerequisiti

  • Java Development Kit (JDK): Versione 8 o superiore.
  • GroupDocs.Redaction Library: Libreria core per le attività di redazione.
  • IDE: IntelliJ IDEA, Eclipse o qualsiasi editor compatibile con Java.
  • Maven: Per la gestione delle dipendenze.

Prerequisiti di conoscenza

Familiarità con Java I/O e concetti di programmazione orientata agli oggetti renderà più semplice seguire gli esempi.

Configurazione di GroupDocs.Redaction per Java

Configurazione Maven

Includi la seguente configurazione nel tuo file pom.xml per accedere alle librerie GroupDocs tramite 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>

Download diretto

In alternativa, scarica l’ultima versione direttamente da GroupDocs.Redaction per Java releases.

Acquisizione della licenza

  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.

Inizializzazione e configurazione di base

Inizializza il tuo progetto aggiungendo gli import necessari:

import com.groupdocs.redaction.Redactor;

Con questa configurazione, sei pronto a implementare le funzionalità di redazione dei documenti.

Guida all’implementazione

Funzione 1: caricare documento dallo stream

Overview: Learn how to load documents into an InputStream for processing.

InputStream è una classe Java I/O che rappresenta un flusso di byte, consentendo di leggere dati da file, connessioni di rete o altre fonti senza caricare l’intero contenuto in memoria.

Passo 1.1: creare 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();
    }
}
  • Why: Using InputStream allows you to handle documents stored in various locations—cloud buckets, databases, or in‑memory buffers—without first writing them to disk. This approach is essential when you need to load document from stream in micro‑service architectures.

Funzione 2: applicare la redazione di cancellazione delle annotazioni

Overview: Remove annotations from your document using the DeleteAnnotationRedaction.

DeleteAnnotationRedaction è un’operazione di redazione che rimuove tutte le annotazioni — come commenti, evidenziazioni e note — dal documento.

Passo 2.1: applicare 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());
}
  • Why: This step ensures that any sensitive annotations (comments, highlights, or hidden notes) are stripped from the document, enhancing privacy and compliance.

Funzione 3: salvare documento con opzioni

Overview: Learn how to save your processed document with specific options like rasterization and add suffix filename java.

SaveOptions encapsulates settings that control how the redacted document is written, including format, rasterization, and naming conventions.

Passo 3.1: configurare 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());
    }
}
  • Why: Customizing save options allows flexible output formats and naming conventions. Enabling setAddSuffix(true) adds suffix to filename, making it clear that the file has been redacted.

Come aggiungere il suffisso al nome file java quando si salva un documento?

La classe Redactor è il componente centrale che carica un documento e applica le operazioni di redazione. SaveOptions definisce come il documento redatto viene salvato, includendo formato, rasterizzazione e convenzioni di denominazione. Crea un’istanza di Redactor, applica le redazioni necessarie, quindi configura un oggetto SaveOptions con setAddSuffix(true). Chiama redactor.save(outputPath, options). L’SDK aggiunge automaticamente “_redacted” (o il suffisso configurato) al nome del file, così non dovrai mai rinominare manualmente il file.

Panoramica della dipendenza Maven di GroupDocs

Il groupdocs maven dependency porta l’intero Redaction SDK nel tuo progetto con una singola voce <dependency>. Gestisce le dipendenze transitive, mantiene le librerie aggiornate e semplifica l’automazione della build. Dichiarando la dipendenza in pom.xml, eviti la gestione manuale dei JAR e garantisci la compatibilità con le ultime patch di sicurezza.

Perché aggiungere un suffisso è importante

L’aggiunta di un suffisso fornisce una conferma visiva immediata che un file è stato elaborato, elemento critico per tracciabilità, flussi di lavoro automatizzati e conformità normativa. Consente agli script di filtrare i file redatti, previene la distribuzione accidentale del contenuto originale e soddisfa molti standard di settore che richiedono una chiara etichettatura dei documenti sanitizzati.

Applicazioni pratiche

Esplora questi casi d’uso reali:

  1. Legal document redaction: Secure contracts before client sharing.
  2. Medical record handling: Protect patient identifiers while preserving clinical data.
  3. Financial reporting: Keep sensitive numbers confidential during external audits.
  4. CRM integration: Automatically redact customer data before export to third‑party tools.
  5. Collaboration tools: Ensure shared drafts never expose hidden comments or metadata.

Considerazioni sulle prestazioni

Ottimizzazione delle prestazioni

  • Use streaming (load document from stream) to avoid loading whole files into memory.
  • Close Redactor instances promptly to free resources.

Linee guida per l’uso delle risorse

  • Monitor CPU and memory during batch runs.
  • Prefer ByteArrayOutputStream for in‑memory saves when working with modest file sizes.

Best practice per la gestione della memoria Java

  • Reuse Redactor objects when processing multiple files of the same type.
  • Invoke close() in a try‑with‑resources block to prevent leaks.

Problemi comuni e soluzioni

ProblemaCausaSoluzione
Suffisso non visualizzatosetAddSuffix(false) o chiamata mancanteAssicurati che options.setAddSuffix(true) sia impostato prima di save().
OutOfMemoryError su DOCX di grandi dimensioniCaricamento dell’intero file in memoriaPassa al caricamento con InputStream (vedi Funzione 1).
Annotazioni ancora visibiliRedazione non applicata prima del salvataggioChiama redactor.apply(new DeleteAnnotationRedaction()) prima di save().
Rasterizzazione PDF non applicatasetRasterizeToPDF(false) o omessaImposta options.setRasterizeToPDF(true) quando è necessario un PDF appiattito.

Domande frequenti

Q: Posso redigere documenti PDF usando GroupDocs.Redaction?
A: Sì, la libreria supporta PDF, DOCX, PPTX, XLSX e molti altri formati.

Q: Qual è il modo migliore per gestire file di grandi dimensioni con GroupDocs.Redaction?
A: Usa lo streaming (load document from stream) e chiudi le risorse prontamente per mantenere basso l’uso della memoria.

Q: È possibile personalizzare il testo del suffisso?
A: L’API aggiunge automaticamente un suffisso predefinito (es. “_redacted”). Per suffissi personalizzati, rinomina il file di output dopo il salvataggio.

Q: Come posso ottenere una licenza temporanea per GroupDocs.Redaction?
A: Visita la Temporary License page e segui le istruzioni.

Q: Dove posso ottenere supporto se incontro problemi?
A: Unisciti al GroupDocs Support Forum per assistenza da esperti.

Risorse


Last Updated: 2026-11-02
Tested With: GroupDocs.Redaction 24.9 for Java
Author: GroupDocs

Tutorial correlati