GroupDocs Viewer for Java를 사용하여 메타데이터 추출하는 방법

이 튜토리얼에서는 GroupDocs Viewer for Java를 사용하여 다양한 문서 유형에서 메타데이터를 추출하는 방법을 배웁니다. 가이드를 마치면 페이지 수를 가져오고, 지원되는 보기 형식을 확인하며, 전체 파일을 렌더링하지 않고 가벼운 문서 미리보기 기능을 구축할 수 있습니다. 이 방법은 get page count java를 빠르게 가져와야 할 때 또는 메모리를 효율적으로 사용하여 대용량 문서를 처리할 때 특히 유용합니다.

Retrieve Document View Information and Insights with GroupDocs.Viewer for Java

Viewer는 문서를 나타내는 핵심 클래스이며 렌더링 및 메타데이터 추출 메서드를 제공합니다.
getViewInfo는 페이지 수 및 지원되는 보기 유형과 같은 메타데이터를 포함하는 ViewInfo 객체를 반환합니다.

빠른 답변

  • “문서 메타데이터 추출”이란 무엇을 의미합니까? 전체 내용을 렌더링하지 않고 구조적 세부 정보(페이지 수, 보기 옵션, 형식별 데이터)를 가져오는 것입니다.
  • 어떤 메서드가 보기 정보를 제공합니까? viewer.getViewInfo(viewInfoOptions).
  • 전체 렌더링 없이 문서를 미리볼 수 있나요? 예, 보기 메타데이터를 사용하면 빠른 document preview java 기능을 구축할 수 있습니다.
  • 대용량 파일에 적합합니까? 물론입니다—메타데이터 추출은 최소한의 메모리를 사용하여 대용량 문서 관리를 효율적으로 도와줍니다.
  • 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 상업용 라이선스가 필요합니다.

GroupDocs Viewer for Java를 사용하여 메타데이터를 추출하는 방법

Viewer 클래스로 문서를 로드하고 getViewInfo를 호출하면—이 단일 호출로 페이지 수, 지원되는 보기 유형 및 형식별 옵션을 포함한 전체 보기 메타데이터를 반환합니다. 이 작업은 파일 헤더만 읽으므로 수백 페이지 파일에서도 몇 밀리초 안에 실행되며 전체 렌더링보다 훨씬 적은 RAM을 사용합니다.

Viewer 클래스란?

Viewer 클래스는 GroupDocs Viewer for Java의 핵심 구성 요소로, 문서를 나타내며 렌더링 및 메타데이터 추출 메서드를 제공합니다. 모든 보기 관련 작업은 이 객체를 통해 수행됩니다.

메타데이터 추출에 GroupDocs Viewer를 사용하는 이유는?

  • 성능: 일반 서버에서 300페이지 PDF에 대해 50 ms 미만으로 메타데이터를 가져오며, 5 MB 미만의 RAM을 사용합니다.
  • 포맷 지원: 50개 이상의 입력 및 출력 포맷을 지원합니다(PDF, DOCX, XLSX, PPTX, HTML, 이미지 등).
  • 확장성: get page count java를 즉시 수행할 수 있어 대규모 문서 포털의 페이지네이션 제어에 이상적입니다.
  • 보안: 명시적으로 요청하지 않는 한 민감한 콘텐츠를 렌더링하지 않으므로 공격 표면을 줄입니다.

필수 조건

  • GroupDocs.Viewer for Java: 버전 25.2 이상.
  • Java Development Kit (JDK): 버전 8 이상.
  • IDE(IntelliJ IDEA, Eclipse, NetBeans)와 의존성 관리를 위한 Maven.
  • 기본 Java 지식 및 Maven에 대한 친숙함.

GroupDocs Viewer for Java 설정

Maven pom.xml에 라이브러리를 추가합니다:

Maven 구성

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/viewer/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

라이선스 획득 단계

  • 무료 체험: 기능을 살펴보려면 GroupDocs 웹사이트에서 다운로드합니다.
  • 임시 라이선스: 기간 제한 키를 받아 확장 테스트를 수행합니다.
  • 상업용 라이선스: 제한 없는 프로덕션 사용을 위해 구매합니다.

구현 가이드

문서 보기 정보 가져오기

페이지 수 및 지원되는 보기 옵션과 같은 포괄적인 보기별 세부 정보를 가져옵니다.

개요

목표는 문서 메타데이터를 추출하는 것이며, 구체적으로 페이지 수와 지원되는 렌더링 형식을 알려주는 보기 정보를 의미합니다.

단계별 구현

