Tutorial de Conversão de XLSX para JPG em Java

Fri, 17 Jul 2026 09:43:13 +0000

XLSX para JPG conversão em Java é uma necessidade comum quando você deseja exibir dados de planilhas como imagens. GroupDocs.Conversion Cloud SDK for Java oferece uma biblioteca simples baseada em REST que permite renderizar planilhas Excel diretamente em arquivos JPG. Este guia orienta você na configuração necessária, mostra um exemplo de código completo, demonstra o processamento assíncrono com cURL e fornece dicas de desempenho para lidar com pastas de trabalho grandes.

Etapas para Conversão de XLSX para JPG em Java

Adicionar Dependência Maven: Inclua o SDK no seu pom.xml para que a biblioteca esteja disponível em tempo de compilação.


    com.groupdocs
    groupdocs-conversion-cloud
    23.12

Inicializar o Cliente de Conversão: Crie uma instância de ConversionApi com suas credenciais de cliente.

import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

ConversionApi conversionApi = new ConversionApi(new ApiClient(config));

Configurar Opções de Conversão: Defina o formato de saída como JPG, escolha uma resolução e habilite o processamento assíncrono, se desejar.

import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;

JpgConvertOptions jpgOptions = new JpgConvertOptions();
jpgOptions.setResolution(300);          // 300 DPI for high quality
jpgOptions.setQuality(90);              // JPEG quality 0‑100
jpgOptions.setAsync(true);              // Enable async conversion

ConvertOptions options = new ConvertOptions();
options.setOutputFormat("JPG");
options.setJpgOptions(jpgOptions);

Execute a Conversão: Crie um ConvertDocumentRequest com o arquivo XLSX de origem e as opções, então chame a API.

import java.io.File;

File sourceFile = new File("sample.xlsx");
ConvertDocumentRequest request = new ConvertDocumentRequest(sourceFile, options);
String jobId = conversionApi.convertDocument(request);
System.out.println("Conversion started, job ID: " + jobId);

Baixar o Resultado: Verifique o status do trabalho até que ele seja concluído, então baixe cada JPG gerado.

import com.groupdocs.conversion.cloud.model.JobStatus;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;

while (true) {
    JobStatusResponse statusResponse = conversionApi.getJobStatus(jobId);
    JobStatus status = statusResponse.getStatus();
    if (status == JobStatus.COMPLETED) break;
    Thread.sleep(2000); // wait 2 seconds before next poll
}
conversionApi.downloadResult(jobId, new File("output/"));
System.out.println("JPG files saved to output folder.");

Para mais detalhes sobre objetos de solicitação, veja a referência da API.

Gerar JPG a partir de XLSX em Java - Exemplo de Código Completo

Este exemplo demonstra uma conversão completa de ponta a ponta que carrega uma pasta de trabalho XLSX, converte cada planilha em um JPG separado e salva as imagens localmente.

package com.example.conversion;

import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;
import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;
import com.groupdocs.conversion.cloud.model.JobStatus;

import java.io.File;

public class XlsxToJpgDemo {
    public static void main(String[] args) throws Exception {
        // 1. Configure client
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        ConversionApi api = new ConversionApi(new ApiClient(config));

// 2. Prepare conversion options
        JpgConvertOptions jpgOpts = new JpgConvertOptions();
        jpgOpts.setResolution(300);
        jpgOpts.setQuality(90);
        jpgOpts.setAsync(true); // async conversion

ConvertOptions convOpts = new ConvertOptions();
        convOpts.setOutputFormat("JPG");
        convOpts.setJpgOptions(jpgOpts);

// 3. Create request
        File source = new File("input/sample.xlsx");
        ConvertDocumentRequest request = new ConvertDocumentRequest(source, convOpts);

// 4. Start conversion
        String jobId = api.convertDocument(request);
        System.out.println("Job started, ID: " + jobId);

// 5. Wait for completion
        while (true) {
            JobStatusResponse statusResp = api.getJobStatus(jobId);
            if (statusResp.getStatus() == JobStatus.COMPLETED) break;
            Thread.sleep(2000);
        }

// 6. Download JPG files
        api.downloadResult(jobId, new File("output/"));
        System.out.println("Conversion finished. JPG files are in the output folder.");
    }
}

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/sample.xlsx, output/) para corresponderem às suas localizações reais, verifique se todas as dependências necessárias estão instaladas corretamente 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 assistência.

Converter Excel para Imagem Usando cURL

