使用 Java 获取 PDF 页面信息（页数、尺寸、旋转角度、方向、标签与边框）

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>

<dependency>
    <groupId>e-iceblue</groupId>
    <artifactId>spire.pdf</artifactId>
    <version>11.7.0</version>
</dependency>

2. 非Maven 项目

对于非 Maven 项目，你可以前往官网下载 jar 包并手动导入项目。

二、获取 PDF 页数

了解 PDF 的总页数是处理文档的第一步，它可以帮助我们执行分页提取、范围打印或页面遍历等操作。

实现步骤：

创建 PdfDocument 对象；
使用 PdfDocument.loadFromFile() 方法打开 PDF 文档；
调用 PdfDocument.getPages().getCount() 获取页数。

示例代码：

java 复制代码

import com.spire.pdf.*;

public class GetPageCount {
public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("测试.pdf");

        int pageCount = pdf.getPages().getCount();
        System.out.println("该 PDF 共 " + pageCount + " 页。");

        pdf.close();
    }
}

三、获取页面尺寸（宽高）

页面的尺寸决定了内容的排版范围，不同的 PDF 页面可能采用不同的纸张标准，如 A4、Letter 或自定义大小。

实现步骤：

打开 PDF 文档；
使用PdfDocument.getPages().get()方法获取指定页面（通过索引）；
调用 PdfPageBase.getSize().getWidth() 和 PdfPageBase.getSize().getHeight() 方法获取宽高信息；
输出尺寸数据。

示例代码：

java 复制代码

import com.spire.pdf.*;

public class GetPageSize {
    public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("测试.pdf");

        PdfPageBase page = pdf.getPages().get(0); // 获取第一页
        double width = page.getSize().getWidth();
        double height = page.getSize().getHeight();

        System.out.printf("第一页尺寸为：%.2f x %.2f pt%n", width, height);

        pdf.close();
    }
}

注意，页面尺寸默认单位为 pt（磅），1 英寸 = 72 磅。如果你需要将尺寸转换为英寸、像素、厘米或毫米进行打印适配或前端渲染，可以使用 PdfUnitConvertor 类进行单位转换：

java 复制代码

float pointValue = 595.0f; // 示例：A4 宽度为 595 pt

PdfUnitConvertor converter = new PdfUnitConvertor();

float inch = converter.convertUnits(pointValue, PdfGraphicsUnit.Point, PdfGraphicsUnit.Inch);
float pixel = converter.convertUnits(pointValue, PdfGraphicsUnit.Point, PdfGraphicsUnit.Pixel);
float mm = converter.convertUnits(pointValue, PdfGraphicsUnit.Point, PdfGraphicsUnit.Millimeter);
float cm = converter.convertUnits(pointValue, PdfGraphicsUnit.Point, PdfGraphicsUnit.Centimeter);

System.out.printf("595 pt 对应：%.2f 英寸，%.2f 像素，%.2f 毫米，%.2f 厘米%n", inch, pixel, mm, cm);

四、获取页面旋转角度

页面旋转信息可以帮助我们判断是否需要在程序中进行角度还原或页面调整，避免内容呈现异常。

实现步骤：

打开 PDF 文档；
获取目标页面；
使用 PdfPageBase.getRotation().getValue() 方法获取旋转角度；
输出角度信息。

示例代码：

java 复制代码

import com.spire.pdf.*;

public class GetPageRotation {
    public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("测试.pdf");

        PdfPageBase page = pdf.getPages().get(0);
        int rotation = page.getRotation().getValue();

        System.out.println("第一页旋转角度为：" + rotation + "°");

        pdf.close();
    }
}

五、判断页面方向（横向 / 纵向）

PDF 页面可分为 Portrait（纵向）和 Landscape（横向），不同方向适用于不同类型的内容展示（如文字或表格）。

实现步骤：

打开 PDF 文档；
获取目标页面；
调用 PdfPageBase.getSize().getWidth() 和 PdfPageBase.getSize().getHeight() 方法获取页面的宽高信息；
比较宽度与高度。若宽度 > 高度，则为横向，否则为纵向；
输出页面方向信息。

示例代码：

java 复制代码

import com.spire.pdf.*;

public class GetPageOrientation {
    public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("测试.pdf");

        PdfPageBase page = pdf.getPages().get(0);
        double width = page.getSize().getWidth();
        double height = page.getSize().getHeight();

