Conversione da HTML a XLSX in Java

La conversione di report HTML in fogli di calcolo Excel è una necessità frequente per le applicazioni web basate su Java che devono consentire agli utenti di scaricare analisi o fatture. GroupDocs.Conversion Cloud SDK for Java offre un’API robusta che gestisce il lavoro pesante della trasformazione dei formati senza richiedere installazioni locali di Office. In questa guida vedrai come configurare l’SDK, scrivere il codice di conversione e anche chiamare lo stesso servizio tramite un’interfaccia REST con cURL. Alla fine sarai pronto a incorporare la conversione da HTML a XLSX in un server, servlet, app Spring Boot o qualsiasi servizio Java multithread.

Esportazione di report HTML in XLSX in Java - Requisiti

Molti portali aziendali generano dashboard HTML dinamici che gli utenti desiderano esportare come cartelle di lavoro XLSX per l’analisi offline. I requisiti tipici includono:

Accesso al sorgente HTML archiviato nello storage cloud o generato al volo.
Conservazione delle strutture delle tabelle, degli stili delle cell, e dei formati numerici durante la conversione.
Possibilità di eseguire la conversione su un server backend, un contenitore servlet o all’interno di un microservizio senza installare Microsoft Office.

Il copia‑incolla manuale o le librerie lato client non possono garantire una formattazione coerente, soprattutto quando si gestiscono report di grandi dimensioni o scenari ad alta concorrenza, come un server di conversione da HTML a XLSX in Java.

Sfruttare GroupDocs.Conversion Cloud SDK for Java per soddisfare le esigenze di esportazione

L’SDK offre un motore di conversione basato su cloud che supporta HTML come input e XLSX come output, eliminando la necessità di componenti Office locali. Le funzionalità chiave che corrispondono ai requisiti sono:

Elaborazione cloud - la conversione intensiva viene eseguita sui server GroupDocs, ideale per un servlet di conversione da HTML a XLSX in Java o per un’applicazione web Spring Boot.
Opzioni configurabili - è possibile preservare la formattazione originale, impostare i nomi dei fogli di lavoro e controllare i tipi di dati delle celle tramite XlsxConvertOptions.
Client thread‑safe - adatto per la conversione multithread da HTML a XLSX in Java, consentendo lavori batch ad alta velocità.

Per ulteriori dettagli, consulta la documentazione ufficiale e il riferimento API.

Conversione da HTML a XLSX in Java: Implementazione

Installa GroupDocs.Conversion Cloud SDK

Aggiungi l’SDK al tuo progetto Maven:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion-cloud</artifactId>
    <version>23.12</version>
</dependency>

Oppure esegui il comando di installazione:

mvn install com.groupdocs:groupdocs-conversion-cloud

Inizializzare il client API

Crea un ApiClient con le tue credenziali e istanzia 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);

Imposta le informazioni del file di origine

Specifica il file HTML che si trova nell’archiviazione cloud predefinita.

import com.groupdocs.conversion.cloud.model.FileInfo;

FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html");          // path in the cloud storage
sourceFile.setStorageName("DefaultStorage");   // optional

Configura le opzioni di conversione XLSX

Regola le opzioni, ad esempio preservando la formattazione originale.

import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);

Esegui la conversione e recupera il risultato

Crea la richiesta, eseguila e ottieni il percorso di output.

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();
}

Conversione di documenti HTML in XLSX usando Java - Esempio di codice completo

L’esempio seguente mette tutti i componenti insieme in una singola classe eseguibile.

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();
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.html, output.xlsx) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Esecuzione dell’esportazione XLSX da HTML con REST e cURL

È possibile ottenere la stessa conversione senza scrivere codice Java chiamando direttamente l’API REST. Il flusso rispecchia i passaggi dell’SDK: ottenere un token, caricare il file HTML, richiedere la conversione e scaricare il risultato XLSX.

Ottieni token di accesso

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"

Carica HTML di origine

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

Richiesta di conversione

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
           }
         }'

Scarica risultato XLSX

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Per un elenco completo di parametri e esempi aggiuntivi, consulta la documentazione API ufficiale.

Conclusione

La conversione da HTML a XLSX in Java diventa semplice quando si sfrutta l’elaborazione basata sul cloud di GroupDocs.Conversion Cloud SDK for Java. L’SDK astrae le complessità dell’analisi delle tabelle HTML, della gestione degli stili e della generazione di un file XLSX conforme agli standard, rendendolo ideale per applicazioni web lato server, basate su servlet o Spring Boot. Che tu stia costruendo un server di conversione dedicato, un microservizio o un elaboratore batch multithread, la stessa API scala per gestire il carico. Ricorda di ottenere una licenza temporanea dalla pagina di licenza temporanea per la valutazione e di consultare i dettagli dei prezzi per l’uso in produzione. Con il codice e gli esempi cURL in questa guida, ora puoi integrare l’esportazione da HTML a XLSX in qualsiasi soluzione Java.

FAQs

Come posso eseguire la conversione da HTML a XLSX in un servlet Java?
Crea un servlet che riceve il file HTML caricato, utilizza il GroupDocs.Conversion Cloud SDK for Java per chiamare convertDocument e scrive lo stream XLSX risultante nella risposta HTTP. Il client thread‑safe dell’SDK funziona bene all’interno dei contenitori servlet.

È possibile eseguire la conversione da HTML a XLSX come microservizio in Java?
Sì. Impacchetta la logica di conversione in un’applicazione Spring Boot leggera, espone un endpoint REST e lascia che l’SDK gestisca la trasformazione effettiva del formato. Questo approccio si adatta al modello di microservizio di conversione da HTML a XLSX in Java.

Posso convertire HTML in XLSX in un’applicazione Java multithread?
Il SDK è progettato per essere thread‑safe, quindi è possibile avviare più attività di conversione in parallelo, il che è utile per un server di conversione HTML in XLSX ad alto volume in scenari Java.

Dove posso trovare maggiori dettagli sulla licenza per GroupDocs.Conversion Cloud SDK for Java?
Visita la pagina della licenza temporanea per ottenere una chiave di prova e controlla la pagina dei prezzi per le opzioni di licenza completa. Entrambi i collegamenti sono forniti nella pagina principale del prodotto.

Esportazione di report HTML in XLSX in Java - Requisiti#

Sfruttare GroupDocs.Conversion Cloud SDK for Java per soddisfare le esigenze di esportazione#

Conversione da HTML a XLSX in Java: Implementazione#

Installa GroupDocs.Conversion Cloud SDK#

Inizializzare il client API#

Imposta le informazioni del file di origine#

Configura le opzioni di conversione XLSX#

Esegui la conversione e recupera il risultato#

Conversione di documenti HTML in XLSX usando Java - Esempio di codice completo#

Esecuzione dell’esportazione XLSX da HTML con REST e cURL#

Ottieni token di accesso#

Carica HTML di origine#

Richiesta di conversione#

Scarica risultato XLSX#

Conclusione#

FAQs#

Leggi di più#