Xoay trang 90 độ với GroupDocs Viewer cho Java

Khi bạn cần xoay trang 90 độ trong một tài liệu—cho dù đó là PDF, tệp Word, hay bảng tính—việc thực hiện bằng chương trình sẽ tiết kiệm thời gian và loại bỏ lỗi thủ công. Trong hướng dẫn nâng cao này, chúng tôi sẽ hướng dẫn chi tiết các bước để xoay trang đầu tiên của bất kỳ tài liệu hỗ trợ nào bằng GroupDocs Viewer cho Java. Khi hoàn thành, bạn sẽ có một đoạn mã có thể tái sử dụng và chèn vào dự án của mình.

Xoay trang đầu tiên của tài liệu bằng GroupDocs.Viewer cho Java

Câu trả lời nhanh

Ý nghĩa của “xoay trang 90 độ” là gì? Nó quay trang đã chọn theo chiều kim đồng hồ một phần tư vòng.
Thư viện nào thực hiện việc xoay? GroupDocs Viewer cho Java cung cấp phương thức rotatePage.
Tôi có thể xoay các trang PDF bằng Java không? Có—sử dụng cùng một lời gọi rotatePage; nó hoạt động với PDF, DOCX, XLSX và nhiều định dạng khác.
Có cần giấy phép không? Bản dùng thử miễn phí đủ cho phát triển; giấy phép trả phí cần thiết cho môi trường sản xuất.
Hoạt động này có tốn bộ nhớ không? Không, nếu bạn đóng nhanh đối tượng Viewer; xem các mẹo hiệu năng bên dưới.

“Xoay trang 90 độ” là gì?

Xoay một trang 90 độ thay đổi hướng của trang từ dọc sang ngang (hoặc ngược lại) mà không thay đổi nội dung bên trong. Điều này rất hữu ích cho các bài thuyết trình, in đồ họa chỉ có dạng ngang, hoặc chỉnh sửa tài liệu quét bị chụp lệch hướng.

Tại sao nên xoay trang bằng GroupDocs Viewer cho Java?

GroupDocs Viewer trừu tượng hoá các phức tạp khi xử lý hàng chục định dạng tệp. Nó cho phép bạn áp dụng các biến đổi ở mức trang—như xoay—trong khi giữ nguyên tệp gốc. API mượt mà, an toàn với đa luồng, và hoạt động trên bất kỳ môi trường Java 8+ nào.

Yêu cầu trước

GroupDocs.Viewer cho Java (phiên bản mới nhất)
JDK 8 hoặc mới hơn
Maven (hoặc Gradle) để quản lý phụ thuộc
Một IDE như IntelliJ IDEA hoặc Eclipse
Kiến thức cơ bản về Java I/O

Cài đặt GroupDocs.Viewer cho Java

Thêm kho lưu trữ và phụ thuộc GroupDocs vào pom.xml. Đoạn mã này không thay đổi so với hướng dẫn gốc:

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

Nhận giấy phép

Bản dùng thử miễn phí – tải xuống từ trang GroupDocs.
Giấy phép tạm thời – yêu cầu nếu bạn cần thời gian đánh giá kéo dài.
Giấy phép đầy đủ – mua để triển khai trong môi trường sản xuất.

Khởi tạo Viewer cơ bản

Đoạn mã sau cho thấy cách tạo một thể hiện Viewer tối thiểu. Giữ nguyên như đã hiển thị:

import com.groupdocs.viewer.Viewer;

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

Thực hiện từng bước: Xoay trang đầu tiên 90 độ

1. Nhập các gói cần thiết

Các import này cung cấp quyền truy cập vào tùy chọn render PDF và enum xoay.

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

2. Xác định vị trí đầu ra và tạo Viewer

Thay thế các đường dẫn placeholder bằng thư mục thực tế của bạn.

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. Cấu hình tùy chọn xem PDF và áp dụng việc xoay

