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文档的可读性和专业性。