Java에서 스프레드시트를 로드하는 방법
Java에서 스프레드시트를 로드하는 방법
Aspose.Cells FOSS for Java는 파일 경로나 any 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 워크북을 만드는 방법 — 처음부터 워크북 만들기
- 유효성 검증 활용 방법 — 데이터 검증 규칙 추가