在处理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中插入页眉
java
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中插入页脚
java
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