1. Viewer 초기화
대상 파일을 가리키는 Viewer 인스턴스를 생성합니다:

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ViewInfo;

public class FeatureGetViewInfo {
    public static void main(String[] args) {
        // Specify the path to your input document.
        String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF";
        
        // Initialize ViewInfoOptions for HTML view.
        ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();

        try (Viewer viewer = new Viewer(filePath)) {
            // Retrieve view information about the document using the specified options.
            ViewInfo info = viewer.getViewInfo(viewInfoOptions);
            
            // The info object now contains details like page count and available views.
        }
    }
}

2. view‑info 옵션 구성

  • ViewInfoOptions.forHtmlView() – HTML 전용 메타데이터를 가져옵니다.
  • ViewInfoOptions.forPdfView() – PDF 전용 메타데이터를 가져옵니다.
  • ViewInfoOptions.forImageView() – 이미지 썸네일 메타데이터를 가져옵니다.

3. 메타데이터 가져오기
viewer.getViewInfo(viewInfoOptions)를 호출하여 페이지 수, 지원되는 보기 유형 및 기타 유용한 세부 정보를 포함하는 ViewInfo 객체를 얻습니다.

다른 형식에 대한 view info 가져오기

팩터리 메서드(forHtmlView())를 forPdfView() 또는 forImageView()로 교체하면 각각 PDF 또는 이미지 기반 미리보기에 대한 메타데이터를 가져올 수 있습니다.

일반적인 함정 및 문제 해결

  • File‑not‑found errors: Viewer 생성자에 전달하는 절대 경로나 상대 경로를 다시 확인하십시오.
  • Missing Maven artifacts: groupdocs-viewer 의존성이 해결되는지 확인하고, class not found 예외가 발생하면 mvn clean install을 실행하십시오.
  • Large document handling: Viewer를 자동으로 닫고 네이티브 리소스를 해제하도록 try‑with‑resources를 사용하십시오.

실제 적용 사례

  1. 문서 관리 시스템: 사용자가 파일을 업로드할 때 메타데이터 필드(페이지 수, 형식)를 자동으로 채워 효율적인 검색 및 분류를 가능하게 합니다.
  2. 빠른 미리보기 기능: 전체 렌더링 없이 첫 페이지 또는 썸네일을 표시하는 가벼운 how to preview document 컴포넌트를 구축합니다.
  3. 분석 및 보고: 저장소 전체의 페이지 수 통계를 수집하여 저장소 요구량을 예측하고 사용 추세를 모니터링합니다.

성능 고려 사항

  • Viewer 인스턴스를 즉시 해제하십시오(예: try‑with‑resources 사용)하여 네이티브 핸들을 해제합니다.
  • 필요할 때만 메타데이터를 추출하십시오; 불필요한 전체 렌더링 호출을 피하여 메모리 사용량을 낮게 유지합니다, 특히 manage large documents 시나리오에서.

자주 묻는 질문

Q: GroupDocs Viewer for Java에서 ViewInfoOptions의 목적은 무엇입니까?
A: API에 어떤 보기 형식(HTML, PDF, 이미지)의 메타데이터가 필요한지 알려 주어, 문서 메타데이터를 효율적으로 추출할 수 있게 합니다.

Q: PDF 외의 파일 유형에서도 GroupDocs Viewer for Java를 사용할 수 있나요?
A: 예, Word, Excel, PowerPoint 및 일반 이미지 유형을 포함한 50개 이상의 포맷을 지원하므로 metadata extraction java 프로젝트에 이상적입니다.

Q: 매우 큰 문서를 메모리를 소모하지 않고 처리하려면 어떻게 해야 하나요?
A: 메타데이터만 가져오고(getViewInfo 사용) Viewer를 즉시 닫으십시오; 이 방법은 수백 페이지 파일을 10 MB 이하의 RAM으로 처리합니다.

Q: 프로덕션 사용에 라이선스가 필요합니까?
A: 평가용으로 무료 체험판을 제공하지만, 프로덕션 배포에는 상업용 라이선스가 필수입니다.

Q: 이 기능을 구현할 때 가장 흔한 오류는 무엇입니까?
A: 잘못된 파일 경로와 Maven 의존성 누락이 주요 문제입니다. 문서 위치를 확인하고 groupdocs-viewer 아티팩트가 pom.xml에 올바르게 추가되었는지 확인하십시오.

리소스

마지막 업데이트: 2026-09-05
테스트 환경: GroupDocs.Viewer for Java 25.2
작성자: GroupDocs

관련 튜토리얼