GroupDocs.Viewer for Java를 사용하여 특정 PDF 페이지 회전하는 방법

PDF 내에서 특정 페이지를 회전하는 것은 문서 정렬, 스캔 이미지 수정, 프레젠테이션 슬라이드 조정 등에 필수적일 수 있습니다. 이 가이드에서는 GroupDocs.Viewer를 사용하여 프로그래밍 방식으로 특정 PDF 페이지를 회전하는 방법을 배웁니다, 필요에 따라 PDF를 90도 회전하거나 전체 섹션을 뒤집거나 한 번의 호출로 여러 페이지를 처리할 수 있습니다.

GroupDocs.Viewer for Java를 사용한 특정 PDF 페이지 회전

배울 내용

Java 프로젝트에 GroupDocs.Viewer 설정하기 (Maven GroupDocs Viewer 구성 포함)
프로그래밍 방식으로 특정 PDF 페이지 회전하기 (pdf 90도, 180도 등 회전)
최적 사용을 위한 주요 구성
구현 중 흔히 발생하는 문제 해결

빠른 답변

Java에서 PDF 페이지를 회전할 수 있는 라이브러리는 무엇인가요? GroupDocs.Viewer for Java.
단일 페이지를 90도 회전할 수 있나요? Yes, use rotatePage(pageNumber, Rotation.ON_90_DEGREE).
개발에 라이선스가 필요합니까? A temporary license is available for free trial.
Maven이 필요합니까? Maven is the recommended way to manage GroupDocs dependencies.
회전된 페이지를 어떻게 렌더링하나요? Use HtmlViewOptions and call viewer.view(...).

필수 조건

필요한 라이브러리 및 종속성

Java Development Kit (JDK) 8 이상.
IntelliJ IDEA 또는 Eclipse와 같은 IDE.
종속성 관리를 위한 Maven.

환경 설정 요구 사항

Maven 구성 – pom.xml에 GroupDocs.Viewer를 추가합니다.
라이선스 획득 – GroupDocs에서 임시 라이선스를 받습니다. GroupDocs Free Trial을 방문하거나 GroupDocs Temporary License Page에서 임시 라이선스를 신청하세요.

Java용 GroupDocs.Viewer 설정

Maven을 사용하여 Java 프로젝트에 GroupDocs.Viewer를 통합하려면 pom.xml을 업데이트하십시오:

<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>

기본 초기화 및 설정

Path YOUR_DOCUMENT_DIRECTORY = Path.of("YOUR_DOCUMENT_DIRECTORY");
Path YOUR_OUTPUT_DIRECTORY = Path.of("YOUR_OUTPUT_DIRECTORY");

// Format for page file paths
Path pageFilePathFormat = YOUR_OUTPUT_DIRECTORY.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

GroupDocs.Viewer를 사용하여 특정 PDF 페이지 회전하기

개요

특정 PDF 페이지를 회전하면 원본 파일을 변경하지 않고 문서 프레젠테이션을 세밀하게 제어할 수 있습니다.

단계 1: 페이지 회전 구성

// Rotate the first page by 90 degrees clockwise.
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

// Rotate the second page by 180 degrees.
viewOptions.rotatePage(2, Rotation.ON_180_DEGREE);

단계 2: Viewer 초기화 및 렌더링

Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SampleDocument.pdf"));

// Render the specified pages (1 and 2) using the configured options.
viewer.view(viewOptions, 1, 2);

// Always close the viewer to free resources.
viewer.close();

매개변수 및 구성

Rotation – rotatePage(pageNumber, Rotation.*) 회전 옵션은 ON_90_DEGREE, ON_180_DEGREE, ON_270_DEGREE입니다.
HtmlViewOptions – 레이아웃과 포함된 리소스를 유지하면서 PDF‑to‑HTML 변환을 처리합니다.
pdf to html java – 동일한 API의 일부이며 정확한 시각적 표현을 보장합니다.

특정 PDF 페이지를 회전하는 이유

문서 정렬 – 스캔된 계약서나 청구서의 올바른 방향을 맞춥니다.
프레젠테이션 조정 – PDF로 내보낸 슬라이드를 조정합니다.
아카이브 일관성 – 대량 디지털화 시 페이지 방향을 표준화합니다.

