Load a Spreadsheet

Javaでスプレッドシートをロードする方法

Javaでスプレッドシートをロードする方法

Aspose.Cells FOSS for Java は、ファイルパスまたは任意の java.io.InputStream から既存の Excel .xlsx ワークブックを開くことができます。このガイドでは、両方のロードパターンを示し、ワークブックがロードされた後のワークシートやセルへのアクセス方法を説明します。


前提条件

要件詳細
Java17以降 (JDK)

現在のソースモデルでは、AutoFilter API の表面が変更されています。古いメンバーの詳細に依存する前に、リファレンスページを確認してください。 | ビルドツール | Maven 3.9+ or Gradle 8+ | | 依存関係 | org.aspose:aspose-cells-foss:26.7.0 | | 入力ファイル | 有効な .xlsx ワークブック |

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 — ストリームからロード

ファイル内容がネットワーク接続、データベース BLOB、またはメモリバッファから取得される場合は Workbook(stream) を使用します:

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

次のステップ

参照

 日本語