Comment ajouter une bordure avec la rasterisation en Java en utilisant GroupDocs

Dans ce tutoriel, vous découvrirez comment ajouter une bordure à un document tout en appliquant une rasterisation avancée à l’aide de GroupDocs.Redaction pour Java. Que vous protégiez des dossiers juridiques, des dossiers médicaux ou des rapports financiers, l’ajout d’une bordure personnalisée aide à mettre en évidence les zones censurées et à conserver la mise en page visuelle intacte. Nous parcourrons la configuration, le code exact dont vous avez besoin, ainsi que des conseils de performance pour gérer de gros documents.

Réponses rapides

  • Que signifie « add border » dans la rasterisation ? Il dessine un cadre visuel autour de chaque page après que le contenu a été rasterisé, offrant un indice visuel clair pour les zones censurées.
  • Quelle bibliothèque fournit cette fonctionnalité ? GroupDocs.Redaction pour Java fournit une rasterisation intégrée et des options de bordure.
  • Ai-je besoin d’une licence ? Un essai gratuit fonctionne pour l’évaluation ; une licence complète est requise pour une utilisation en production.
  • Puis-je traiter de gros documents efficacement ? Oui – activez la rasterisation, définissez le DPI approprié, et fermez rapidement le Redactor pour libérer la mémoire native.
  • La couleur et la largeur de la bordure sont-elles configurables ? Absolument ; vous pouvez définir n’importe quelle couleur et utiliser set border width java via un HashMap d’options.

Qu’est-ce que la rasterisation et pourquoi voudrais‑je ajouter une bordure ?

La rasterisation convertit chaque page d’un document en une image, ce qui est utile lorsque vous devez masquer complètement le texte ou les graphiques sous‑jacent. L’ajout d’une bordure personnalisée sur l’image rasterisée rend la censure évidente et d’aspect professionnel, surtout dans les secteurs fortement réglementés.

Réponse directe : La rasterisation transforme chaque page PDF en bitmap, et l’option ajouter une bordure dessine un cadre rectangulaire autour de chaque page bitmap, signalant instantanément que la page a été censurée tout en préservant la mise en page originale.

Prérequis

  • GroupDocs.Redaction for Java version 24.9 ou ultérieure.
  • Un Java Development Kit (JDK) installé.
  • Un IDE tel qu’IntelliJ IDEA ou Eclipse.
  • Connaissances de base en Java (classes, méthodes, gestion des exceptions).

Configuration de GroupDocs.Redaction pour Java

Installation Maven

Si vous gérez les dépendances avec Maven, ajoutez le référentiel et la dépendance à votre pom.xml :

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

Téléchargement direct

Vous pouvez également télécharger le JAR directement depuis GroupDocs.Redaction for Java releases.

Acquisition de licence

  • Free Trial : Explorez l’API sans achat.
  • Temporary License : Utilisez une clé à durée limitée pour des tests prolongés.
  • Full License : Requise pour les déploiements en production.

Initialisation et configuration de base

Tout d’abord, importez les classes principales dont vous aurez besoin :

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.AdvancedRasterizationOptions;

Vous êtes maintenant prêt à ajouter la bordure personnalisée.

Guide d’implémentation

Comment ajouter une bordure en utilisant des options de rasterisation personnalisées

Chargement et préparation du document

La classe Redactor est le moteur principal de GroupDocs.Redaction qui charge, modifie et enregistre les documents en mémoire.

// Load the document you want to process.
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");

Cela crée une instance Redactor qui gérera toutes les opérations suivantes.

Définition des options d’enregistrement et ajout d’une bordure

La propriété AdvancedRasterizationOptions.Border indique au moteur de dessiner une bordure autour de chaque page rasterisée.

try {
    // Create SaveOptions and set a suffix for the saved file name.
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");

    // Enable rasterization to apply advanced options.
    so.getRasterization().setEnabled(true);

    // Add custom border settings as an advanced option.
    so.getRasterization().addAdvancedOption(
        AdvancedRasterizationOptions.Border,
        new HashMap<String, String>() {
{
            put("borderColor", "black");
            put("borderWidth", "2");
        }
}
    );
    
    redactor.save(so);
} finally {
    redactor.close();
}

