GroupDocs Viewer for Java를 사용하여 페이지를 90도 회전하기

문서에서 페이지를 90도 회전해야 할 때—PDF, Word 파일, 스프레드시트 여부와 관계없이—프로그래밍 방식으로 수행하면 시간을 절약하고 수동 오류를 없앨 수 있습니다. 이 고급 가이드에서는 GroupDocs Viewer for Java를 사용하여 지원되는 모든 문서의 첫 페이지를 회전하는 정확한 단계들을 안내합니다. 끝까지 읽으면 자체 프로젝트에 삽입할 수 있는 재사용 가능한 코드 스니펫을 얻게 됩니다.

GroupDocs.Viewer for Java를 사용하여 문서의 첫 페이지 회전

빠른 답변

“rotate page 90 degrees”가 의미하는 것은? 선택한 페이지를 시계 방향으로 90도(한 사분면) 회전합니다.
어떤 라이브러리가 회전을 처리합니까? GroupDocs Viewer for Java는 rotatePage 메서드를 제공합니다.
Java로 PDF 페이지를 회전할 수 있나요? 예—동일한 rotatePage 호출을 사용하면 PDF, DOCX, XLSX 등에서도 작동합니다.
라이선스가 필요합니까? 무료 체험판은 개발에 사용할 수 있으며, 프로덕션에서는 유료 라이선스가 필요합니다.
이 작업이 메모리를 많이 사용하나요? Viewer 인스턴스를 즉시 닫으면 메모리 사용이 크게 늘어나지 않습니다; 아래 성능 팁을 참고하세요.

“rotate page 90 degrees”란 무엇인가요?

페이지를 90도 회전하면 페이지가 세로 방향에서 가로 방향(또는 그 반대)으로 재배치되며, 기본 콘텐츠는 변경되지 않습니다. 이는 프레젠테이션, 가로 전용 그래픽 인쇄, 혹은 가로로 스캔된 문서를 바로잡을 때 특히 유용합니다.

왜 GroupDocs Viewer for Java로 페이지를 회전해야 할까요?

GroupDocs Viewer는 수십 가지 파일 형식을 처리하는 복잡성을 추상화합니다. 페이지 수준의 변환(예: 회전)을 적용하면서 원본 파일을 그대로 유지할 수 있습니다. API는 유창하고 스레드 안전하며, Java 8+ 런타임에서 작동합니다.

사전 요구 사항

GroupDocs.Viewer for Java (최신 버전)
JDK 8 이상
Maven (또는 Gradle) 의존성 관리용
IntelliJ IDEA 또는 Eclipse와 같은 IDE
Java I/O에 대한 기본 지식

GroupDocs.Viewer for Java 설정

pom.xml에 GroupDocs 저장소와 의존성을 추가합니다. 이 스니펫은 원본 튜토리얼과 동일합니다:

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

라이선스 획득

Free trial – GroupDocs 사이트에서 다운로드합니다.
Temporary license – 평가 기간을 연장하려면 요청합니다.
Full license – 프로덕션 배포를 위해 구매합니다.

기본 Viewer 초기화

다음 코드는 Viewer 인스턴스를 생성하는 최소 방법을 보여줍니다. 그대로 유지하십시오:

import com.groupdocs.viewer.Viewer;

// Initialize Viewer with your document path
try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    // Perform operations...
}

단계별 구현: 첫 페이지를 90도 회전하기

1. 필요한 패키지 가져오기

이 임포트는 PDF 렌더링 옵션과 회전 열거형에 접근할 수 있게 합니다.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.Rotation;

2. 출력 위치 정의 및 Viewer 생성

플레이스홀더 경로를 실제 디렉터리 경로로 교체하십시오.

import java.nio.file.Path;

public class RotateSpecificPage {
    public static void run() {
        Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RotateSpecificPage");
        Path outputFilePath = outputDirectory.resolve("output.pdf");

        try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("Sample.docx"))) {
            // Proceed with the rotation steps below...
        }
    }
}

