Aspose.Cells FOSS
Java
Load a Spreadsheet

Come caricare un foglio di calcolo in Java

Come caricare un foglio di calcolo in Java

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