Extraire des images de Word et créer un document éditable avec GroupDocs.Editor Java

Dans les entreprises d’aujourd’hui, en évolution rapide, la capacité d’extraire des images de Word de manière programmatique est un véritable changeur de jeu. Que vous ayez besoin de convertir Word en HTML, générer du HTML à partir de Word, ou modifier un document Word en Java, GroupDocs.Editor for Java vous offre une solution fiable et haute performance pour automatiser ces tâches. Dans ce guide, nous passerons en revue tout ce dont vous avez besoin — de la configuration de l’environnement à l’édition avancée — afin que vous puissiez commencer à créer des solutions qui automatisent la génération de rapports et traitent en lot des documents Word en quelques minutes.

Réponses rapides

  • Quelle est la classe principale pour charger un fichier Word ? Editor
  • Quelle méthode renvoie le balisage HTML pour l’édition ? edit() renvoie un EditableDocument
  • Comment extraire les images d’un document Word ? Utilisez getAllResources() sur le EditableDocument
  • Puis-je enregistrer le contenu modifié sur le disque ? Oui, appelez save() sur le EditableDocument
  • Ai-je besoin d’une licence pour le développement ? Un essai gratuit ou une licence temporaire suffit pour les tests ; une licence complète est requise pour la production

Qu’est‑ce que « extraire des images de Word » ?

Extraire des images de Word consiste à charger un fichier .docx, le convertir en une représentation HTML éditable, puis extraire chaque image, police ou feuille de style intégrée. Cela vous donne un contrôle total sur chaque ressource afin de les stocker séparément, de les re‑héberger sur un CDN ou de les intégrer dans un autre document.

Pourquoi utiliser GroupDocs.Editor pour Java ?

  • Prise en charge complète de Word – éditez, extrayez et convertissez sans Microsoft Office.
  • Conversion HTML transparente – idéale pour les éditeurs web ou les intégrations CMS.
  • Gestion robuste des ressources – récupérez images, polices et CSS en un seul appel.
  • Performance évolutive – idéale pour le traitement par lots et la génération de rapports à grande échelle.
  • API Java pratique – fonctionne naturellement avec Java 8+ et les IDE populaires.

Prérequis

  • Java Development Kit (JDK) 8 ou supérieur.
  • Un IDE tel qu’IntelliJ IDEA ou Eclipse.
  • Connaissances de base en Java et familiarité avec Maven.

Bibliothèques requises

Incluez la bibliothèque GroupDocs.Editor dans votre projet. Utilisez Maven pour l’ajouter en tant que dépendance :

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

Sinon, téléchargez la dernière version directement depuis GroupDocs.Editor pour Java – versions.

Acquisition de licence

Pour utiliser GroupDocs.Editor, vous pouvez commencer avec un essai gratuit, demander une licence temporaire ou acheter une licence complète. La bibliothèque fonctionne immédiatement pour l’évaluation, et passer à une licence de production ne nécessite que la mise à jour du fichier de licence.

Comment créer un document éditable avec GroupDocs.Editor Java

Installation

  1. Ajouter la dépendance – assurez‑vous que le pom.xml contient le fragment Maven ci‑dessus.
  2. Télécharger le JAR – si vous préférez une configuration manuelle, récupérez le dernier JAR depuis le site officiel de GroupDocs.
  3. Configurer la licence – placez votre fichier GroupDocs.Editor.lic dans le dossier resources ou définissez‑la programmaticalement.

Initialisation de base

Une fois l’environnement prêt, vous pouvez instancier la classe Editor avec le chemin vers votre fichier Word :

import com.groupdocs.editor.Editor;

// Initialize Editor with a sample Word document
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

Cette simple ligne vous fournit un éditeur entièrement fonctionnel capable de charger, modifier et enregistrer le document.

Guide étape par étape

Étape 1 : Charger le document en tant qu’EditableDocument

Charger un document en tant qu’EditableDocument est la première étape vers toute modification.

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

// Load the document into an EditableDocument
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");
EditableDocument beforeEdit = editor.edit();
  • Editor – gère les entrées/sorties de fichiers et la détection du format.
  • EditableDocument – représente le document sous forme HTML éditable.

Étape 2 : Modifier le contenu Word (comment modifier Word)

Vous pouvez maintenant manipuler la chaîne HTML, remplacer des espaces réservés ou mettre à jour les styles. Après les modifications, appelez save() pour les enregistrer.

Étape 3 : Extraire les images et autres ressources

GroupDocs.Editor facilite l’extraction de chaque ressource intégrée, ce qui correspond exactement à la façon dont vous extrayez des images de Word.

import com.groupdocs.editor.htmlcss.resources.IHtmlResource;
import java.util.List;

// Extract embedded HTML, images, fonts, and CSS
String allAsHtmlInsideOneString = beforeEdit.getEmbeddedHtml();
List<IHtmlResource> allResources = beforeEdit.getAllResources();

// Accessing specific resources
List<String> stylesheets = beforeEdit.getCssContent();
  • getEmbeddedHtml() – renvoie le balisage HTML complet.
  • getAllResources() – fournit une liste de chaque image, police ou feuille de style intégrée dans le fichier Word original.
  • extraire des images de Word – il suffit d’itérer allResources pour les objets de type ImageResource.

