在处理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
)
)