        String orientation = width > height ? "横向" : "纵向";
        System.out.println("第一页页面方向为：" + orientation);

        pdf.close();
    }
}

六、获取页面标签

PDF 页面标签（Page Label）可用于自定义页码（如 i, ii, iii, A-1, A-2），对于章节分隔、目录定位等功能尤为常见。

实现步骤：

打开 PDF 文档并获取目标页面；
使用 PdfPageBase.getPageLabel() 方法获取目标页的标签文字；
判断标签文字是否存在。若存在，输出标签信息，否则输出"无标签"。

示例代码：

java 复制代码

import com.spire.pdf.*;

public class GetPageLabel {
    public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("示例.pdf");

        PdfPageBase page = pdf.getPages().get(0);

        String label = page.getPageLabel();
        String labelText = (label != null && !label.trim().isEmpty()) ? label : "无标签";

        System.out.println("第一页页面标签为：" + labelText);

        pdf.close();
    }
}

七、获取页面边框信息

PDF 页面所定义的边框不仅用于限制内容的显示范围，还涵盖多个与印刷和裁切相关的区域。这些边框各自承担不同的功能，例如用于标识纸张尺寸、设置可视区域、预留出血位置以及定义裁切和内容区域等。下图展示了这些边框在页面中的分布情况：

PDF 页面各类边框说明

边框类型	说明
MediaBox	页面介质框，表示纸张的实际物理尺寸范围
CropBox	裁剪框，定义最终用于显示或打印的区域
BleedBox	出血框，用于印刷时预留的出血区域
TrimBox	成品框，表示裁剪后的页面成品大小
ArtBox	作品框，限定页面中有效的内容区域

实现步骤：

打开PDF文档并获取目标页面；
分别使用PdfPageBase类的 getMediaBox()、getCropBox()、getBleedBox()、getTrimBox()、getArtBox() 方法获取各个对应的边框信息；
分别使用 Rectangle2D类的getWidth()、getHeight()、getX()、getY() 方法读取每个边框的宽度、高度、以及X和Y坐标等属性值，输出结果。

示例代码：

java 复制代码

import com.spire.pdf.*;
import java.awt.geom.Rectangle2D;

public class GetPageBoxes {
    public static void main(String[] args) {
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("测试.pdf");

        PdfPageBase page = pdf.getPages().get(0);

        Rectangle2D mediaBox = page.getMediaBox();
        Rectangle2D cropBox = page.getCropBox();
        Rectangle2D bleedBox = page.getBleedBox();
        Rectangle2D trimBox = page.getTrimBox();
        Rectangle2D artBox = page.getArtBox();

        System.out.printf("MediaBox: 宽 %.2f, 高 %.2f, X %.2f, Y %.2f%n",
                mediaBox.getWidth(), mediaBox.getHeight(), mediaBox.getX(), mediaBox.getY());
        System.out.printf("CropBox: 宽 %.2f, 高 %.2f, X %.2f, Y %.2f%n",
                cropBox.getWidth(), cropBox.getHeight(), cropBox.getX(), cropBox.getY());
        System.out.printf("BleedBox: 宽 %.2f, 高 %.2f, X %.2f, Y %.2f%n",
                bleedBox.getWidth(), bleedBox.getHeight(), bleedBox.getX(), bleedBox.getY());
        System.out.printf("TrimBox: 宽 %.2f, 高 %.2f, X %.2f, Y %.2f%n",
                trimBox.getWidth(), trimBox.getHeight(), trimBox.getX(), trimBox.getY());
        System.out.printf("ArtBox: 宽 %.2f, 高 %.2f, X %.2f, Y %.2f%n",
                artBox.getWidth(), artBox.getHeight(), artBox.getX(), artBox.getY());

        pdf.close();
    }
}

八、总结

本文详细介绍了如何通过 Java 语言结合 Spire.PDF for Java 库获取 PDF 文档中各页面的重要属性信息，包括页数、页面尺寸、旋转角度、页面方向、页面标签以及边框区域等。

如果你有提取表格、添加签名、水印或压缩文件等更复杂的处理需求，也可以使用 Spire.PDF for Java 提供的相关接口。具体使用方法可参考官方文档中的详细说明。

以上就是使用Java 获取 PDF 页面信息的所有内容。感谢阅读！

本文完结。