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文档的功能，更多示例可以点击了解：

https://www.e-iceblue.cn/spirepdfjava/spire-pdf-for-java-program-guide-content.html