Aspose.Cells FOSS
Java
Load a Spreadsheet

Как загрузить таблицу в Java

Как загрузить таблицу в Java

Aspose.Cells FOSS для Java позволяет открывать существующие рабочие книги Excel .xlsx из пути к файлу или из любого java.io.InputStream. Это руководство демонстрирует оба шаблона загрузки и объясняет, как получить доступ к листам и ячейкам после загрузки рабочей книги.

Требования

ТребованиеПодробности
Java17 или позже (JDK)

Поверхность AutoFilter API изменилась в текущей модели источника; ознакомьтесь со страницей справки, прежде чем полагаться на устаревшие детали членов. | Build tool | Maven 3.9+ or Gradle 8+ | | Dependency | org.aspose:aspose-cells-foss:26.7.0 | | Input file | A valid .xlsx workbook |

Добавьте в pom.xml:

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

Шаг 1 — Загрузка из пути к файлу

Передайте абсолютный или относительный путь к файлу конструктору Workbook(fileName):

import com.aspose.cells.foss.Workbook;

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

Конструктор читает файл и десериализует содержимое XLSX в память. Если файл не существует или не является корректным XLSX, будет выброшено исключение WorkbookLoadException.

Шаг 2 — Загрузка из потока

Используйте Workbook(stream), когда содержимое файла поступает из сетевого соединения, BLOB базы данных или буфера в памяти:

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());
}

Всегда оборачивайте InputStream в блок try-with-resources, чтобы поток закрывался даже если конструктор бросит исключение.

Шаг 3 — Загрузка с параметрами

Используйте Workbook(fileName, options) или Workbook(stream, options), чтобы передать экземпляр LoadOptions, когда требуется тонкая настройка поведения загрузки:

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);

Шаг 4 — Доступ к листам

После загрузки используйте Workbook.getWorksheets() для перебора листов или получения конкретного листа по индексу или по имени:

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");

Шаг 5 — Чтение значений ячеек

Как только у вас будет Worksheet, используйте getCells() для доступа к отдельным ячейкам:

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());

Шаг 6 — Освобождение ресурсов

Workbook реализует AutoCloseable. Для больших файлов используйте 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

Следующие шаги

См. также:

 Русский