Java 在PDF中插入页眉、页脚

在处理PDF文档时，有时需要为文档中的每一页添加页眉和页脚，以包含一些有用的信息，如文档标题、章节名称、日期、页码等。对于需要自动化处理的场景，或者需要在大量文档中添加一致的页眉和页脚，可以通过编程的方式来实现。本文将介绍如何使用Java为PDF文件添加页眉、页脚。

所需工具：Free Spire.PDF for Java 免费库。可以点击链接下载最新版本并手动添加引用到你的Java项目中，同时也支持通过Mave仓库安装。

方法简介：

在以下示例中，我们用到了 PdfCanvas 类的DrawString()、DrawImage() 和 DrawLine() 方法，分别用于在PDF页面上指定位置绘制文本、图片和线条。

如果要添加动态的信息如页码、页数、章节编号等，则可以使用Free Spire.PDF for Java提供的PdfPageNumberField、PdfPageCountField 和 PdfSectionNumberField 类，然后再使用Draw() 方法将其绘制到PDF页眉或页脚位置。

1. 使用Java在PDF中插入页眉

import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;
import com.spire.pdf.graphics.*;

import java.awt.*;

public class PDFHeader {

    public static void main(String[] args) {

        //加载PDF文档
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("考核.pdf");

        //加载图片
        PdfImage headerImage = PdfImage.fromFile("logo.jpg");

        //获取图片宽度
        float width = headerImage.getWidth();
        PdfUnitConvertor unitCvtr = new PdfUnitConvertor();
        float pointWidth = unitCvtr.convertUnits(width, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point);

        //指定页眉文本
        String headerText = "年度绩效考核\nAAA有限责任公司";

        //创建字体
        PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("宋体", Font.BOLD, 12),true);

        //创建画笔
        PdfBrush brush = PdfBrushes.getRed();
        PdfPen pen = new PdfPen(PdfBrushes.getBlack(), 1.0f);

        //遍历所有PDF页面
        for (int i = 0; i < pdf.getPages().getCount(); i++)
        {
            //获取指定页面
            PdfPageBase page = pdf.getPages().get(i);

            //在顶部空白区域绘制图像
            page.getCanvas().drawImage(headerImage, page.getActualSize().getWidth() - pointWidth - 55, 20);

            //在顶部空白区域绘制文本
            page.getCanvas().drawString(headerText, font, brush, 55, 30);

            //在顶部空白区域绘制一条线
            page.getCanvas().drawLine(pen, new Point(55, 70), new Point((int)page.getActualSize().getWidth() - 55, 70));

        }

        //保存生成PDF文件
        pdf.saveToFile("PDF页眉.pdf");
        pdf.dispose();
    }
}

以上代码遍历了PDF文档的所有页面，并在每一页的页眉位置添加了文本、图片和分隔线，运行后效果图如下：

2. 使用Java在PDF中插入页脚

import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;
import com.spire.pdf.automaticfields.PdfCompositeField;
import com.spire.pdf.automaticfields.PdfPageCountField;
import com.spire.pdf.automaticfields.PdfPageNumberField;
import com.spire.pdf.graphics.*;

import java.awt.*;
import java.awt.geom.Dimension2D;
import java.awt.geom.Point2D;

public class PDFFooter {

    public static void main(String[] args) {

        //加载PDF文档
        PdfDocument pdf = new PdfDocument();
        pdf.loadFromFile("考核.pdf");

        //创建字体
        PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("宋体", Font.BOLD, 12),true);

        //创建画笔
        PdfBrush brush = PdfBrushes.getBlack();
        PdfPen pen = new PdfPen(PdfBrushes.getBlack(), 1.0f);

        //创建页码字段
        PdfPageNumberField pageNumberField = new PdfPageNumberField();

        //创建页数字段
        PdfPageCountField pageCountField = new PdfPageCountField();

        //创建一个复合字段，将页数字段和页码字段合并为一个字符串
        PdfCompositeField compositeField = new PdfCompositeField(font, brush, "第{0}页/共{1}页", pageNumberField, pageCountField);

        //获取文本尺寸
        Dimension2D fontSize = font.measureString(compositeField.getText());

        //获取页面尺寸
        Dimension2D pageSize = pdf.getPages().get(0).getSize();

        //设置复合字段的位置
        compositeField.setLocation(new Point2D.Double((pageSize.getWidth() - fontSize.getWidth())/2,  pageSize.getHeight() - 45));

        //遍历PDF页面
        for (int i = 0; i < pdf.getPages().getCount(); i++)
        {
            //获取指定页
            PdfPageBase page = pdf.getPages().get(i);

            //在底部空白区域绘制一条线
            page.getCanvas().drawLine(pen, new Point(72, (int) (pageSize.getHeight() - 60)), new Point((int)pageSize.getWidth() - 72, (int) pageSize.getHeight()- 60));

            //在底部空白区域绘制复合字段
            compositeField.draw(page.getCanvas());
        }

        //保存生成PDF文件
        pdf.saveToFile("PDF页脚.pdf");
        pdf.dispose();
    }
}

以上代码遍历了PDF文档的所有页面，并在每一页的页脚位置添加了对应的页码、页数信息以及一条分隔线，运行后效果图如下：

小结：

在不破坏PDF文档布局的情况下，我们可以使用Free Spire.PDF for Java免费库将所需的元素绘制到PDF页面顶部和底部的指定位置来生成自定义页眉页脚，提高PDF文档的可读性和专业性。

此外，Free Spire.PDF for Java免费库还支持其他一些操作PDF文档的功能，更多示例可以点击了解：

Spire.PDF for Java 中文教程Spire.PDF for Java 是一款专门对 PDF 文档进行操作的 Java 类库。该类库的主要功能在于帮助开发人员在 Java 应用程序（J2SE 和 J2EE）中生成 PDF 文档和操作现有 PDF 文档，并且运行环境无需安装 Adobe Acrobat。同时兼容大部分国产操作系统，能够...https://www.e-iceblue.cn/spirepdfjava/spire-pdf-for-java-program-guide-content.html