La conversion de pages web en captures d’image est un besoin fréquent lorsque vous créez des tableaux de bord de reporting, des newsletters par e‑mail ou des archives de documents. Aspose.OCR Cloud SDK for Java fournit une bibliothèque puissante basée sur le cloud qui vous permet de rendre programmatique le contenu HTML sous forme d’images JPG de haute qualité. Dans ce guide, vous apprendrez comment convertir du HTML en JPG en Java, en couvrant la conversion d’un seul fichier, le traitement par lots et les meilleures pratiques de performance.

Conversion HTML en JPG avec Java - Prérequis et configuration

Avant de commencer, assurez‑vous d’avoir les éléments suivants :

  • Java 8 ou version supérieure installée.
  • Maven ou Gradle pour la gestion des dépendances.
  • Un compte Aspose Cloud avec APP SID et APP KEY pour les services OCR.
  • Accès réseau aux points de terminaison Aspose OCR Cloud.

Ajoutez le SDK à votre projet en utilisant la dépendance Maven ci‑dessous. Les mêmes coordonnées sont disponibles sur la page de téléchargement.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-ocr-cloud</artifactId>
    <version>25.9.0</version>
</dependency>

Vous devrez également importer les classes requises et configurer vos informations d’identification, comme indiqué dans la première partie du code d’exemple.

Convertir HTML en JPG en Java - Guide étape par étape

Étape 1 : charger le document source et configurer les identifiants

Créez un objet Configuration et définissez votre APP SID et APP KEY. Cela prépare la bibliothèque pour l’authentification.

Configuration config = new Configuration();
config.setAppSid(APP_SID);
config.setAppKey(APP_KEY);

Étape 2 : Initialiser l’API OCR

Instanciez OcrApi avec la configuration. La référence de l’API est disponible dans la référence officielle de l’API.

OcrApi ocrApi = new OcrApi(config);

Étape 3 : Construire la requête de conversion

Créez une ConvertDocumentRequest, joignez le fichier HTML et spécifiez jpg comme format de sortie.

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFile(new File(inputHtmlPath));
request.setOutputFormat("jpg");

Étape 4 : Exécuter la conversion

Appelez convertDocument pour effectuer la conversion. La réponse contient les octets JPG.

ConvertDocumentResponse response = ocrApi.convertDocument(request);

Étape 5 : écrire les octets JPG sur le disque

Enregistrez le tableau d’octets retourné dans un fichier à l’aide d’un FileOutputStream.

try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
    fos.write(response.getFileData());
}

Étape 6 (Optionnel) : Boucle de conversion par lots

Pour le traitement par lots, parcourez tous les fichiers .HTML d’un dossier, répétez les étapes 3‑5 pour chaque fichier et consignez le résultat de la conversion.

for (Path htmlPath : htmlFiles) {
    // Build request, execute conversion, write output (same as above)
    System.out.println("Converted: " + htmlPath + " -> " + outputJpgPath);
}

Convertir HTML en JPG en Java - Exemple de code complet

Le programme suivant démontre la conversion de fichiers uniques ainsi que la conversion par lots à l’aide du Aspose.OCR Cloud SDK for Java.

import com.aspose.ocr.cloud.ApiException;
import com.aspose.ocr.cloud.Configuration;
import com.aspose.ocr.cloud.api.OcrApi;
import com.aspose.ocr.cloud.model.ConvertDocumentRequest;
import com.aspose.ocr.cloud.model.ConvertDocumentResponse;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.file.*;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class HtmlToJpgConverter {

// Replace with your actual Aspose OCR Cloud credentials
    private static final String APP_SID = "YOUR_APP_SID";
    private static final String APP_KEY = "YOUR_APP_KEY";

// Single conversion example
    private static void convertSingleHtml(String inputHtmlPath, String outputJpgPath) throws IOException, ApiException {
        // Prepare SDK configuration
        Configuration config = new Configuration();
        config.setAppSid(APP_SID);
        config.setAppKey(APP_KEY);

// Initialize API instance
        OcrApi ocrApi = new OcrApi(config);

// Build request
        ConvertDocumentRequest request = new ConvertDocumentRequest();
        request.setFile(new File(inputHtmlPath));
        request.setOutputFormat("jpg");

// Execute conversion
        ConvertDocumentResponse response = ocrApi.convertDocument(request);

// Write the resulting JPG bytes to file
        try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
            fos.write(response.getFileData());
        }
    }

