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