Aspose.Cells FOSS
Java
Load a Spreadsheet

Come caricare un foglio di calcolo in Java

Panoramica

Aspose.Cells FOSS per Java ti consente di aprire cartelle di lavoro Excel .xlsx esistenti da un percorso file o da qualsiasi java.io.InputStream. Questa guida mostra entrambi i modelli di caricamento e spiega come accedere ai fogli di lavoro e alle celle dopo che la cartella di lavoro è stata caricata.

Prerequisiti

RequisitoDettaglio
Java17 o successive (JDK)

L’interfaccia AutoFilter di API è cambiata nel modello sorgente attuale; consulta la sua pagina di riferimento prima di fare affidamento sui dettagli dei membri più vecchi. | Build tool | Maven 3.9+ o Gradle 8+ | | Dependency | org.aspose:aspose-cells-foss:26.7.0 | | Input file | A valid .xlsx workbook |

Aggiungi a pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-cells-foss</artifactId>
  <version>26.7.0</version>
</dependency>

Passo 1 — Carica da un percorso file

Passa il percorso file assoluto o relativo al costruttore Workbook(fileName):

import com.aspose.cells.foss.Workbook;

Workbook workbook = new Workbook("data/report.xlsx");
System.out.println("Loaded. Sheets: " + workbook.getWorksheets().getCount());

Il costruttore legge il file e deserializza il contenuto XLSX in memoria. Se il file non esiste o non è un XLSX valido, viene generato un WorkbookLoadException.

Passo 2 — Carica da uno Stream

Usa Workbook(stream) quando il contenuto del file proviene da una connessione di rete, da un BLOB di database o da un buffer in memoria:

import com.aspose.cells.foss.Workbook;
import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream is = new FileInputStream("data/report.xlsx")) {
    Workbook workbook = new Workbook(is);
    System.out.println("Loaded from stream. Sheets: " + workbook.getWorksheets().getCount());
}

Avvolgi sempre il InputStream in un blocco try-with-resources in modo che lo stream venga chiuso anche se il costruttore genera un’eccezione.

Passo 3 — Carica con Opzioni

Usa Workbook(fileName, options) o Workbook(stream, options) per passare un’istanza LoadOptions quando hai bisogno di un controllo granulare sul comportamento di caricamento:

import com.aspose.cells.foss.Workbook;
import com.aspose.cells.foss.LoadOptions;

LoadOptions opts = new LoadOptions();
// configure opts here if needed
Workbook workbook = new Workbook("data/report.xlsx", opts);

Passo 4 — Accedi ai Fogli di lavoro

Dopo il caricamento, usa Workbook.getWorksheets() per iterare i fogli o recuperare un foglio specifico per indice o per nome:

import com.aspose.cells.foss.WorksheetCollection;
import com.aspose.cells.foss.Worksheet;

WorksheetCollection sheets = workbook.getWorksheets();
System.out.println("Sheet count: " + sheets.getCount());

// By index
Worksheet first = sheets.get(0);
System.out.println("First sheet: " + first.getName());

// By name
Worksheet named = sheets.get("Summary");

Passo 5 — Leggi i valori delle celle

Una volta che hai un Worksheet, usa getCells() per accedere alle singole celle:

import com.aspose.cells.foss.Cells;
import com.aspose.cells.foss.Cell;

Cells cells = first.getCells();

// Read by cell name
Cell a1 = cells.get("A1");
System.out.println("A1 value: " + a1.getStringValue());

// Read by row/column index (0-based)
Cell b2 = cells.get(1, 1);
System.out.println("B2 value: " + b2.getValue());

Passo 6 — Rilascia le risorse

Workbook implementa AutoCloseable. Per file di grandi dimensioni, usa try-with-resources:

try (Workbook workbook = new Workbook("data/large.xlsx")) {
    // read or modify the workbook
    workbook.save("data/output.xlsx");
}
// workbook.close() is called automatically here

Passi successivi

Vedi anche

 Italiano