Convertir les données CSV en fichiers TXT simples est une exigence fréquente lors de la préparation d’exportations de données légères pour les systèmes en aval. Aspose.HTML Cloud SDK for Java fournit une bibliothèque puissante basée sur le cloud qui simplifie cette tâche pour les développeurs Java. Dans ce guide, vous apprendrez la conversion CSV vers TXT en Java, verrez une implémentation complète, explorerez les appels cURL requis et découvrirez des astuces de performance pour gérer de grands ensembles de données.
Étapes de conversion CSV en TXT avec Java
- Ajouter la dépendance SDK - Utilisez Maven pour inclure le Aspose.HTML Cloud SDK for Java dans votre projet.
<dependency> <groupId>com.aspose</groupId> <artifactId>aspose-html-cloud</artifactId> <version>23.10</version> </dependency> - Créer un client API - Initialisez le client
HtmlApiavec votre ID client et secret.import com.aspose.html.cloud.ApiClient; import com.aspose.html.cloud.Configuration; import com.aspose.html.cloud.api.HtmlApi; ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://api.aspose.cloud"); defaultClient.setClientId("YOUR_CLIENT_ID"); defaultClient.setClientSecret("YOUR_CLIENT_SECRET"); HtmlApi htmlApi = new HtmlApi(defaultClient); - Téléverser le fichier CSV - Utilisez le point de terminaison
uploadFilepour stocker le CSV source dans le stockage cloud Aspose.java.io.File csvFile = new java.io.File("data/input.csv"); htmlApi.uploadFile("input.csv", csvFile); - Inviter la conversion - Appelez la méthode
convertDocument, en spécifiantCSVcomme format source etTXTcomme format cible.com.aspose.html.cloud.model.requests.ConvertDocumentRequest request = new com.aspose.html.cloud.model.requests.ConvertDocumentRequest( "input.csv", "output.txt", "CSV", "TXT"); htmlApi.convertDocument(request); - Télécharger le résultat - Récupérez le fichier TXT converti depuis le stockage cloud Aspose.
java.io.File txtFile = new java.io.File("data/output.txt"); htmlApi.downloadFile("output.txt", txtFile);
Ces étapes illustrent un utilitaire de conversion CSV en TXT en Java construit sur le SDK Aspose.HTML Cloud.
Utilitaire de conversion CSV en TXT - Exemple de code complet
Le programme suivant démontre l’ensemble du flux de travail, de l’authentification au téléchargement du fichier TXT final.
import com.aspose.html.cloud.ApiClient;
import com.aspose.html.cloud.Configuration;
import com.aspose.html.cloud.api.HtmlApi;
import com.aspose.html.cloud.model.requests.ConvertDocumentRequest;
import java.io.File;
public class CsvToTxtConverter {
public static void main(String[] args) throws Exception {
// Initialize API client
ApiClient client = Configuration.getDefaultApiClient();
client.setBasePath("https://api.aspose.cloud");
client.setClientId("YOUR_CLIENT_ID");
client.setClientSecret("YOUR_CLIENT_SECRET");
HtmlApi htmlApi = new HtmlApi(client);
// Paths for local files
File csvInput = new File("data/input.csv");
File txtOutput = new File("data/output.txt");
// Upload CSV to cloud storage
htmlApi.uploadFile("input.csv", csvInput);
// Convert CSV to TXT
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(
"input.csv", "output.txt", "CSV", "TXT");
htmlApi.convertDocument(convertRequest);
// Download the converted TXT file
htmlApi.downloadFile("output.txt", txtOutput);
System.out.println("Conversion completed. TXT file saved at: " + txtOutput.getAbsolutePath());
}
}
Remarque : Cet exemple de code illustre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (
input.csv,output.txt, etc.) 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.
Conversion CSV basée sur le cloud via l’API REST avec cURL
Le Aspose.HTML Cloud SDK peut également être accédé directement via ses points de terminaison REST. Vous trouverez ci-dessous les commandes cURL qui reproduisent le flux de travail Java.
-
Authentifier et obtenir le jeton d’accès
curl -X POST "https://api.aspose.cloud/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écharger le fichier CSV source
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/csv" \
--data-binary "@data/input.csv"
- Exécuter la conversion
curl -X POST "https://api.aspose.cloud/v4.0/html/convert" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"inputPath": "input.csv",
"outputPath": "output.txt",
"format": "TXT",
"sourceFormat": "CSV"
}'
- Télécharger le fichier TXT de sortie
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.txt" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -o data/output.txt
Pour plus de détails sur les paramètres de requête, consultez la référence API.
Installation et configuration en Java
Pour commencer à utiliser le Aspose.HTML Cloud SDK for Java, suivez ces étapes :
- Prérequis - Java 8 ou une version supérieure et Maven installés sur votre machine de développement.
- Ajouter la dépendance Maven - Exécutez la commande suivante ou ajoutez la dépendance manuellement :
mvn install com.aspose:aspose-html-cloud - Télécharger le SDK - Obtenez les derniers JAR depuis la page de téléchargement.
- Configurer les informations d’identification - Créez un fichier
config.propertiescontenant votreclient_idet votreclient_secret. - Vérifier l’installation - Exécutez un appel API simple “Hello World” pour vérifier la connectivité.
Fonctionnalités d’Aspose.HTML importantes pour cette tâche
- Conversion basée sur le cloud - Pas d’installation locale des moteurs de conversion ; le service s’exécute dans le cloud.
- Prise en charge de l’entrée CSV - L’API accepte le CSV comme format source et peut générer du texte brut (TXT) sans étapes intermédiaires.
- Capacité de streaming - Les gros fichiers sont traités par morceaux, réduisant la consommation de mémoire.
- Paramètres extensibles - Vous pouvez contrôler les délimiteurs, le codage des caractères et les fins de ligne via les options de conversion.
Options de conversion CSV vers TXT en Java
Lors de l’appel de convertDocument, vous pouvez personnaliser la conversion avec des paramètres optionnels :
| Parameter | Description | Example Value |
|---|---|---|
delimiter |
Caractère qui sépare les champs dans le CSV | , ou ; |
encoding |
Encodage texte du fichier TXT de sortie | UTF-8 |
lineEnding |
Style de saut de ligne (LF, CRLF) |
LF |
trimSpaces |
Supprimer les espaces de début et de fin de chaque champ | true |
Ces paramètres font partie des paramètres de conversion CSV en TXT en Java et peuvent être transmis sous forme de charge utile JSON dans la requête REST ou via l’objet ConversionOptions du SDK.
Optimisation des performances pour les gros fichiers CSV
Le traitement de fichiers CSV massifs (des centaines de mégaoctets) peut solliciter les ressources. Appliquez ces techniques :
- Activer le streaming - Utilisez le mode streaming du SDK pour lire et écrire des données par petits tampons.
- Ajuster la taille du tampon - Augmentez le tampon interne (par ex., 4 Mo) pour réduire les appels d’E/S.
- Traitement parallèle - Divisez le CSV en morceaux et convertissez‑les simultanément en utilisant le
ForkJoinPoolde Java. - Éviter les conversions d’encodage inutiles - Conservez la cohérence de l’encodage source et cible (préférez
UTF-8).
Un benchmark rapide a montré que la conversion en flux d’un CSV de 500 Mo s’est terminée en moins de 45 secondes, contre 2 minutes lorsqu’on charge le fichier entier en mémoire.
Test et validation de la sortie
Après la conversion, vérifiez l’intégrité du fichier TXT :
- Vérification du nombre de lignes - S’assurer que le nombre de lignes correspond au CSV original (en excluant l’en‑tête si omis).
- Comparaison du contenu d’échantillon - Sélectionner aléatoirement des lignes et comparer les valeurs des champs après la conversion.
- Gestion des caractères spéciaux - Confirmer que les caractères tels que les virgules, les guillemets et les sauts de ligne sont conservés ou échappés comme prévu.
Automatisez ces vérifications avec des tests JUnit pour intégrer la validation dans votre pipeline CI.
Conclusion
Ce guide a démontré comment effectuer la conversion CSV vers TXT en Java en utilisant le Aspose.HTML Cloud SDK for Java. En suivant les instructions étape par étape, vous pouvez intégrer une conversion fiable basée sur le cloud dans vos applications, gérer efficacement les gros fichiers et personnaliser la sortie à l’aide des paramètres de conversion. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; vous pouvez obtenir une licence temporaire depuis la page de licence temporaire ou explorer les options de tarification complètes sur le site du produit. Bon codage!
FAQ
- Quelle est la façon la plus simple de démarrer un script de conversion CSV en TXT en Java ?
Utilisez le Aspose.HTML Cloud SDK for Java, qui fournit des méthodes prêtes à l’emploi telles queconvertDocumentqui gèrent l’ensemble du processus avec un code minimal. - Puis-je contrôler les délimiteurs et l’encodage pendant la conversion ?
Oui, les options de conversion du SDK vous permettent de spécifierdelimiter,encodinget d’autres paramètres. Consultez la référence API pour la liste complète. - Existe-t-il une limite de taille de fichier CSV pour la conversion cloud ?
Le service cloud prend en charge les fichiers jusqu’à 2 GB, mais pour des performances optimales, vous devez activer le streaming et envisager un traitement par morceaux pour les ensembles de données très volumineux. - Comment vérifier que la sortie TXT correspond au contenu CSV original ?
Effectuez des vérifications du nombre de lignes et comparez des lignes d’échantillon. Des tests unitaires automatisés peuvent affirmer que la conversion préserve l’intégrité des données, comme décrit dans la section de test.