La génération de contenu web dynamique est une exigence fréquente pour les développeurs Java qui créent des rapports, des corps d’e‑mail ou de la documentation intégrée. Conholdate.Total for Java fournit un SDK robuste qui simplifie la création de fichiers HTML en Java sans manipulation manuelle de chaînes. Dans ce guide, vous apprendrez comment créer des fichiers HTML en Java, configurer la bibliothèque, définir les options de conversion et exécuter un exemple complet qui produit un fichier HTML unique avec des ressources externes. À la fin, vous serez prêt à générer des fichiers HTML en Java pour tout document source pris en charge.
Exemple complet fonctionnel pour générer des fichiers HTML en Java
Cet exemple montre comment convertir un DOCX, un PDF, un PPTX, ou tout document pris en charge en un seul fichier HTML avec des ressources externes.
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.HtmlConvertOptions;
import java.io.File;
public class HtmlConversionDemo {
public static void main(String[] args) {
// Input document (any supported format: .docx, .pdf, .pptx, etc.)
String inputPath = "input.docx";
// Output HTML file
String outputPath = "output.html";
// Folder where images and other resources will be stored
String resourcesFolder = "output_resources";
// Ensure the resources folder exists
File resFolder = new File(resourcesFolder);
if (!resFolder.exists()) {
resFolder.mkdirs();
}
Converter converter = null;
try {
// Initialize the converter with the source document
converter = new Converter(inputPath);
// Configure HTML conversion options
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
// Store images and CSS in a separate folder
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
// Do not embed images directly into HTML (keeps file size lower)
htmlOptions.setEmbedImages(false);
// Convert the whole document (0 means all pages)
htmlOptions.setPageNumber(0);
// Produce a single HTML file (all pages merged)
htmlOptions.setRenderToSinglePage(true);
// Image quality for extracted pictures (0‑100)
htmlOptions.setQuality(90);
// Performance tweaks for large documents
htmlOptions.setMaxPages(0); // 0 = no limit
htmlOptions.setUsePdfRender(true); // use PDF renderer when possible
// Perform the conversion
converter.convert(outputPath, htmlOptions);
System.out.println("HTML file created successfully at: " + outputPath);
} catch (Exception ex) {
System.err.println("Conversion failed: " + ex.getMessage());
ex.printStackTrace();
} finally {
// Release native resources
if (converter != null) {
try {
converter.close();
} catch (Exception ignored) {
}
}
}
}
}
Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.
Comment créer des fichiers HTML en Java fonctionne
Le processus de conversion est piloté par trois composants principaux : le Converter, le HtmlConvertOptions et la logique de gestion des ressources. Ci‑dessous se trouve une analyse étape par étape du code présenté ci‑dessus.
- Initialiser le Convertisseur - La classe
Convertercharge le document source.
converter = new Converter(inputPath);
Cette classe est documentée dans la référence API.
- Configurer les options HTML -
HtmlConvertOptionsvous permet de contrôler l’emplacement où les images et le CSS sont stockés, si les images sont intégrées, et si la sortie doit être une page unique.
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);
- Définir les ajustements de performance - Pour les documents volumineux, vous pouvez ajuster les limites de pages et choisir le moteur de rendu PDF pour une meilleure vitesse.
htmlOptions.setMaxPages(0);
htmlOptions.setUsePdfRender(true);
- Exécuter la conversion - La méthode
convertécrit le fichier HTML et crée le dossier des ressources.
converter.convert(outputPath, htmlOptions);
- Nettoyage - Fermez toujours le
Converterpour libérer les ressources natives.
if (converter != null) {
converter.close();
}
Fusionner des fichiers HTML en Java
Définir htmlOptions.setRenderToSinglePage(true) fusionne toutes les pages du document source en un seul fichier HTML, ce qui est utile lorsque vous devez combiner plusieurs sections en une sortie cohérente.
Générer des fichiers HTML en Java
Si vous préférez des pages séparées, définissez htmlOptions.setRenderToSinglePage(false). Le SDK générera alors un fichier HTML par page source, tout en gérant les images et le CSS dans le dossier de ressources désigné.
Préparer l’environnement
Avant de pouvoir exécuter le code, ajoutez le référentiel Maven Conholdate.Total ainsi que la dépendance à votre fichier pom.xml du projet.
<repositories>
<repository>
<id>conholdate-repo</id>
<name>Conholdate Maven Repository</name>
<url>https://repository.conholdate.com/repo/</url>
</repository>
</repositories>
<dependency>
<groupId>com.conholdate</groupId>
<artifactId>conholdate-total</artifactId>
<version>24.9</version>
<type>pom</type>
</dependency>
Vous pouvez également télécharger les derniers fichiers JAR directement depuis la page de téléchargement. Le SDK nécessite Java 8 ou une version supérieure et fonctionne sur n’importe quelle JVM standard.
Conclusion
Créer des fichiers HTML en Java devient simple avec Conholdate.Total for Java. La bibliothèque gère la détection du format, l’extraction des ressources et la fusion des pages, ce qui vous permet de vous concentrer sur la logique métier plutôt que sur la manipulation de chaînes de bas niveau. N’oubliez pas d’obtenir une licence valide pour une utilisation en production ; une page de licence temporaire est disponible pour l’évaluation, et les informations détaillées sur les tarifs sont accessibles sur la page de tarification. Avec les étapes décrites ci‑dessus, vous êtes prêt à générer des rapports HTML, des e‑mails ou tout contenu web directement depuis vos applications Java.
FAQs
Comment créer des fichiers HTML en Java avec Conholdate.Total ?
Utilisez la classeConverteravecHtmlConvertOptionscomme indiqué dans l’exemple de code complet. Le SDK se charge d’extraire les images, le CSS et de fusionner les pages.Puis-je fusionner des fichiers HTML en Java avec ce SDK ?
Oui. ActivezhtmlOptions.setRenderToSinglePage(true)pour fusionner toutes les pages en une seule sortie HTML.Quels formats source sont pris en charge pour la conversion HTML ?
Le SDK prend en charge DOCX, PDF, PPTX, XLSX, et de nombreux autres formats. Voir la documentation officielle pour la liste complète.Où puis‑je obtenir les détails de licence et de tarification ?
Visitez la page de licence temporaire pour une licence d’essai et la page de tarification pour les options commerciales.