Explication des lignes clés

  • so.getRasterization().setEnabled(true); active la rasterisation pour le document.
  • AdvancedRasterizationOptions.Border indique au moteur de dessiner une bordure autour de chaque page rasterisée.
  • Le HashMap définit le style visuel : une bordure noire de 2 pixels de largeur.
  • Vous pouvez set border width java en modifiant l’entrée borderWidth dans la carte, par ex., borderWidth = 4 pour un cadre plus épais.

Conseils de dépannage

  • Vérifiez que le chemin du fichier est correct ; sinon vous rencontrerez une FileNotFoundException.
  • Assurez‑vous que les coordonnées Maven correspondent à la version que vous avez ajoutée ; des versions incompatibles provoquent une NoClassDefFoundError.

Pourquoi utiliser cette approche pour process large documents java ?

La rasterisation de gros PDF peut être gourmande en mémoire. En activant la bordure comme option avancée, vous laissez le moteur gérer le dessin en un seul passage, ce qui réduit le nombre d’objets temporaires et accélère le traitement. Fermez toujours l’objet Redactor comme indiqué pour libérer rapidement les ressources natives.

Applications pratiques

  1. Legal Documents : Une bordure claire autour des sections censurées signale la conformité aux examinateurs.
  2. Medical Records : Garde les données du patient cachées tout en préservant la mise en page originale pour les audits.
  3. Financial Reports : Met en évidence les sections nécessitant une révision supplémentaire sans modifier les données sous‑jacentes.

Considérations de performance

  • Memory Management : Fermez Redactor dès que vous avez terminé l’enregistrement.
  • Batch Processing : Traitez les documents séquentiellement ou utilisez un pool de threads avec une concurrence limitée pour éviter les erreurs de dépassement de mémoire.
  • Monitoring : Enregistrez le temps de traitement et l’utilisation de la mémoire ; ajustez borderWidth ou le DPI de rasterisation si les performances se dégradent.

Avantages quantifiés

GroupDocs.Redaction prend en charge plus de 60 formats d’entrée et de sortie — y compris PDF, DOCX, XLSX, PPTX, HTML et les types d’images courants — et peut rasteriser des documents de 2000 pages sans charger le fichier complet en mémoire, grâce à son architecture en flux. Cela se traduit par un traitement jusqu’à 40 % plus rapide pour les gros lots comparé à la conversion d’images manuelle.

Conclusion

Vous savez maintenant comment ajouter une bordure à un document en utilisant la rasterisation avancée avec GroupDocs.Redaction pour Java. Cette technique renforce la sécurité des documents, améliore la lisibilité du contenu censuré et s’adapte bien aux charges de travail de gros documents.

Prochaines étapes

  • Intégrez la logique de bordure dans votre pipeline de traitement de documents existant.
  • Expérimentez d’autres AdvancedRasterizationOptions comme les filigranes ou les paramètres DPI personnalisés.
  • Passez en revue l’API GroupDocs.Redaction pour des capacités de censure supplémentaires.

Questions fréquentes

Q : Puis-je utiliser cette fonctionnalité avec des documents non Microsoft Office ?
A : Oui, GroupDocs.Redaction prend en charge les PDF, les images et de nombreux autres formats.

Q : Comment gérer les erreurs lors de la rasterisation ?
A : Enveloppez la logique d’enregistrement dans un bloc try‑catch, vérifiez les versions de la bibliothèque et revérifiez les chemins de fichiers.

Q : Y a-t-il une limite au nombre de documents pouvant être traités simultanément ?
A : Aucun plafond strict, mais le traitement séquentiel ou avec une concurrence contrôlée offre les meilleures performances.

Q : Puis-je personnaliser dynamiquement la couleur et la largeur de la bordure ?
A : Absolument – modifiez les entrées borderColor et borderWidth dans le HashMap avant d’appeler save().

Q : Comment intégrer GroupDocs.Redaction avec d’autres systèmes ?
A : Utilisez son API de style REST ou intégrez la bibliothèque Java dans des micro‑services pour créer un backend de traitement de documents.

Ressources

Dernière mise à jour : 2026-06-06
Testé avec : GroupDocs.Redaction 24.9 for Java
Auteur : GroupDocs

Tutoriels associés