일반적인 문제 및 해결책 (pdf 회전 문제 해결)

잘못된 경로 – YOUR_DOCUMENT_DIRECTORY와 YOUR_OUTPUT_DIRECTORY가 존재하고 접근 가능한지 확인하십시오.
누락된 종속성 – Maven 좌표가 최신 GroupDocs.Viewer 버전과 일치하는지 확인하십시오.
라이선스 제한 – 임시 라이선스를 올바르게 적용하십시오; 그렇지 않으면 일부 기능이 비활성화될 수 있습니다.
메모리 급증 – 큰 PDF를 작은 배치로 렌더링하거나 JVM 힙 크기를 늘리십시오.

실용적인 적용 사례

실제 사용 사례

문서 정렬 – 스캔된 문서를 올바른 디지털 방향으로 회전합니다.
프레젠테이션 조정 – 공유하기 전에 PDF 내의 프레젠테이션 슬라이드를 수정합니다.
아카이브 워크플로우 – 디지털화 중에 역사적 문서의 방향을 자동으로 조정합니다.

통합 가능성

GroupDocs.Viewer를 Java 기반 콘텐츠 관리 시스템, 엔터프라이즈 포털 또는 PDF를 실시간으로 보기 위해 필요한 맞춤형 API와 결합하십시오.

성능 고려 사항

리소스 관리 – 파일 핸들과 메모리를 해제하기 위해 항상 Viewer 인스턴스를 닫으십시오.
Java 메모리 관리 – 대형 PDF를 처리할 때 힙 사용량을 모니터링하고 전체 파일을 로드하는 대신 페이지를 스트리밍하는 것을 고려하십시오.
모범 사례 – 자주 액세스하는 문서에 대해 렌더링된 HTML을 캐시하여 처리 시간을 줄이십시오.

결론

이 튜토리얼에서는 Maven 설정부터 회전된 페이지 렌더링 및 일반적인 문제 처리까지 Java에서 GroupDocs.Viewer를 사용하여 특정 PDF 페이지를 회전하는 방법을 다루었습니다. 워터마킹, 형식 변환 또는 배치 처리와 같은 추가 기능을 실험하여 문서 워크플로를 더욱 확장해 보세요.

다음 단계: PDF를 PNG로 변환하거나 워터마크를 추가하는 등 다른 GroupDocs.Viewer 기능을 탐색하거나 클라우드 스토리지 제공업체와 통합해 보세요.

FAQ 섹션

회전 문제 해결 – 페이지 번호와 회전 매개변수가 올바른지 확인하십시오.
대용량 PDF 파일 처리 – 페이지를 배치로 처리하고 메모리 사용량을 모니터링하십시오.
라이선스 요구 사항 – 개발에는 임시 라이선스를 사용하고, 프로덕션에는 정식 라이선스를 구매하십시오.
다중 페이지 회전 – 서로 다른 페이지 번호와 각도로 rotatePage를 반복 호출하십시오.
Java 라이브러리와 통합 – GroupDocs.Viewer는 Spring Boot, Jakarta EE 및 기타 Java 프레임워크와 원활하게 작동합니다.

자주 묻는 질문

Q: PDF의 모든 페이지를 한 번에 회전할 수 있나요?
A: 예. 페이지 번호를 순회하면서 각 페이지에 rotatePage(page, Rotation.ON_90_DEGREE)를 호출하면 됩니다.

Q: 회전이 원본 PDF 파일에 영향을 미치나요?
A: 아니요. 회전은 렌더링 과정에서만 적용되며, 원본 PDF는 변경되지 않습니다.

Q: PDF가 비밀번호로 보호된 경우는 어떻게 하나요?
A: Viewer 인스턴스를 생성할 때 비밀번호를 제공합니다: new Viewer(path, password).

Q: HtmlViewOptions 설정 시 “null pointer” 오류를 디버그하려면 어떻게 해야 하나요?
A: 출력 디렉터리가 존재하고 pageFilePathFormat이 올바르게 해석되는지 확인하십시오.

Q: 다른 형식(예: PNG)으로 변환할 때 페이지를 회전할 수 있는 방법이 있나요?
A: 예. 대상 형식에 맞는 뷰 옵션과 함께 동일한 rotatePage 구성을 사용하십시오.

리소스

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