Esempio completo funzionante per dividere una cartella di lavoro Excel in Java

Questo esempio dimostra come dividere una cartella di lavoro Excel in file separati utilizzando 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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, 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.

Classi chiave utilizzate

Lo snippet si basa su tre classi principali della libreria Aspose.Cells fornita con Conholdate.Total:

• Workbook - rappresenta un intero file Excel e fornisce metodi per caricare, salvare e manipolare i workbook. Vedi la riferimento API della classe Workbook.
• Worksheet - consente l’accesso a un singolo foglio all’interno di un workbook.
• SaveFormat - enumerazione che definisce il formato di output; SaveFormat.XLSX scrive il file nel contenitore XLSX moderno.

Queste classi sono leggere, ma allocano risorse native, quindi rilasciarle prontamente (come mostrato) è essenziale per Gestione della memoria per file Excel di grandi dimensioni.

Analisi della divisione della cartella di lavoro Excel in Java

Il programma segue una sequenza chiara che puoi adattare a qualsiasi flusso di lavoro Excel Split Java.

Spiegazione passo‑passo

1. Carica la cartella di lavoro di origine - new Workbook(sourceFile) legge il file XLSX di input.

Workbook sourceWorkbook = new Workbook(sourceFile);

2. Crea directory di output - Verifica se la cartella di destinazione esiste e la crea se necessario.

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

3. Iterare attraverso i fogli di lavoro - sourceWorkbook.getWorksheets().getCount() restituisce il numero di fogli e il ciclo elabora ogni foglio.

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

4. Copia il foglio corrente in una nuova cartella di lavoro - addCopy(sheet) duplica il foglio, quindi il foglio vuoto predefinito viene rimosso se presente.

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

5. Salva la cartella di lavoro divisa - Genera un nome file sicuro e scrive il foglio come file XLSX.

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

6. Rilasciare le risorse - Chiama dispose() sia sul workbook temporaneo che su quello di origine per liberare la memoria ed evitare perdite native.

L’intero flusso è un pratico Esempio di codice Java per dividere fogli Excel che può essere incorporato in pipeline di elaborazione dati più ampie.

Prerequisiti e Configurazione - Iniziare con Conholdate.Total

Prima di poter compilare ed eseguire l’esempio, assicurati che il tuo ambiente di sviluppo soddisfi i seguenti requisiti.

Configurazione Maven

Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo 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>

Scarica l’ultimo pacchetto SDK dalla pagina di download ufficiale: Conholdate.Total for Java download. La libreria richiede Java 8 o versioni successive e funziona su qualsiasi JVM standard.

Configurazione della licenza

È necessaria una licenza valida per l’uso in produzione. È possibile ottenere una licenza temporanea per i test dalla pagina della licenza temporanea. Per progetti a lungo termine, consultare le opzioni di prezzo nella pagina dei prezzi. Una volta ottenuto il file di licenza, impostalo nel codice di avvio dell’applicazione (non mostrato qui) come descritto nella documentazione.

Suggerimenti pratici per una divisione efficiente di Excel

Lavorare con cartelle di lavoro di grandi dimensioni richiede una gestione attenta delle risorse. Le seguenti raccomandazioni ti aiutano a mantenere il processo veloce e affidabile.

Raccomandazioni per la gestione della memoria

• Elimina ogni cartella di lavoro temporanea dopo il salvataggio per rilasciare le risorse native e mantenere basso l’uso della memoria.
• Riutilizza gli oggetti quando possibile - creare un’unica istanza Workbook per la sorgente e riutilizzare lo stesso oggetto File per la directory di output riduce la pressione sul garbage‑collector.
• Considera la modalità streaming se la tua versione di Conholdate.Total la supporta; lo streaming legge le righe su‑richiesta invece di caricare l’intera cartella di lavoro in memoria.

Errori comuni e come evitarli

Acceleratori di prestazioni

• Log progress - stampare il nome del foglio prima del salvataggio aiuta a identificare il punto di errore in grandi batch.
• Increase JVM heap - per cartelle di lavoro estremamente grandi, avviare la JVM con -Xmx2g (o più) per fornire più memoria al processo.
• Parallel processing - se la cartella di lavoro non è inter‑dipendente, è possibile suddividere il lavoro su più thread, ma ricordare che la libreria nativa sottostante non è sempre thread‑safe; testare accuratamente.

Seguendo questi consigli, puoi split Excel Workbook in Java in modo efficiente anche quando lavori con migliaia di fogli o cartelle di lavoro che hanno centinaia di megabyte di dimensione.

Conclusione

Dividere un workbook Excel in file XLSX individuali con Conholdate.Total for Java è una tecnica semplice ma potente per gli sviluppatori Java che necessitano di un accesso granulare ai dati dei fogli di lavoro. Il codice fornito mostra l’intero flusso di lavoro, dal caricamento del workbook di origine allo smaltimento delle risorse dopo il salvataggio di ogni foglio. Utilizzare questo approccio per dividere il workbook Excel in Java ti offre un controllo fine su ogni foglio e si integra facilmente in pipeline di elaborazione dati più ampie. Ricorda di ottenere una licenza adeguata per l’uso in produzione; puoi esplorare le opzioni di prezzo nella pagina dei prezzi o richiedere una licenza temporanea nella pagina della licenza temporanea. Con l’SDK installato e le raccomandazioni delle best‑practice applicate, sei pronto a gestire anche gli scenari più esigenti di Excel Split Java.

Domande frequenti

Come posso dividere una cartella di lavoro Excel in Java usando Conholdate.Total?
Usa la classe ExcelSplitter mostrata nell’esempio completo. Carica la cartella di lavoro di origine, itera attraverso ogni foglio di lavoro, crea una nuova cartella di lavoro per foglio e la salva come file XLSX individuale. Questo metodo funziona anche quando è necessario dividere un file XLSX usando Java per qualsiasi dimensione della cartella di lavoro.

L’SDK è compatibile con tutte le versioni di Java?
L’SDK supporta Java 8 e successive. Assicurati che il tuo progetto utilizzi un JDK compatibile.

Devo impostare una licenza prima di eseguire il codice?
È necessaria una licenza per le distribuzioni in produzione. È possibile ottenere una licenza temporanea per i test dalla pagina della licenza temporanea e consultare i prezzi completi nella pagina dei prezzi.

E se il mio workbook contiene migliaia di fogli?
Elabora il workbook a lotti, elimina rapidamente ogni workbook temporaneo e, se necessario, considera di aumentare la dimensione dell’heap JVM. Registrare il nome di ogni foglio ti aiuta a individuare rapidamente eventuali fogli problematici.

Leggi di più

• Inserire una filigrana in Excel usando Java
• Convertire Excel in immagine in Java
• Conversione da Excel a JSON in Java