GroupDocs.Parser와 함께 java excel 파싱 라이브러리를 사용하는 방법

현대 데이터 기반 애플리케이션에서 Excel 파일을 효율적으로 파싱하는 방법은 워크플로우의 성공을 좌우할 수 있습니다. 레거시 데이터를 마이그레이션하거나 자동 보고서를 생성하거나 분석 파이프라인에 원시 텍스트를 공급하든, 각 워크시트에서 서식이 없는 텍스트를 추출하는 것은 일반적인 요구 사항입니다. 이 튜토리얼에서는 java excel 파싱 라이브러리—GroupDocs.Parser for Java—를 사용하여 Excel 워크북을 열고, 시트를 순회하며, 몇 줄의 코드만으로 원시 콘텐츠를 가져오는 방법을 보여줍니다.

빠른 답변

  • Java에서 Excel 파싱을 처리하는 라이브러리는 무엇인가요? GroupDocs.Parser for Java.
  • 각 시트에서 원시 텍스트를 추출할 수 있나요? 예, TextReader와 raw 모드를 사용하면 됩니다.
  • 라이선스가 필요합니까? 평가용으로 임시 무료 라이선스를 사용할 수 있습니다.
  • 필요한 Java 버전은 무엇인가요? JDK 8 또는 그 이상.
  • Maven을 지원합니까? 물론입니다 – pom.xml에 저장소와 의존성을 추가하세요.

java excel 파싱 라이브러리란?

GroupDocs.Parser for Java는 java excel 파싱 라이브러리로, 프로그래밍 방식으로 .xlsx, .xls 또는 CSV 워크북을 열고 전체 스프레드시트를 메모리에 로드하지 않고도 일반 텍스트를 읽습니다. 이 접근 방식은 기존 스프레드시트 API보다 빠르며 기본 문자에 직접 접근할 수 있게 해줍니다.

왜 GroupDocs.Parser for Java를 사용해야 할까요?

GroupDocs.Parser는 한 번에 하나의 시트를 처리하여 500페이지 워크북이라도 메모리 사용량을 10 MB 이하로 유지합니다. XLSX, XLS, CSV, ODS 등 10가지 이상의 입력 및 출력 형식을 지원하므로 단일 API로 다양한 스프레드시트 유형을 처리할 수 있습니다. 간단하고 유창한 메서드를 통해 몇 분 안에 텍스트 추출을 시작할 수 있으며, 라이선스 모델은 코드 변경 없이 평가판에서 프로덕션까지 확장됩니다.

전제 조건

  • Java Development Kit (JDK): 8 이상.
  • IDE: IntelliJ IDEA, Eclipse 또는 Java 호환 편집기.
  • Maven (optional): 의존성 관리를 쉽게 하기 위해.

GroupDocs.Parser for Java 설정

Maven 설정

Maven으로 의존성을 관리한다면, 저장소와 의존성을 pom.xml에 추가하세요:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/parser/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-parser</artifactId>
      <version>25.5</version>
   </dependency>
</dependencies>

직접 다운로드

또는 최신 버전의 GroupDocs.Parser for Java를 GroupDocs releases에서 직접 다운로드하세요.

라이선스 획득

무료 체험을 시작하려면 GroupDocs website를 방문하여 임시 라이선스를 받으세요. 이를 통해 프로덕션 라이선스를 구매하기 전에 라이브러리의 전체 기능을 평가할 수 있습니다.

기본 초기화 및 설정

GroupDocs.Parser는 문서 파서를 나타내는 핵심 클래스입니다. 라이브러리를 클래스패스에 추가한 후, Excel 워크북을 가리키는 Parser 인스턴스를 생성할 수 있습니다:

import com.groupdocs.parser.Parser;
import com.groupdocs.parser.data.TextReader;
import com.groupdocs.parser.options.IDocumentInfo;
import com.groupdocs.parser.options.TextOptions;

String excelFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";

try (Parser parser = new Parser(excelFilePath)) {
    // Your code to work with the document
} catch (Exception e) {
    e.printStackTrace();
}

환경이 준비되었으니 실제 추출 로직을 살펴보겠습니다.

Excel 파싱 방법: 시트에서 원시 텍스트 추출

워크북을 로드하고 두 단계만으로 원시 텍스트를 가져옵니다. 먼저 시트 이름과 크기와 같은 기본 문서 정보를 얻습니다. 그런 다음 TextOptions(true)로 구성된 TextReader를 사용해 각 워크시트를 순회하면, 서식 태그 없이 순수 문자만 반환되는 raw 모드가 활성화됩니다.