Étape 4 : Ajuster les liens externes dans le balisage HTML

Si votre document contient des liens qui doivent pointer vers un gestionnaire personnalisé (par ex., un CDN), vous pouvez les réécrire à la volée.

String customImagesRequesthandlerUri = "http://example.com/ImagesHandler/id=";
String htmlMarkup = beforeEdit.getContentString(customImagesRequesthandlerUri);
  • getContentString() – injecte le préfixe URI fourni pour toutes les références d’images, vous permettant de contrôler l’emplacement de diffusion des images.

Étape 5 : Enregistrer le document modifié sur le disque

Après toutes les modifications et ajustements de ressources, écrivez le résultat dans un fichier HTML (ou reconvertissez-le en DOCX ultérieurement).

// Save the edited document as an HTML file
beforeEdit.save("YOUR_OUTPUT_DIRECTORY/output.html");
  • save() – persiste le HTML modifié et toutes les ressources liées dans le dossier spécifié.

Étape 6 : Vérifier l’état de libération

Une gestion appropriée des ressources est cruciale, surtout lors du traitement en lot de documents Word.

String res = !beforeEdit.isDisposed() ? "not" : "already";
  • isDisposed() – renvoie true si les ressources natives du document ont été libérées. Libérez toujours les gros documents une fois terminé.

Étape 7 : Créer un EditableDocument à partir de HTML

Vous pouvez également partir d’un fichier HTML existant ou d’un balisage brut, ce qui est pratique pour les scénarios de conversion de Word en HTML.

import com.groupdocs.editor.EditableDocument;

// Create EditableDocument from file and markup
EditableDocument afterEditFromFile = EditableDocument.fromFile("YOUR_OUTPUT_DIRECTORY/output.html");
EditableDocument afterEditFromMarkup = EditableDocument.fromMarkup(htmlMarkup, allResources);
  • fromFile() – charge un fichier HTML qui a été précédemment enregistré par save().
  • fromMarkup() – construit un EditableDocument directement à partir d’une chaîne et de sa liste de ressources.

Comment convertir Word en HTML avec GroupDocs.Editor

La méthode edit() convertit automatiquement le .docx chargé en une représentation HTML. Vous pouvez ensuite utiliser getEmbeddedHtml() ou getContentString() pour récupérer la sortie générer du HTML à partir de Word, qui peut être intégrée dans des pages web, des e‑mails ou stockée pour une utilisation ultérieure.

Traitement par lots de documents Word avec GroupDocs.Editor

Lorsque vous devez gérer des dizaines ou des centaines de modèles, encapsulez les étapes ci‑dessus dans une boucle ou un pipeline CompletableFuture. N’oubliez pas d’appeler dispose() (ou laissez le GC le gérer) après chaque document afin de maintenir une faible consommation de mémoire.

Problèmes courants et solutions

  • Les gros documents provoquent OutOfMemoryError – diffusez les ressources au lieu de tout charger en mémoire ; libérez chaque EditableDocument dès que vous avez fini.
  • Les images n’apparaissent pas après la conversion – assurez‑vous de fournir le bon préfixe URI à getContentString() ou copiez les ressources extraites dans le dossier cible.
  • Licence non reconnue – vérifiez que le fichier GroupDocs.Editor.lic se trouve sur le classpath ou définissez la licence programmaticalement avant de créer le Editor.

Questions fréquemment posées

Q : Puis‑je modifier des PDF avec GroupDocs.Editor Java ?
R : Oui, GroupDocs.Editor prend en charge divers formats, y compris le PDF. Consultez la référence API pour les méthodes spécifiques.

Q : Comment gérer efficacement les gros documents ?
R : Utilisez des techniques de gestion des ressources comme la libération rapide des instances EditableDocument et le traitement parallèle des fichiers avec CompletableFuture de Java.

Q : GroupDocs.Editor est‑il compatible avec tous les IDE Java ?
R : Oui, il fonctionne avec les IDE populaires tels qu’IntelliJ IDEA et Eclipse.

Q : Quelle est la meilleure façon d’extraire des images de Word lors du traitement de nombreux fichiers ?
R : Parcourez EditableDocument.getAllResources() et filtrez les objets de type ImageResource ; stockez‑les dans un dossier dédié ou téléversez‑les sur un CDN au fur et à mesure.

Q : Puis‑je reconvertir le HTML modifié en fichier DOCX ?
R : Absolument. Utilisez EditableDocument.saveAsDocx("path/to/output.docx") après avoir effectué vos modifications.

Conclusion

Vous disposez maintenant d’un guide complet, de bout en bout, sur la façon d’extraire des images de Word, de modifier le contenu Word, de convertir Word en HTML et de générer des documents éditables avec GroupDocs.Editor pour Java. Ces techniques vous permettent de créer des applications puissantes centrées sur les documents et d’automatiser la génération de rapports en toute confiance.

Prochaines étapes

  • Essayez de modifier un modèle avec des espaces réservés dynamiques (par ex., {{CustomerName}}).
  • Explorez l’API pour enregistrer à nouveau en DOCX (EditableDocument.saveAsDocx()).
  • Intégrez le flux de travail dans un service Spring Boot pour la génération de documents à la demande.

Dernière mise à jour : 2026-02-21
Testé avec : GroupDocs.Editor 25.3 for Java
Auteur : GroupDocs