La conversion des rapports HTML en feuilles de calcul Excel est une exigence fréquente pour les applications web basées sur Java qui doivent permettre aux utilisateurs de télécharger des analyses ou des factures. GroupDocs.Conversion Cloud SDK for Java fournit une API robuste qui gère le travail lourd de la transformation de formats sans nécessiter d’installations locales d’Office. Dans ce guide, vous verrez comment configurer le SDK, écrire le code de conversion, et également appeler le même service via une interface REST avec cURL. À la fin, vous serez prêt à intégrer la conversion HTML‑vers‑XLSX dans un serveur, un servlet, une application Spring Boot ou tout service Java multithread.
Exportation de rapports HTML vers XLSX en Java - Exigences
De nombreux portails d’entreprise génèrent des tableaux de bord HTML dynamiques que les utilisateurs souhaitent exporter sous forme de classeurs XLSX pour une analyse hors ligne. Les exigences typiques incluent :
- Accès au code source HTML stocké dans le stockage cloud ou généré à la volée.
- Conservation des structures de tableau, des styles de cell et des formats numériques lors de la conversion.
- Possibilité d’exécuter la conversion sur un serveur backend, un conteneur de servlets ou à l’intérieur d’un microservice sans installer Microsoft Office.
La copie‑collage manuelle ou les bibliothèques côté client ne peuvent pas garantir un formatage cohérent, surtout lorsqu’il s’agit de gros rapports ou de scénarios à forte concurrence, comme un serveur de conversion HTML vers XLSX en Java.
Exploiter GroupDocs.Conversion Cloud SDK for Java pour répondre aux besoins d’exportation
Le SDK propose un moteur de conversion basé sur le cloud qui prend en charge HTML en entrée et XLSX en sortie, éliminant ainsi le besoin de composants Office locaux. Les principales fonctionnalités qui correspondent aux exigences sont :
- Traitement dans le cloud - la conversion lourde s’exécute sur les serveurs GroupDocs, idéale pour un servlet de conversion HTML vers XLSX en Java ou une application web Spring Boot.
- Options configurables - vous pouvez préserver le formatage d’origine, définir les noms des feuilles de calcul et contrôler les types de données des cellules via
XlsxConvertOptions. - Client thread‑safe - adapté à la conversion multithread HTML vers XLSX en Java, permettant des travaux par lots à haut débit.
Pour plus de détails, consultez la documentation officielle et la référence API.
Conversion HTML vers XLSX en Java : Implémentation
Installer GroupDocs.Conversion Cloud SDK
Ajoutez le SDK à votre projet Maven :
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion-cloud</artifactId>
<version>23.12</version>
</dependency>
Ou exécutez la commande d’installation :
mvn install com.groupdocs:groupdocs-conversion-cloud
Initialiser le client API
Créez un ApiClient avec vos informations d’identification et instanciez ConversionApi.
import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;
ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(apiClient);
Définir les informations du fichier source
Spécifiez le fichier HTML qui se trouve dans le stockage cloud par défaut.
import com.groupdocs.conversion.cloud.model.FileInfo;
FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html"); // path in the cloud storage
sourceFile.setStorageName("DefaultStorage"); // optional
Configurer les options de conversion XLSX
Ajustez les options, comme la conservation du formatage d’origine.
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;
XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);
Effectuer la conversion et récupérer le résultat
Construisez la requête, exécutez‑la et obtenez le chemin de sortie.
import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;
ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFileInfo(sourceFile);
request.setFormat("xlsx"); // target format
request.setConvertOptions(xlsxOptions);
request.setOutputPath("output.xlsx"); // desired output path
try {
ConvertDocumentResponse response = conversionApi.convertDocument(request);
System.out.println("Conversion successful. Output file: " + response.getPath());
} catch (Exception e) {
System.err.println("Error during conversion: " + e.getMessage());
e.printStackTrace();
}
Transformation de documents HTML en XLSX avec Java - Exemple de code complet
L’exemple ci-dessous rassemble toutes les pièces dans une classe exécutable unique.
import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;
import com.groupdocs.conversion.cloud.model.FileInfo;
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;
public class HtmlToXlsxConversionExample {
public static void main(String[] args) {
// Initialize API client (replace with your actual credentials)
ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(apiClient);
// Define source HTML file information
FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html"); // path in the cloud storage
sourceFile.setStorageName("DefaultStorage"); // optional, use default if omitted
// Set conversion options specific to XLSX output
XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
// Example option: preserve original formatting (if needed)
xlsxOptions.setPreserveOriginalFormatting(true);
// Build conversion request
ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFileInfo(sourceFile);
request.setFormat("xlsx"); // target format
request.setConvertOptions(xlsxOptions);
request.setOutputPath("output.xlsx"); // desired output path in cloud storage
try {
// Perform conversion
ConvertDocumentResponse response = conversionApi.convertDocument(request);
System.out.println("Conversion successful. Output file: " + response.getPath());
} catch (Exception e) {
System.err.println("Error during conversion: " + e.getMessage());
e.printStackTrace();
}
}
}
Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (
input.html,output.xlsx) pour qu’ils correspondent à vos emplacements réels, 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.
Exécution de l’export XLSX depuis HTML avec REST et cURL
Vous pouvez réaliser la même conversion sans écrire de code Java en appelant directement l’API REST. Le flux reflète les étapes du SDK : obtenir un jeton, télécharger le fichier HTML, demander la conversion et télécharger le résultat XLSX.
Obtenir le jeton d’accès
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
Téléverser le HTML source
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.html" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/html" \
--data-binary @input.html
Demande de conversion
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fileInfo": {
"filePath": "input.html",
"storageName": "DefaultStorage"
},
"outputPath": "output.xlsx",
"format": "xlsx",
"convertOptions": {
"preserveOriginalFormatting": true
}
}'
Télécharger le résultat XLSX
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
Pour une liste complète des paramètres et des exemples supplémentaires, consultez la documentation officielle de l’API.
Conclusion
HTML to XLSX conversion in Java becomes straightforward when you leverage the cloud‑based processing of GroupDocs.Conversion Cloud SDK for Java. The SDK abstracts away the complexities of parsing HTML tables, handling styles, and generating a standards‑compliant XLSX file, making it ideal for server‑side, servlet‑based, or Spring Boot web applications. Whether you are building a dedicated conversion server, a microservice, or a multithreaded batch processor, the same API scales to meet the load. Remember to obtain a temporary license from the temporary license page for evaluation and review the pricing details for production use. With the code and cURL examples in this guide, you can now integrate HTML to XLSX export into any Java solution.
FAQs
Comment puis‑je effectuer une conversion HTML vers XLSX dans un servlet Java ?
Créez un servlet qui reçoit le fichier HTML téléchargé, utilise le GroupDocs.Conversion Cloud SDK for Java pour appeler convertDocument, et écrit le flux XLSX résultant dans la réponse HTTP. Le client thread‑safe du SDK fonctionne bien dans les conteneurs de servlets.
Est-il possible d’exécuter la conversion HTML vers XLSX en tant que microservice en Java ?
Oui. Emballez la logique de conversion dans une application Spring Boot légère, exposez un point de terminaison REST et laissez le SDK gérer la transformation réelle du format. Cette approche correspond au modèle de microservice de conversion HTML vers XLSX en Java.
Puis-je convertir du HTML en XLSX dans une application Java multithread ?
Le SDK est conçu pour être thread‑safe, vous pouvez donc lancer plusieurs tâches de conversion en parallèle, ce qui est utile pour un serveur de conversion HTML vers XLSX à haut volume dans les scénarios Java.
Où puis‑je trouver plus de détails sur la licence pour GroupDocs.Conversion Cloud SDK for Java ?
Visitez la page de licence temporaire pour obtenir une clé d’essai et consultez la page de tarification pour les options de licence complète. Les deux liens sont fournis sur la page principale du produit.