Converter planilhas Excel para JSON é uma necessidade frequente ao construir pipelines de troca de dados ou alimentar APIs. Conholdate.Total for Java é um SDK poderoso que simplifica essa tarefa para desenvolvedores Java. Neste guia, você aprenderá como configurar a biblioteca, percorrer uma implementação completa e ajustar finamente as opções de conversão para atender às necessidades do seu projeto.

Pré-requisitos e Configuração para Conholdate.Total for Java

Antes de começar, certifique‑se de que você tem:

  • Java 17 ou mais recente instalado.
  • Maven 3.6+ para gerenciamento de dependências.
  • Um arquivo Excel (.xlsx) que você deseja converter.

Adicione o repositório Maven do Conholdate.Total e a dependência ao seu pom.xml:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Você também pode baixar os JARs mais recentes diretamente da página de download. Com o SDK configurado, você está pronto para iniciar a conversão de Excel para JSON em Java.

Conversão de Excel para JSON em Java: Guia passo a passo

Etapa 1: Carregar o documento Excel de origem

Primeiro, especifique o caminho para o arquivo XLSX de origem e crie uma instância Conversion. O bloco try‑with‑resources garante que o objeto de conversão seja descartado corretamente.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

Etapa 2: Configurar opções de conversão JSON

Crie um objeto JsonConvertOptions e ajuste configurações como pretty‑print, inclusão de cabeçalhos, formatos personalizados de data e número e tamanho do lote. Essas opções controlam como a conversão de Excel para JSON em Java molda a saída final.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

Etapa 3: Executar a Conversão

Forneça o nome do arquivo JSON de destino e invoque o método convert. O SDK lida com a transformação internamente.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

Etapa 4: Manipular o Resultado e Limpeza

Após a conversão, exiba uma mensagem de confirmação. Quaisquer exceções são capturadas e impressas no console.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

Com estas etapas, a conversão de Excel para JSON em Java está concluída, e você pode integrar o JSON gerado em sua API ou fluxo de trabalho de processamento de dados.

Implementação Completa: Conversão de Excel Java para JSON

O exemplo a seguir demonstra como realizar a conversão de Excel para JSON em Java usando Conholdate.Total for Java.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, 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.

Opções e Configurações de Conversão

O SDK oferece várias opções para personalizar a saída JSON:

  • Pretty Print - Melhora a legibilidade ao adicionar recuo.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Usa a primeira linha da planilha como nomes de propriedades.
    setIncludeHeaders(true) (veja a referência da API).
  • Custom Date Format - Define um padrão de data, por exemplo, "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Controla a precisão numérica, por exemplo, "#.##".
    setCustomNumberFormat("#.##").

Ajustar essas configurações permite alinhar o JSON gerado com as expectativas de serviços ou bancos de dados downstream.

Conclusão

Agora você tem uma conversão de Excel para JSON funcional em Java, alimentada por Conholdate.Total for Java. O SDK cuida do trabalho pesado, enquanto as opções configuráveis dão a você controle sobre formatação e desempenho. Lembre‑se de obter uma licença adequada para uso em produção; você pode solicitar uma página de licença temporária para avaliar a biblioteca ou revisar a página de preços completa para termos comerciais. Feliz codificação!

Perguntas Frequentes

  • Como faço a conversão de Excel para JSON em Java com Conholdate.Total?
    Use a classe Conversion juntamente com JsonConvertOptions conforme mostrado no exemplo de código. O SDK abstrai o manuseio de arquivos e fornece uma única chamada convert.

  • Posso personalizar formatos de data e número durante a conversão de Excel para JSON em Java?
    Sim. Os métodos setCustomDateFormat e setCustomNumberFormat permitem definir padrões que correspondem às expectativas do seu sistema de destino.

  • Quais opções de licenciamento estão disponíveis para Conholdate.Total for Java?
    Você pode obter uma licença de avaliação temporária na página de licença temporária ou adquirir uma licença completa através da página de preços.

  • O processamento em lote é suportado para arquivos Excel grandes?
    A opção setRowsPerBatch permite processar planilhas em blocos, o que é ideal para cenários de conversão em lote.

Leia Mais