// Batch conversion example
    private static void convertBatchHtml(String inputFolder, String outputFolder) throws IOException, ApiException {
        // Prepare SDK configuration
        Configuration config = new Configuration();
        config.setAppSid(APP_SID);
        config.setAppKey(APP_KEY);

// Initialize API instance
        OcrApi ocrApi = new OcrApi(config);

// Ensure output directory exists
        Files.createDirectories(Paths.get(outputFolder));

// Collect all .html files from the input folder
        List<Path> htmlFiles;
        try (Stream<Path> walk = Files.walk(Paths.get(inputFolder))) {
            htmlFiles = walk.filter(Files::isRegularFile)
                    .filter(p -> p.toString().toLowerCase().endsWith(".html"))
                    .collect(Collectors.toList());
        }

// Process each file
        for (Path htmlPath : htmlFiles) {
            String fileNameWithoutExt = com.google.common.io.Files.getNameWithoutExtension(htmlPath.getFileName().toString());
            String outputJpgPath = Paths.get(outputFolder, fileNameWithoutExt + ".jpg").toString();

// Build request
            ConvertDocumentRequest request = new ConvertDocumentRequest();
            request.setFile(htmlPath.toFile());
            request.setOutputFormat("jpg");

// Execute conversion
            ConvertDocumentResponse response = ocrApi.convertDocument(request);

// Write JPG output
            try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
                fos.write(response.getFileData());
            }

System.out.println("Converted: " + htmlPath + " -> " + outputJpgPath);
        }
    }

public static void main(String[] args) {
        try {
            // Example of single file conversion
            convertSingleHtml("sample.html", "sample.jpg");

// Example of batch conversion
            convertBatchHtml("input_html", "output_jpg");
        } catch (IOException | ApiException e) {
            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.

Conversion HTML en JPG via l’API REST avec cURL

Si vous préférez une approche REST pure, la même conversion peut être effectuée avec des commandes cURL. Le flux de travail consiste en l’authentification, le téléchargement du fichier, la demande de conversion et le téléchargement du résultat.

1. Authentifier et obtenir le jeton d’accès

Remplacez YOUR_CLIENT_ID et YOUR_CLIENT_SECRET par vos informations d’identification.

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"

La réponse contient un access_token que vous utiliserez dans les appels suivants.

2. Téléversez le fichier HTML source

En supposant que vous avez enregistré le jeton dans une variable $TOKEN.

curl -X POST "https://api.aspose.cloud/v4.0/ocr/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@sample.html"

Le téléchargement renvoie un fileId qui identifie le document stocké.

3. Exécuter la conversion

Demander la conversion en JPG.

curl -X POST "https://api.aspose.cloud/v4.0/ocr/convert?outputFormat=jpg&fileId=$FILE_ID" \
  -H "Authorization: Bearer $TOKEN"

Le corps de la réponse contient les données binaires JPG.

4. Télécharger le fichier de sortie

Enregistrez le flux binaire dans un fichier local.

curl -X GET "https://api.aspose.cloud/v4.0/ocr/download?fileId=$FILE_ID&format=jpg" \
  -H "Authorization: Bearer $TOKEN" \
  -o sample.jpg

Pour plus de détails sur les paramètres de requête et la gestion des erreurs, consultez la documentation officielle de l’API.

Conclusion

La conversion de HTML en JPG en Java est simple avec le Aspose.OCR Cloud SDK for Java. En suivant les étapes de configuration, en utilisant les exemples de code fournis ou en appelant l’API REST avec cURL, vous pouvez générer rapidement et de manière fiable des aperçus d’images pour tout contenu web. N’oubliez pas d’obtenir une licence appropriée pour les déploiements en production ; les détails de tarification sont disponibles sur la page du produit, et vous pouvez demander une licence temporaire depuis la page de licence temporaire. Commencez à intégrer la conversion HTML‑to‑JPG dès aujourd’hui et améliorez l’expérience visuelle de vos applications.

FAQ

  • Comment convertir du HTML en JPG en Java sans écrire beaucoup de code ?
    Utilisez la ligne unique présentée dans le guide pas à pas : créez un ConvertDocumentRequest, définissez le fichier et outputFormat sur "jpg", puis appelez ocrApi.convertDocument(request). Le SDK gère le rendu et renvoie les octets JPG.

  • Puis-je convertir en lot des fichiers HTML en JPG en Java ?
    Oui. La méthode convertBatchHtml dans l’exemple parcourt un répertoire, crée une requête pour chaque fichier .HTML et écrit chaque sortie JPG. Cette approche s’adapte bien aux grandes collections.

  • Quel code Java convertit HTML en JPG ?
    L’exemple complet de code ci‑dessus montre le code Java exact nécessaire. Il comprend la configuration des informations d’identification, la construction de la requête, l’exécution et l’écriture du fichier.

  • Existe-t-il un moyen de tester la conversion avant d’acheter une licence ?
    Vous pouvez obtenir une licence temporaire depuis la page de licence temporaire pour évaluer la bibliothèque sans frais pendant le développement.

En savoir plus