Exemplo completo em funcionamento para dividir a pasta de trabalho do Excel em Java

Este exemplo demonstra como dividir uma pasta de trabalho do Excel em arquivos separados usando o Conholdate.Total.

import com.aspose.cells.Workbook;
import com.aspose.cells.Worksheet;
import com.aspose.cells.SaveFormat;
import java.io.File;

public class ExcelSplitter {
    public static void main(String[] args) {
        String sourceFile = "input.xlsx";
        String outputDir = "splitted";

File dir = new File(outputDir);
        if (!dir.exists()) {
            dir.mkdirs();
        }

try {
            Workbook sourceWorkbook = new Workbook(sourceFile);
            int sheetCount = sourceWorkbook.getWorksheets().getCount();

for (int i = 0; i < sheetCount; i++) {
                Worksheet sheet = sourceWorkbook.getWorksheets().get(i);
                Workbook splitWorkbook = new Workbook();

splitWorkbook.getWorksheets().addCopy(sheet);
                if (splitWorkbook.getWorksheets().getCount() > 1) {
                    splitWorkbook.getWorksheets().removeAt(0);
                }

String safeName = sheet.getName().replaceAll("[\\\\/:*?\"<>|]", "_");
                String outPath = outputDir + File.separator + safeName + ".xlsx";

splitWorkbook.save(outPath, SaveFormat.XLSX);
                splitWorkbook.dispose();
            }

sourceWorkbook.dispose();
        } catch (Exception e) {
            System.err.println("Error during splitting: " + 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 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 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 assistência.

Classes Principais Usadas

O trecho depende de três classes principais da biblioteca Aspose.Cells que vem com o Conholdate.Total:

• Workbook - representa um arquivo Excel completo e fornece métodos para carregar, salvar e manipular pastas de trabalho. Veja a referência da API da classe Workbook.
• Worksheet - fornece acesso a uma planilha individual dentro de uma pasta de trabalho.
• SaveFormat - enumeração que define o formato de saída; SaveFormat.XLSX grava o arquivo no contêiner XLSX moderno.

Essas classes são leves, mas alocam recursos nativos, portanto descartá‑las prontamente (conforme mostrado) é essencial para Gerenciamento de Memória para Arquivos Excel Grandes.

Analisando a divisão da pasta de trabalho do Excel em Java

O programa segue uma sequência clara que você pode adaptar a qualquer fluxo de trabalho Excel Split Java.

Explicação passo a passo

1. Carregar a pasta de trabalho de origem - new Workbook(sourceFile) lê o XLSX de entrada.

Workbook sourceWorkbook = new Workbook(sourceFile);

2. Criar diretório de saída - Verifica se a pasta de destino existe e a cria se necessário.

File dir = new File(outputDir);
if (!dir.exists()) {
    dir.mkdirs();
}

3. Iterar pelas planilhas - sourceWorkbook.getWorksheets().getCount() fornece a contagem de planilhas e o loop processa cada planilha.

for (int i = 0; i < sheetCount; i++) {
    Worksheet sheet = sourceWorkbook.getWorksheets().get(i);
}

4. Copiar a planilha atual para uma nova pasta de trabalho - addCopy(sheet) duplica a planilha, e então a planilha vazia padrão é removida, se presente.

Workbook splitWorkbook = new Workbook();
splitWorkbook.getWorksheets().addCopy(sheet);
if (splitWorkbook.getWorksheets().getCount() > 1) {
    splitWorkbook.getWorksheets().removeAt(0);
}

5. Salvar a pasta de trabalho dividida - Gera um nome de arquivo seguro e grava a planilha como um arquivo XLSX.

String safeName = sheet.getName().replaceAll("[\\\\/:*?\"<>|]", "_");
String outPath = outputDir + File.separator + safeName + ".xlsx";
splitWorkbook.save(outPath, SaveFormat.XLSX);

6. Liberar recursos - Chama dispose() tanto nos workbooks temporário quanto no de origem para liberar memória e evitar vazamentos nativos.

Todo o fluxo é um Exemplo de Código Java para Dividir Planilhas Excel que pode ser incorporado em pipelines de processamento de dados maiores.

Pré-requisitos e Configuração - Começando com Conholdate.Total

Antes de compilar e executar o exemplo, certifique‑se de que seu ambiente de desenvolvimento atenda aos seguintes pré‑requisitos.

Configuração do Maven

Adicione o repositório Maven da Conholdate e a dependência SDK 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>

Baixe o pacote SDK mais recente na página oficial de download: Conholdate.Total for Java download. A biblioteca requer Java 8 ou superior e funciona em qualquer JVM padrão.

Configuração de Licença

É necessária uma licença válida para uso em produção. Você pode obter uma licença temporária para testes na página de licença temporária. Para projetos de longo prazo, revise as opções de preços na página de preços. Depois de ter o arquivo de licença, configure‑o no código de inicialização da sua aplicação (não mostrado aqui) conforme descrito na documentação.

Dicas práticas para dividir planilhas Excel de forma eficiente

Trabalhar com pastas de trabalho grandes exige um manuseio cuidadoso de recursos. As recomendações a seguir ajudam a manter o processo rápido e confiável.

Recomendações de Gerenciamento de Memória

• Libere cada workbook temporário após salvar para liberar recursos nativos e manter o uso de memória baixo.
• Reutilize objetos sempre que possível - criar uma única instância Workbook para a origem e reutilizar o mesmo objeto File para o diretório de saída reduz a pressão sobre o coletor de lixo.
• Considere o modo de streaming se sua versão do Conholdate.Total o suportar; o streaming lê linhas sob demanda em vez de carregar toda a planilha na memória.

Problemas Comuns e Como Evitá‑los

Aceleradores de desempenho

• Log progress - imprimir o nome da planilha antes de salvar ajuda a identificar o ponto de falha em lotes grandes.
• Increase JVM heap - para pastas de trabalho extremamente grandes, inicie a JVM com -Xmx2g (ou superior) para fornecer mais memória ao processo.
• Parallel processing - se a pasta de trabalho não for interdependente, você pode dividir o trabalho entre várias threads, mas lembre‑se de que a biblioteca nativa subjacente nem sempre é thread‑safe; teste minuciosamente.

Seguindo estas dicas, você pode dividir eficientemente split Excel Workbook in Java mesmo ao lidar com milhares de planilhas ou workbooks que têm centenas de megabytes de tamanho.

Conclusão

Dividir uma pasta de trabalho do Excel em arquivos XLSX individuais com Conholdate.Total for Java é uma técnica simples, porém poderosa, para desenvolvedores Java que precisam de acesso granular aos dados das planilhas. O código fornecido mostra o fluxo de trabalho completo, desde o carregamento da pasta de trabalho de origem até a liberação de recursos após cada planilha ser salva. Usar esta abordagem para dividir a pasta de trabalho do Excel em Java oferece controle detalhado sobre cada planilha e integra‑se facilmente a pipelines de processamento de dados maiores. Lembre‑se de obter uma licença adequada para uso em produção; você pode explorar opções de preços na página de preços ou solicitar uma licença temporária na página de licença temporária. Com o SDK instalado e as recomendações de boas práticas aplicadas, você está pronto para lidar até mesmo com os cenários mais exigentes de divisão de Excel em Java.

FAQs

Como posso dividir uma pasta de trabalho Excel em Java usando Conholdate.Total?
Use a classe ExcelSplitter mostrada no exemplo completo. Ela carrega a pasta de trabalho de origem, itera por cada planilha, cria uma nova pasta de trabalho por planilha e a salva como um arquivo XLSX individual. Esse método também funciona quando você precisa dividir um arquivo XLSX usando Java para qualquer tamanho de pasta de trabalho.

O SDK é compatível com todas as versões do Java?
O SDK suporta Java 8 e posteriores. Certifique‑se de que seu projeto tem como alvo um JDK compatível.

Preciso definir uma licença antes de executar o código?
É necessária uma licença para implantações em produção. Você pode obter uma licença temporária para testes na página de licença temporária e revisar os preços completos na página de preços.

E se minha pasta de trabalho contiver milhares de planilhas?
Processar a pasta de trabalho em lotes, descartar cada pasta de trabalho temporária prontamente e considerar aumentar o tamanho do heap da JVM, se necessário. Registrar o nome de cada planilha ajuda a identificar rapidamente qualquer planilha problemática.

Leia Mais

• Inserir marca d’água no Excel usando Java
• Converter Excel para Imagem em Java
• Conversão de Excel para JSON em Java