Javaでスプレッドシートをロードする方法
Javaでスプレッドシートをロードする方法
Aspose.Cells FOSS for Java は、ファイルパスまたは任意の java.io.InputStream から既存の Excel .xlsx ワークブックを開くことができます。このガイドでは、両方のロードパターンを示し、ワークブックがロードされた後のワークシートやセルへのアクセス方法を説明します。
前提条件
| 要件 | 詳細 |
|---|---|
| Java | 17以降 (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次のステップ
- スプレッドシート管理の操作 — 完全な作成/変更/保存の手順
- Aspose.Cells FOSS ワークブックの作成方法 — ゼロからワークブックを作成
- 検証の使い方 — データ検証ルールを追加