Os seguintes comandos cURL ilustram como realizar a mesma conversão de XLSX para JPG usando a API REST. Substitua os valores de espaço reservado pelas suas credenciais reais e pelos nomes dos arquivos.

Obter Token de Acesso

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Carregar o arquivo XLSX

curl -X POST "https://api.groupdocs.cloud/v1.0/storage/file/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.xlsx"

Iniciar Conversão Assíncrona

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "sourceFilePath": "sample.xlsx",
           "outputFormat": "JPG",
           "options": {
               "resolution": 300,
               "quality": 90,
               "async": true
           }
         }'

Verificar o status do trabalho (substitua JOB_ID pelo valor retornado na etapa anterior)

curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/status" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Baixe os arquivos JPG resultantes

curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/result" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.zip

Para obter uma lista completa de parâmetros, consulte a documentação oficial da API.

Installing and Configuring GroupDocs.Conversion Cloud SDK for Java

Adicione o SDK ao seu projeto com Maven e, em seguida, configure as credenciais do cliente.

# Add the dependency (already shown in the Steps section)
mvn install com.groupdocs:groupdocs-conversion-cloud

// Example configuration (same as in the Steps section)
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

Você pode baixar os arquivos JAR mais recentes na página de download.

Opções de Conversão de XLSX para JPG

Várias opções permitem que você ajuste finamente as imagens geradas.

Opção	Descrição	Exemplo
Resolução	DPI da imagem de saída. Valores mais altos melhoram a qualidade, mas aumentam o tamanho do arquivo.	`jpgOpts.setResolution(300);`
Qualidade	JPEG nível de compressão (0‑100).	`jpgOpts.setQuality(90);`
Intervalo de Páginas	Converte apenas planilhas específicas.	`jpgOpts.setPageRange("1-3");`
Assíncrono	Executa a conversão em segundo plano e verifica a conclusão.	`jpgOpts.setAsync(true);`

Cada propriedade faz parte de JpgConvertOptions no SDK. Consulte a referência da API para a lista completa.

Melhorando a Velocidade de Conversão e o Uso de Memória

Stream Worksheets - Processar uma planilha de cada vez habilitando o modo assíncrono; isso impede que todo o livro de trabalho seja carregado na memória.
Adjust Resolution - Usar o DPI mais baixo aceitável para seu caso de uso; 150‑200 DPI costuma ser suficiente para visualizações na web.
Batch Requests - Ao converter muitos arquivos, enviá‑los em lotes paralelos limitados pela CPU e capacidade de rede do seu servidor.
Reuse ApiClient - Criar uma única instância ConversionApi e reutilizá‑la em várias conversões para evitar a sobrecarga de autenticação repetida.

Aplicar estas dicas pode reduzir o tempo de conversão em até 40 % para arquivos Excel grandes.

Conclusão

A conversão de XLSX para JPG em Java torna‑se simples com o GroupDocs.Conversion Cloud SDK for Java. Seguindo os passos acima, você pode renderizar cada planilha como um JPG de alta qualidade, aproveitar o processamento assíncrono para melhor escalabilidade e aplicar otimizações de desempenho para pastas de trabalho grandes. Lembre‑se de obter uma licença adequada para implantações em produção; detalhes de preços estão disponíveis na página do produto, e você pode começar com uma licença temporária para avaliar a biblioteca. Integre essa funcionalidade em suas aplicações para fornecer visualizações rápidas dos dados do Excel sem depender de instalações do Office no cliente.

FAQs

Como faço a conversão de XLSX para JPG em Java usando o GroupDocs?
Use a classe ConversionApi para fazer upload de um arquivo XLSX, definir JpgConvertOptions (resolução, qualidade, async) e chamar convertDocument. O SDK retorna um ID de trabalho que você pode consultar até que os arquivos JPG estejam prontos.

Posso converter grandes pastas de trabalho do Excel sem ficar sem memória?
Sim. Ative a conversão assíncrona e defina uma resolução razoável. O SDK processa as planilhas sequencialmente, mantendo o uso de memória baixo.

A conversão assíncrona é suportada para XLSX para JPG?
O SDK fornece uma flag async em JpgConvertOptions. Quando definida como true, a API retorna um ID de trabalho, permitindo que você verifique o status e baixe os resultados mais tarde.

Preciso de uma licença especial para usar os recursos de conversão em produção?
É necessária uma licença válida do GroupDocs.Conversion Cloud para uso em produção. Você pode começar com uma licença temporária na página de licença temporária antes de adquirir uma assinatura completa.

java xlsx to jpg on Document Processing REST APIs | GroupDocs Cloud