La conversion de feuilles de calcul Excel en JSON est une exigence fréquente lors de la création de pipelines d’échange de données ou de l’alimentation d’API. Conholdate.Total for Java est un SDK puissant qui simplifie cette tâche pour les développeurs Java. Dans ce guide, vous apprendrez comment configurer la bibliothèque, parcourir une implémentation complète et ajuster finement les options de conversion pour répondre aux besoins de votre projet.

Prérequis et configuration pour Conholdate.Total for Java

Avant de commencer, assurez‑vous d’avoir :

  • Java 17 ou version plus récente installé.
  • Maven 3.6+ pour la gestion des dépendances.
  • Un fichier Excel (.xlsx) que vous souhaitez convertir.

Ajoutez le référentiel Maven Conholdate.Total et la dépendance à votre pom.xml :

<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 JAR directement depuis la page de téléchargement. Avec le SDK en place, vous êtes prêt à commencer la conversion d’Excel en JSON en Java.

Conversion d’Excel en JSON avec Java : Guide étape par étape

Étape 1 : Charger le document Excel source

Tout d’abord, spécifiez le chemin du fichier source XLSX et créez une instance Conversion. Le bloc try‑with‑resources garantit que l’objet de conversion est correctement libéré.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

Étape 2 : Configurer les options de conversion JSON

Créez un objet JsonConvertOptions et ajustez les paramètres tels que le pretty‑print, l’inclusion des en‑têtes, les formats personnalisés de date et de nombre, ainsi que la taille du lot. Ces options contrôlent la façon dont la conversion d’Excel en JSON en Java façonne la sortie finale.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

Étape 3 : Exécuter la conversion

Fournissez le nom du fichier JSON cible et appelez la méthode convert. Le SDK gère la transformation en interne.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

Étape 4 : Gérer le résultat et le nettoyage

Après la conversion, affichez un message de confirmation. Toutes les exceptions sont capturées et affichées dans la console.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

Avec ces étapes, la conversion d’Excel en JSON en Java est terminée, et vous pouvez intégrer le JSON généré dans votre API ou votre flux de travail de traitement des données.

Implémentation complète : Conversion Java Excel en JSON

L’exemple suivant montre comment effectuer une conversion d’Excel en JSON en Java en utilisant Conholdate.Total for Java.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

Remarque: 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.

Options de conversion et paramètres

Le SDK propose plusieurs options pour personnaliser la sortie JSON :

  • Pretty Print - Améliore la lisibilité en ajoutant de l’indentation.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Utilise la première ligne de la feuille de calcul comme noms de propriétés.
    setIncludeHeaders(true) (voir la référence API).
  • Custom Date Format - Définit un modèle de date, par ex., "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Contrôle la précision numérique, par ex., "#.##".
    setCustomNumberFormat("#.##").

Modifier ces paramètres vous permet d’aligner le JSON généré sur les attentes des services ou bases de données en aval.

Conclusion

Vous disposez maintenant d’une conversion Excel vers JSON fonctionnelle en implémentation Java alimentée par Conholdate.Total for Java. Le SDK prend en charge les tâches lourdes, tandis que les options configurables vous donnent le contrôle sur le formatage et les performances. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; vous pouvez demander une page de licence temporaire pour évaluer la bibliothèque ou consulter la page de tarification complète pour les conditions commerciales. Bon codage !

FAQ

  • Comment effectuer une conversion Excel en JSON en Java avec Conholdate.Total ?
    Utilisez la classe Conversion avec JsonConvertOptions comme indiqué dans l’exemple de code. Le SDK abstrait la gestion des fichiers et fournit un appel unique convert.

  • Puis-je personnaliser les formats de date et de nombre lors de la conversion d’Excel en JSON en Java ?
    Oui. Les méthodes setCustomDateFormat et setCustomNumberFormat vous permettent de définir des modèles qui correspondent aux attentes de votre système cible.

  • Quelles options de licence sont disponibles pour Conholdate.Total for Java ?
    Vous pouvez obtenir une licence d’évaluation temporaire depuis la page de licence temporaire ou acheter une licence complète via la page de tarification.

  • Le traitement par lots est-il pris en charge pour les gros fichiers Excel ?
    L’option setRowsPerBatch vous permet de traiter les feuilles de calcul par morceaux, ce qui est idéal pour les scénarios de conversion par lots.

Read More