Conversão de HTML para XLSX em Java

Converter relatórios em HTML para planilhas Excel é uma necessidade frequente em aplicações web baseadas em Java que precisam permitir que os usuários baixem análises ou faturas. O GroupDocs.Conversion Cloud SDK for Java oferece uma API robusta que cuida da maior parte da transformação de formatos sem exigir instalações locais do Office. Neste guia você verá como configurar o SDK, escrever o código de conversão e também chamar o mesmo serviço através de uma interface REST com cURL. Ao final, você estará pronto para incorporar a conversão de HTML‑para‑XLSX em um servidor, servlet, aplicativo Spring Boot ou qualquer serviço Java multithread.

Exportando Relatórios HTML para XLSX em Java - Requisitos

Muitos portais corporativos geram painéis HTML dinâmicos que os usuários desejam exportar como pastas de trabalho XLSX para análise offline. Os requisitos típicos incluem:

Acesso ao código‑fonte HTML armazenado no armazenamento em nuvem ou gerado sob demanda.
Preservação das estruturas de tabelas, estilos de célula e formatos numéricos durante a conversão.
Capacidade de executar a conversão em um servidor backend, em um contêiner servlet ou dentro de um microsserviço sem instalar o Microsoft Office.

Copiar e colar manualmente ou bibliotecas do lado do cliente não podem garantir formatação consistente, especialmente ao lidar com relatórios grandes ou cenários de alta concorrência, como um servidor de conversão de HTML para XLSX em Java.

Aproveitando o GroupDocs.Conversion Cloud SDK for Java para Atender às Necessidades de Exportação

O SDK oferece um mecanismo de conversão baseado na nuvem que suporta HTML como entrada e XLSX como saída, eliminando a necessidade de componentes locais do Office. As principais funcionalidades que atendem aos requisitos são:

Processamento em nuvem - a conversão pesada é executada nos servidores GroupDocs, ideal para um servlet de conversão de HTML para XLSX em Java ou uma aplicação web Spring Boot.
Opções configuráveis - você pode preservar a formatação original, definir nomes de planilhas e controlar os tipos de dados das células via XlsxConvertOptions.
Cliente thread‑safe - adequado para multithreading de conversão de HTML para XLSX em Java, permitindo trabalhos em lote de alta taxa de transferência.

Para mais detalhes, veja a documentação oficial e a referência da API.

Conversão de HTML para XLSX em Java: Implementação

Instalar GroupDocs.Conversion Cloud SDK

Adicione o SDK ao seu projeto Maven:

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

Ou execute o comando de instalação:

mvn install com.groupdocs:groupdocs-conversion-cloud

Inicializar Cliente API

Crie um ApiClient com suas credenciais e instancie o 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);

Definir informações do arquivo de origem

Especifique o arquivo HTML que está armazenado no armazenamento em nuvem padrão.

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

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

Configurar opções de conversão XLSX

Ajuste opções, como preservar a formatação original.

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

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

Executar Conversão e Recuperar Resultado

Construa a solicitação, execute-a e obtenha o caminho de saída.

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

Convertendo Documentos HTML para XLSX Usando Java - Exemplo de Código Completo

O exemplo abaixo reúne todas as partes em uma única classe executável.

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: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (input.html, output.xlsx) para corresponder às suas localizações reais, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter ajuda.

Executando Exportação XLSX de HTML com REST e cURL

Você pode realizar a mesma conversão sem escrever código Java chamando a API REST diretamente. O fluxo espelha as etapas do SDK: obter um token, enviar o arquivo HTML, solicitar a conversão e baixar o resultado XLSX.

Obter Token de Acesso

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"

Carregar HTML de Origem

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

Solicitação de Conversão

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

Baixar Resultado XLSX

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

Para uma lista completa de parâmetros e exemplos adicionais, veja a documentação oficial da API.

Conclusão

A conversão de HTML para XLSX em Java torna‑se simples quando você aproveita o processamento baseado na nuvem do GroupDocs.Conversion Cloud SDK for Java. O SDK abstrai as complexidades de analisar tabelas HTML, lidar com estilos e gerar um arquivo XLSX compatível com padrões, tornando‑o ideal para aplicações web server‑side, baseadas em servlet ou Spring Boot. Seja construindo um servidor de conversão dedicado, um microsserviço ou um processador em lote multithread, a mesma API escala para atender à carga. Lembre‑se de obter uma licença temporária na página de licença temporária para avaliação e revisar os detalhes de preços para uso em produção. Com o código e os exemplos de cURL neste guia, você agora pode integrar a exportação de HTML para XLSX em qualquer solução Java.

Perguntas frequentes

Como posso realizar a conversão de HTML para XLSX em um servlet Java?
Crie um servlet que receba o arquivo HTML enviado, use o GroupDocs.Conversion Cloud SDK for Java para chamar convertDocument e escreva o fluxo XLSX resultante de volta na resposta HTTP. O cliente thread‑safe do SDK funciona bem dentro de contêineres de servlet.

É possível executar a conversão de HTML para XLSX como um microsserviço em Java?
Sim. Empacote a lógica de conversão em uma aplicação Spring Boot leve, exponha um endpoint REST e deixe o SDK lidar com a transformação real do formato. Essa abordagem se encaixa no padrão de microsserviço de conversão de HTML para XLSX em Java.

Posso converter HTML para XLSX em uma aplicação Java multithread?
O SDK foi projetado para ser thread‑safe, portanto você pode iniciar várias tarefas de conversão em paralelo, o que é útil para um servidor de conversão de HTML para XLSX de alto volume em cenários Java.

Onde posso encontrar mais detalhes sobre licenciamento do GroupDocs.Conversion Cloud SDK for Java?
Visite a página de licença temporária para obter uma chave de avaliação e verifique a página de preços para opções de licença completa. Ambos os links são fornecidos na página principal do produto.

Exportando Relatórios HTML para XLSX em Java - Requisitos#

Aproveitando o GroupDocs.Conversion Cloud SDK for Java para Atender às Necessidades de Exportação#

Conversão de HTML para XLSX em Java: Implementação#

Instalar GroupDocs.Conversion Cloud SDK#

Inicializar Cliente API#

Definir informações do arquivo de origem#

Configurar opções de conversão XLSX#

Executar Conversão e Recuperar Resultado#

Convertendo Documentos HTML para XLSX Usando Java - Exemplo de Código Completo#

Executando Exportação XLSX de HTML com REST e cURL#

Obter Token de Acesso#

Carregar HTML de Origem#

Solicitação de Conversão#

Baixar Resultado XLSX#

Conclusão#

Perguntas frequentes#

Leia Mais#