TextReader는 문서에서 텍스트를 읽으며, 옵션으로 raw 모드에서도 읽을 수 있습니다.

IDocumentInfo spreadsheetInfo = parser.getDocumentInfo();

다음으로 모든 시트를 순회하며 서식이 없는 텍스트를 추출합니다. TextOptions(true) 플래그가 raw 모드를 활성화하여 스타일 태그 없이 순수 문자를 반환합니다.

TextOptions는 텍스트 추출 동작을 설정하며, boolean 플래그를 통해 raw 모드를 활성화합니다.

for (int p = 0; p < spreadsheetInfo.getRawPageCount(); p++) {
    try (TextReader reader = parser.getText(p, new TextOptions(true))) {
        String sheetContent = reader.readToEnd();
        
        // Process or use extracted text data here
    }
}

추출된 데이터 처리

이 시점에서 sheetContent는 현재 워크시트의 순수 텍스트를 담고 있습니다. 다음과 같이 활용할 수 있습니다:

  • .txt 파일에 저장하여 보관합니다.
  • 자연어 처리 파이프라인에 입력합니다.
  • 데이터베이스에 저장하여 나중에 조회합니다.

일반적인 문제 및 해결책

ProblemWhy it happensFix
파일을 찾을 수 없음excelFilePath가 잘못되었습니다.경로를 확인하고 파일이 읽을 수 있는지 확인하세요.
지원되지 않는 형식새 파서 버전에서 오래된 XLS 파일을 사용하고 있습니다.파일을 XLSX로 변환하거나 최신 GroupDocs.Parser 버전으로 업데이트하세요.
대형 워크북에서 메모리 부족 오류한 번에 모든 시트를 로드하고 있습니다.한 번에 하나의 시트만 처리하고(예시와 같이) 즉시 리소스를 해제하세요.
라이선스 예외평가판이 만료되었거나 라이선스 파일이 없습니다.파싱하기 전에 유효한 임시 또는 구매한 라이선스를 적용하세요.

실용적인 적용 사례 (Excel 시트 텍스트 읽기)

  1. 데이터 마이그레이션: 레거시 스프레드시트 데이터를 수동 복사‑붙여넣기 없이 현대 데이터베이스로 이동합니다.
  2. 자동 보고: 여러 워크북에서 원시 값을 가져와 통합 PDF 또는 HTML 보고서를 생성합니다.
  3. 검색 인덱싱: 추출된 텍스트를 Elasticsearch에 인덱싱하여 빠른 콘텐츠 검색을 가능하게 합니다.

대형 Excel 파일에 대한 성능 팁

  • 시트당 스트리밍: 루프가 이미 한 번에 하나의 시트를 처리하므로 메모리 사용량이 낮게 유지됩니다.
  • TextReader 객체 재사용: 루프 내부에서 불필요한 객체 생성을 피하세요.
  • 병렬 처리: 매우 큰 워크북의 경우 시트를 별도 스레드에서 처리하는 것을 고려하되, Parser 인스턴스의 스레드 안전성을 유의하세요.

자주 묻는 질문

Q: GroupDocs.Parser가 지원하는 다른 스프레드시트 형식은 무엇인가요?
A: XLSX, XLS, CSV, ODS 및 기타 Office Open XML 형식 등 총 10가지 이상의 형식을 처리합니다.

Q: 셀 서식 정보도 추출할 수 있나요?
A: 예, raw 플래그 없이 TextOptions를 사용하면 기본 스타일을 보존한 서식 있는 텍스트를 가져올 수 있습니다.

Q: 비밀번호로 보호된 Excel 파일을 어떻게 처리하나요?
A: Parser 생성자에 비밀번호를 전달합니다: new Parser(filePath, "password").

Q: 특정 열만 추출하는 방법이 있나요?
A: sheetContent를 후처리하여 라인을 필터링하거나 SpreadsheetOptions API를 사용해 보다 세밀하게 제어할 수 있습니다.

Q: 더 많은 코드 예제를 어디서 찾을 수 있나요?
A: GroupDocs documentation 및 GitHub 저장소에서 추가 샘플을 확인하세요.

리소스


마지막 업데이트: 2026-09-27
테스트 환경: GroupDocs.Parser 25.5 for Java
작성자: GroupDocs

관련 튜토리얼