Comment ajouter une bordure avec la rasterisation en Java avec 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, ajouter une bordure personnalisée aide à mettre en évidence les zones masqué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 « ajouter une bordure » en rasterisation ? Elle dessine un cadre visuel autour de chaque page après que le contenu a été rasterisé.
• Quelle bibliothèque fournit cette fonctionnalité ? GroupDocs.Redaction pour Java.
• Ai-je besoin d’une licence ? Un essai gratuit suffit pour l’évaluation ; une licence complète est requise pour la production.
• Puis-je traiter de gros documents efficacement ? Oui – activez la rasterisation et fermez rapidement le Redactor pour libérer la mémoire.
• La couleur de la bordure est‑elle configurable ? Absolument ; vous pouvez définir n’importe quelle couleur et largeur 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 image, ce qui est utile lorsque vous devez masquer complètement le texte ou les graphiques sous‑jacent. Ajouter une bordure personnalisée au-dessus de l’image rasterisée rend la censure évidente et professionnelle, surtout dans les secteurs fortement réglementés.

Prérequis

• GroupDocs.Redaction pour 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 dépôt 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

Sinon, vous pouvez télécharger le JAR directement depuis GroupDocs.Redaction for Java releases.

Acquisition de licence

• Essai gratuit : Explorez l’API sans achat.
• Licence temporaire : Utilisez une clé à durée limitée pour des tests prolongés.
• Licence complète : 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

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

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.

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 ?

Rasteriser de gros PDF peut être gourmand 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. Documents juridiques : Une bordure claire autour des sections censurées indique la conformité aux examinateurs.
2. Dossiers médicaux : Cache les données du patient tout en préservant la mise en page originale pour les audits.
3. Rapports financiers : Met en évidence les sections nécessitant une révision supplémentaire sans modifier les données sous‑jacentes.

Considérations de performance

• Gestion de la mémoire : Fermez Redactor dès que vous avez terminé l’enregistrement.
• Traitement par lots : Traitez les documents séquentiellement ou utilisez un pool de threads avec une concurrence limitée pour éviter les erreurs de mémoire insuffisante.
• Surveillance : 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.

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 réglages DPI personnalisés.
• Consultez 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 ?
R : 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 ?
R : 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 : Existe‑t‑il une limite au nombre de documents pouvant être traités simultanément ?
R : 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 ?
R : Absolument – modifiez les entrées borderColor et borderWidth du HashMap avant d’appeler save().

Q : Comment intégrer GroupDocs.Redaction avec d’autres systèmes ?
R : 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

• GroupDocs.Redaction Documentation
• API Reference
• Download Latest Version
• GitHub Repository
• Free Support Forum
• Temporary License

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