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

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

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

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

배우게 될 내용

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

빠른 답변

  • Java에서 PDF 페이지를 회전할 수 있는 라이브러리는 무엇인가요? GroupDocs.Viewer for Java는 외부 도구 없이 내장 회전 지원을 제공합니다.
  • 단일 페이지를 90도 회전할 수 있나요? 예 – 뷰어 인스턴스에서 rotatePage(pageNumber, Rotation.ON_90_DEGREE)를 호출하면 됩니다.
  • 개발에 라이선스가 필요합니까? 평가용 임시 라이선스는 무료이며, 프로덕션에는 정식 라이선스가 필요합니다.
  • Maven이 필수인가요? Maven은 권장되는 의존성 관리 도구이지만, Gradle나 수동 JAR 포함도 사용할 수 있습니다.
  • 회전된 페이지를 어떻게 렌더링하나요? HtmlViewOptions와 viewer.view(documentPath, viewOptions)를 사용하여 회전이 반영된 HTML 출력을 얻을 수 있습니다.

특정 PDF 페이지 회전이란?

rotate specific pdf pages는 PDF 문서 내 개별 페이지의 방향을 변경하면서 나머지 파일은 그대로 두는 기능을 의미합니다. 이 작업은 렌더링 시에 수행되므로 원본 PDF 파일은 변경되지 않습니다.

왜 특정 PDF 페이지를 회전해야 할까요?

일반적인 서버급 VM에서 단일 페이지를 0.05초 미만으로 회전할 수 있어, 스캔된 계약서, 프레젠테이션 자료, 방향이 잘못된 스캔이 포함된 다중 페이지 청구서 등을 실시간으로 미리볼 수 있습니다. 이러한 세밀한 제어는 비용이 많이 드는 후처리 도구의 필요성을 없애고 대규모 디지털화 프로젝트에서 수작업을 최대 70 %까지 줄여줍니다.

전제 조건

필요 라이브러리 및 종속성

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

환경 설정 요구 사항

  1. Maven 구성 – pom.xml에 GroupDocs.Viewer를 추가합니다.
  2. 라이선스 획득 – GroupDocs에서 임시 라이선스를 받습니다. GroupDocs 무료 체험을 방문하거나 GroupDocs 임시 라이선스 페이지에서 신청하세요.

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>

기본 초기화 및 설정

Viewer는 문서를 로드하고 렌더링 작업을 조정하는 핵심 클래스입니다. 인스턴스를 만든 후 view 또는 rotatePage와 같은 메서드를 호출할 수 있습니다.

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 페이지 회전하기

GroupDocs.Viewer를 사용하여 특정 PDF 페이지를 회전하려면 두 가지 주요 작업이 필요합니다: 첫째, rotatePage 메서드를 사용해 각 대상 페이지에 원하는 회전을 지정하고, 둘째, HtmlViewOptions로 문서를 렌더링하여 회전이 출력에 반영되도록 합니다. 이 방법은 원본 PDF를 변경하지 않으면서 올바른 방향의 HTML을 제공합니다.

단계 1: 페이지 회전 구성

rotatePage는 0부터 시작하는 페이지 인덱스와 Rotation 열거형 값을 받는 메서드입니다. 열거형은 ON_90_DEGREE, ON_180_DEGREE, ON_270_DEGREE 세 가지 옵션을 제공합니다.

// 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: 뷰어 초기화 및 렌더링

HtmlViewOptions는 PDF를 HTML로 변환하는 과정을 제어합니다. 레이아웃, 폰트 및 임베디드 리소스를 보존하면서 구성한 회전을 적용합니다.

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 회전 문제 해결)

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

실용적인 적용 사례

실제 사용 사례

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

통합 가능성

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

성능 고려 사항

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

결론

이 튜토리얼에서는 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-10-05
테스트 환경: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs

관련 튜토리얼