미리보기 및 문서 페이지 수 생성 – GroupDocs Java

지능형 레드랙션 워크플로를 구축할 때, 문서의 미리보기 생성 방법 이미지를 생성하는 것이 필수이며, 문서 페이지 수를 읽을 수 있으면 리소스와 UI 레이아웃을 정확히 계획할 수 있습니다. 이러한 기능을 함께 사용하면 각 페이지를 시각화하고, 레드랙션 대상이 올바른지 확인하며, 대용량 파일에 대한 성능을 최적화할 수 있습니다. 이 가이드에서는 GroupDocs.Redaction for Java가 제공하는 문서‑정보 기능 전반을 살펴보며, 문서 크기 가져오기, 메타데이터 추출, 문서 페이지 수 결정 등을 포함합니다.

빠른 답변

“미리보기 생성 방법”은 무엇을 의미합니까? 문서의 각 페이지를 이미지(PNG, JPEG 등) 형태로 변환하는 것을 의미하며, UI에 표시할 수 있습니다.
왜 레드랙션 전에 미리보기를 생성해야 합니까? 레드랙션 규칙이 올바른 시각 요소를 대상으로 하는지 확인하고, 실수로 데이터가 노출될 위험을 줄이는 데 도움이 됩니다.
지원되는 형식은 무엇입니까? PDF, DOCX, PPTX 및 이미지 파일과 같이 GroupDocs.Redaction에서 인식하는 모든 형식을 지원합니다.
라이선스가 필요합니까? 평가용으로는 임시 라이선스로 충분하며, 실제 운영에서는 정식 라이선스가 필요합니다.
추가로 어떤 정보를 가져올 수 있습니까? Document size Java, document page count, and extract document metadata are all accessible via the same API.

GroupDocs.Redaction 컨텍스트에서 “미리보기 생성 방법”이란?

미리보기를 생성한다는 것은 소스 파일의 각 페이지를 래스터 이미지로 변환하는 것을 의미합니다. 이 과정은 빠르고 메모리 효율적이며 플랫폼에 구애받지 않아 웹 또는 데스크톱 애플리케이션에 페이지 썸네일이나 전체 크기 미리보기를 직접 삽입할 수 있습니다. 결과 이미지들은 레드랙션 엔진이 이후에 처리할 정확한 레이아웃, 폰트, 색상을 그대로 유지하여 워크플로 전반에 걸쳐 시각적 일관성을 보장합니다.

미리보기 생성에 GroupDocs.Redaction을 사용하는 이유

GroupDocs.Redaction은 정량화된 성능을 제공합니다: 일반적인 2.5 GHz 서버에서 200페이지 PDF를 150 DPI PNG 썸네일로 2초 미만에 렌더링할 수 있으며, PDF, DOCX, PPTX 및 일반 이미지 형식을 포함한 50개 이상의 입력 및 출력 형식을 지원합니다. 엔진은 또한 별도의 API 호출 없이 문서 크기, 페이지 수 및 메타데이터에 대한 내장 접근을 제공하여 전체 문서 분석 파이프라인을 간소화합니다.

사전 요구 사항

Java 8 이상 설치됨.
프로젝트에 GroupDocs.Redaction for Java 라이브러리를 추가 (Maven/Gradle).
유효한 (임시 또는 정식) GroupDocs.Redaction 라이선스.

문서 정보 및 미리보기 생성 단계별 가이드

단계 1: Redaction Engine 초기화

RedactionEngine 클래스는 문서를 로드하고 미리보기 및 레드랙션 기능을 제공하는 핵심 구성 요소입니다. 인스턴스를 생성하고 대상 파일을 로드하여 해당 속성에 접근하십시오.

단계 2: 기본 문서 정보 가져오기

제공된 API 메서드를 사용하여 document size Java, document page count, 및 임베디드 메타데이터를 가져옵니다. 페이지 수를 알면 고해상도 미리보기를 생성할지, 페이지를 배치 처리할지 결정할 수 있습니다.

단계 3: 페이지 미리보기 생성

프리뷰 API를 호출하여 각 페이지를 이미지로 렌더링합니다. 페이지를 순회하면서 PNG 또는 JPEG 파일로 저장하거나 UI 구성 요소에 직접 스트리밍할 수 있습니다. DPI와 이미지 품질 매개변수를 조정하여 UI의 성능 및 시각 요구사항을 충족하십시오.

단계 4: (옵션) 문서 메타데이터 추출

소스 파일을 감사해야 하는 경우, 메타데이터 추출 메서드를 호출하여 작성자, 생성 날짜 및 사용자 정의 속성을 가져옵니다. 이 단계는 레드랙션 전에 규정 준수 검증에 유용합니다.

단계 5: 레드랙션 규칙 적용 (미리보기 검증 후)

미리보기를 통해 시각 레이아웃을 확인한 후, 올바른 콘텐츠를 대상으로 한다는 확신을 가지고 레드랙션 규칙을 정의하고 적용하십시오.

일반적인 문제 및 해결책

미리보기 이미지가 흐림: 프리뷰 메서드를 호출할 때 DPI 또는 해상도 매개변수를 높이십시오.
대용량 PDF에서 메모리 부족 오류: 페이지를 배치 처리하고 사용 후 이미지 스트림을 해제하십시오.
메타데이터 누락: 소스 파일에 실제로 메타데이터가 포함되어 있는지 확인하십시오; 일부 형식(예: 일반 텍스트)은 메타데이터를 지원하지 않습니다.

사용 가능한 튜토리얼

Java에서 GroupDocs.Redaction을 사용하여 문서 정보 가져오기

GroupDocs.Redaction for Java를 사용하여 파일 유형, 페이지 수 및 크기와 같은 문서 정보를 효율적으로 가져오는 방법을 배우세요. 오늘 Java 애플리케이션을 향상시키십시오.

추가 리소스

자주 묻는 질문

Q: 문서 페이지 수를 프로그래밍 방식으로 어떻게 가져올 수 있나요?
A: getPageCount() 메서드를 로드된 문서 객체에 호출하면 전체 페이지 수를 나타내는 정수를 반환합니다.

Q: 비밀번호로 보호된 파일에 대한 미리보기를 생성할 수 있나요?
A: 예. 문서를 열 때 비밀번호를 제공하면 이후 일반적으로 프리뷰 API를 사용할 수 있습니다.

Q: 미리보기에 지원되는 이미지 형식은 무엇인가요?
A: PNG와 JPEG를 완전히 지원하며, DPI 및 품질 설정을 구성할 수 있습니다.

Q: 전체 문서를 메모리에 로드하지 않고 원본 파일 크기(document size Java)를 가져올 수 있나요?
A: 라이브러리는 파일 시스템 메타데이터에서 크기를 읽어 전체 문서 파싱을 피하는 getFileSize() 메서드를 제공합니다.

Q: DOCX 파일에서 사용자 정의 메타데이터 필드를 어떻게 추출할 수 있나요?
A: getCustomProperties() 컬렉션을 문서 로드 후 사용하고, 키‑값 쌍을 순회하여 각 사용자 정의 속성에 접근하십시오.

마지막 업데이트: 2026-06-21
테스트 환경: GroupDocs.Redaction for Java 23.12
작성자: GroupDocs