Phương thức rotatePage nhận số trang (đánh số từ 1) và giá trị enum 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. Kết xuất tài liệu

Cuối cùng, gọi view để tạo PDF đã xoay.

viewer.view(viewOptions);

Cách hoạt động

PdfViewOptions cho Viewer biết sẽ xuất ra tệp PDF.
rotatePage(int, Rotation) chỉ xoay trang bạn chỉ định, các trang còn lại không bị ảnh hưởng.
Phương thức hỗ trợ ON_90_DEGREE, ON_180_DEGREE, và ON_270_DEGREE.

Các vấn đề thường gặp và giải pháp

Triệu chứng	Nguyên nhân có thể	Cách khắc phục
FileNotFoundException	Đường dẫn không đúng hoặc thư mục thiếu	Kiểm tra `YOUR_OUTPUT_DIRECTORY` và `YOUR_DOCUMENT_DIRECTORY` tồn tại và có thể đọc được.
Unsupported file format	Cố gắng xoay định dạng không được Viewer hỗ trợ	Kiểm tra trang [GroupDocs Viewer supported formats]
No rotation visible	Sử dụng số trang sai (đánh số từ 0)	Nhớ rằng `rotatePage` sử dụng chỉ mục 1‑based.
Out‑of‑memory errors on large docs	Kết xuất nhiều tệp lớn trong một luồng duy nhất	Xử lý tài liệu tuần tự hoặc sử dụng pool luồng với độ đồng thời giới hạn.

Ứng dụng thực tế

Điều chỉnh bài thuyết trình – Chuyển đổi slide dọc sang ngang ngay lập tức.
Sửa chữa tài liệu hàng loạt – Tự động sửa các PDF đã quét bị chụp lệch hướng.
Đầu ra sẵn sàng in – Đảm bảo đồ họa ngang in đúng trên giấy dọc.

Mẹo hiệu năng

Đóng tài nguyên kịp thời – Khối try‑with‑resources tự động giải phóng Viewer.
Xử lý hàng loạt – Khi xử lý nhiều tệp, tái sử dụng một thể hiện Viewer duy nhất cho mỗi luồng để giảm chi phí.
Giám sát bộ nhớ – Đối với tài liệu lớn hơn 100 MB, cân nhắc truyền luồng đầu ra ra đĩa thay vì giữ trong bộ nhớ.

Câu hỏi thường gặp

Q: Tôi có thể xoay nhiều trang cùng lúc không?
A: Có—gọi rotatePage() cho mỗi số trang cần xoay.

Q: Có cách nào để hoàn tác việc xoay sau khi kết xuất không?
A: Không trực tiếp. Bạn cần kết xuất lại tài liệu mà không áp dụng tùy chọn xoay.

Q: Định dạng tệp nào hỗ trợ xoay trang trong GroupDocs Viewer?
A: DOCX, PDF, PPTX, XLSX và nhiều định dạng khác được liệt kê trong tài liệu chính thức.

Q: Làm sao để xoay trang trong một loạt tài liệu một cách tự động?
A: Đặt đoạn mã trong vòng lặp duyệt qua một tập hợp các đường dẫn tệp, áp dụng logic rotatePage giống nhau cho mỗi tệp.

Q: Thực hành tốt nhất để xử lý lỗi khi xoay trang là gì?
A: Bao quanh việc sử dụng Viewer bằng khối try‑catch, ghi log ngoại lệ và tùy chọn tiếp tục xử lý tệp tiếp theo.

Tài nguyên

Tài liệu: GroupDocs Viewer Java Documentation
Tham chiếu API: GroupDocs API Reference
Tải xuống: Get GroupDocs Viewer for Java
Mua: Buy a License
Dùng thử miễn phí: Try Free
Giấy phép tạm thời: Request Temporary License
Hỗ trợ: GroupDocs Forum

Cập nhật lần cuối: 2026-01-18
Kiểm tra với: GroupDocs Viewer 25.2 cho Java
Tác giả: GroupDocs