Java

Ajouter un filigrane à vos fichiers PDF est essentiel pour protéger la propriété intellectuelle, mettre en avant la marque ou marquer les documents comme confidentiels. Dans ce guide, vous apprendrez comment ajouter un filigrane à un PDF en utilisant GroupDocs.Watermark pour Java, tout en gardant le processus simple et le résultat de haute qualité.

Quick Answers

  • Quel est le but principal d’ajouter un filigrane à un PDF ? Protéger la propriété, afficher la marque ou indiquer la confidentialité.
  • Quelle bibliothèque ce tutoriel utilise-t-il ? GroupDocs.Watermark pour Java.
  • Ai-je besoin d’une licence ? Un essai gratuit suffit pour l’évaluation ; une licence payante est requise pour la production.
  • **Puis-je personnaliser la police, la taille et le placement compatible avec les projetsce qu’un filigrane PDF ? Un filigrane PDF est une superposition visuelle — généralement du texte ou une image — qui apparaît sur chaque page d’un document PDF. Il peut être semi‑transparent, tourné, ou positionné exactement où vous le souhaitez, vous aidant à affirmer la propriété ou à transmettre des informations importantes sans modifier le contenu sous‑jacent.

Pourquoi utiliser GroupDocs.Watermark pour Java ?

  • Intégration facile avec Maven ou Gradle.
  • Contrôle complet sur le style du texte, l’alignement, le redimensionnement et la gestion des marges.
  • Haute performance sur les gros documents grâce à une gestion efficace desforme**, le même code fonctionne sous Windows, Linux et macOS.

Prerequisites

  • Kit de développement Java (JDK) installé.
  • Maven (ou un autre gestionnaire de dépendances) pour gérer les bibliothèques.
  • Un IDE tel qu’Int de base de dans votre projet :

Configuration Maven
Ajoutez la configuration suivante à votre fichier pom.xml :

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Téléchargement direct
Sinon, téléchargez la dernière version depuis GroupDocs.Watermark for Java releases.

License Acquisition

Commencez production à long terme.

Basic Initialization and Setup

Une fois la bibliothèque ajoutée, initialisez votre projet comme suit :

import com.groupdocs.watermark.Watermarker;

public class WatermarkSetup {
    public static void main(String[] args) {
        // Initialize watermarker with input PDF path.
        Watermarker watermarker = new Watermarker("input.pdf");
        
        System.out.println("Watermarker initialized successfully!");
        
        // Close the resource once done
        watermarker.close();
    }
}

Implementation Guide

configuration du filigrane et configurez la taille pour qu’elle s’adapte à vos pages PDF.

Créermark`. Ici, Arial de taille 42 est utilisé à titre d’exemple :
import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.SizingType;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a text watermark with specific font settings.
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 42));
Définir l’alignement horizontal et vertical

Alignez le filigrane à la position souhaitée :

// Set the horizontal alignment of the watermark to the right.
watermark.setHorizontalAlignment(HorizontalAlignment.Right);

// Set the vertical alignment of the watermark to the top.
watermark.setVerticalAlignment(VerticalAlignment.Top);

la taille pour qu’elle s’adapte bien aux dimensions du document :

// Configure the sizing type to scale to parent dimensions.
watermark.setSizingType(SizingType.ScaleToParentDimensions);

// Set the scaling factor for the watermark.
watermark.setScaleFactor(1);

Fonctionnalité : Application du filigrane avec le type de marge de, assurant un placement correct dans le document.

Initialiser les options de chargement et charger le document PDF

Configurez les options de chargement et initialisez votre watermarker :

import com.groupdocs.watermark.options.PdfLoadOptions;
import com.groupdocs.watermark.contents.PdfContent;

// Initialize load options for the PDF document.
PdfLoadOptions loadOptions = new PdfLoadOptions();

Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/in_document_pdf.pdf", loadOptions);
Définir le type de marge de parentes

Ajustez la façon dont les marges affectent le placement du filigrane :

import com.groupdocs.watermark.contents.PdfPageMarginType;

// Get the content of the loaded PDF and set the page margin type to BleedBox.
PdfContent pdfContent = watermarker.getContent(PdfContent.class);
pdfContent.setPageMarginType(PdfPageMarginType.BleedBox);

watermark.setConsiderParentMargins(true);
Ajouter le filigrane et enregistrer le document

Appliquez le filigrane et enregistrez votre document :

// Add the configured watermark to the PDF document.
watermarker.add(watermark);

// Save the watermarked PDF to the specified output directory. Replace 'YOUR_OUTPUT_DIRECTORY' with your path.
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document_pdf.pdf");

// Close the Watermarker resource to release any associated system resources.
watermarker.close();

Troubleshooting Tips

  • Vérifiez que tous les chemins de fichiers sont corrects et accessibles depuis votre application.
  • Assurez‑vous que la police souhaitée (par ex., Arial) est installée sur le système ; sinon, choisissez une police existante.
  • Si vous rencontrez des problèmes de mémoire avec de gros PDF, traitez le document par lots plus petits ou augmentez la taille du tas JVM.

Practical Applications

  1. Protection de documents – Marquez les fichiers confidentiels avec des filigranes « CONFIDENTIAL ».
  2. Branding – Ajoutez le nom de l’entreprise ou le logo à tous les PDF Distinguez les brouillons des versions finales en utilisant des filigranes « DRAFT ».
  3. Documents juridiques – Renforcez l’authenticité des contrats et accords.
  4. Matériel éducatif – Empêchez la distribution non autorisée des PDF de cours.

Performance Considerations

  • Fermez rapidement les instances de Watermarker pour libérer les ressources.
  • Pour les PDF très volumineux, chargez et traitez les pages de façon incrémentielle plutôt que de charger le fichier complet d’un coup.
  • Utilisez des structures de plusieurs filigranes.

Conclusion

Implémenter comment ajouter un filigrane à un PDF avec GroupDocs.Watermark pour Java est simple et guide, vous avez appris à créer, configurer et appliquer des filigranes texte tout en respectant les marges de page et les préférences de style.

pour les logos ou sceaux.

  • Automatisez le filigrannage dans le cadre d’un pipeline de traitement de documents plus vaste.

Frequently Asked Questions

Q : Puis-je utiliser cette bibliothèque pour ajouter un filigrane aux images également ?
A : Oui, GroupDocs.Watermark prend en charge un large éventail de formats y compris : Est‑il possible d’appliquer plusieurs filigranes en une seule fois ?**
A : Absolument. Vous pouvez créer plusieurs objets TextWatermark (ou ImageWatermark) et les ajouter séquentiellement à la même instance de Watermarker.

Q : Comment gérer différentes tailles de page dans un PDF ?
A : GroupDocs.Watermark adapte automatiquement chaque filigrane aux dimensions il code supplémentaire pour les variations de taille.

Q : Et si la police que je veux n’est pas disponible sur le serveur ?
A : Assurez‑vous que le fichier de police est installé sur la machine hôte, ou intégrez une police personnalisée en fournissant le chemin complet vers le fichier .ttf ou .otf lors de la création de l’objet Font.

Q : La bibliothèque fonctionne‑t‑elle avec des PDF protégés par mot de passe ?
A : Oui. Vous pouvez fournir le mot de passe du document via PdfLoadOptions lors de l’initialisation du Watermarker.

Last Updated: 2026-01-31
Tested With: GroupDocs.Watermark 24.11 for Java
Author: GroupDocs