3. PDF 보기 옵션 구성 및 회전 적용

rotatePage 메서드는 페이지 번호(1부터 시작)와 Rotation 열거형 값을 받습니다.

PdfViewOptions viewOptions = new PdfViewOptions(outputFilePath);

// Specify which page to rotate (1 for first page) and the rotation angle
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

4. 문서 렌더링

마지막으로 view를 호출하여 회전된 PDF를 생성합니다.

viewer.view(viewOptions);

작동 방식

PdfViewOptions는 Viewer에게 PDF 파일을 출력하도록 지시합니다.
**rotatePage(int, Rotation)**은 지정한 페이지만 회전시키고 나머지는 그대로 둡니다.
이 메서드는 ON_90_DEGREE, ON_180_DEGREE, ON_270_DEGREE를 지원합니다.

일반적인 문제와 해결책

증상	가능한 원인	해결 방법
FileNotFoundException	잘못된 경로나 폴더가 없음	`YOUR_OUTPUT_DIRECTORY`와 `YOUR_DOCUMENT_DIRECTORY`가 존재하고 읽을 수 있는지 확인하십시오.
Unsupported file format	Viewer에서 지원하지 않는 형식을 회전하려고 함	[GroupDocs Viewer supported formats] 페이지를 확인하십시오.
No rotation visible	잘못된 페이지 번호 사용(0 기반)	`rotatePage`는 1 기반 인덱싱을 사용한다는 점을 기억하십시오.
Out‑of‑memory errors on large docs	단일 스레드에서 많은 대용량 파일을 렌더링	문서를 순차적으로 처리하거나 제한된 동시성을 가진 스레드 풀을 사용하십시오.

실용적인 적용 사례

프레젠테이션 조정 – 세로 슬라이드를 실시간으로 가로로 변환합니다.
대량 문서 교정 – 가로로 스캔된 PDF를 자동으로 수정합니다.
인쇄 준비 출력 – 가로 그래픽이 세로 용지에 올바르게 인쇄되도록 보장합니다.

성능 팁

Close resources promptly – try‑with‑resources 블록은 Viewer를 자동으로 해제합니다.
Batch processing – 많은 파일을 처리할 때는 스레드당 하나의 Viewer 인스턴스를 재사용하여 오버헤드를 줄입니다.
Monitor memory – 100 MB보다 큰 문서의 경우, 메모리에 보관하기보다 디스크로 스트리밍하는 것을 고려하십시오.

자주 묻는 질문

Q: 여러 페이지를 한 번에 회전할 수 있나요?
A: 예—회전이 필요한 각 페이지 번호에 대해 rotatePage()를 호출하면 됩니다.

Q: 렌더링 후 회전을 되돌릴 방법이 있나요?
A: 직접적인 방법은 없습니다. 회전 옵션 없이 문서를 다시 렌더링해야 합니다.

Q: GroupDocs Viewer에서 페이지 회전을 지원하는 파일 형식은 무엇인가요?
A: DOCX, PDF, PPTX, XLSX 및 공식 문서에 나열된 기타 많은 형식이 지원됩니다.

Q: 여러 문서 배치를 자동으로 회전하려면 어떻게 해야 하나요?
A: 파일 경로 컬렉션을 순회하는 루프에 코드를 감싸고, 각 파일에 동일한 rotatePage 로직을 적용하십시오.

Q: 회전 중 오류를 처리하기 위한 모범 사례는 무엇인가요?
A: Viewer 사용을 try‑catch 블록으로 감싸고, 예외를 로그에 기록한 뒤 필요에 따라 다음 파일 처리를 계속하십시오.

리소스

Documentation: GroupDocs Viewer Java 문서
API Reference: GroupDocs API 레퍼런스
Download: GroupDocs Viewer for Java 다운로드
Purchase: 라이선스 구매
Free Trial: 무료 체험
Temporary License: 임시 라이선스 요청
Support: GroupDocs 포럼

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