在 PDF 文檔中添加頁(yè)眉和頁(yè)腳有助于保持一致的版式和專業(yè)的外觀。頁(yè)眉通常位于頁(yè)面頂部，可顯示文檔標(biāo)題、作者姓名或公司名稱，而頁(yè)腳位于頁(yè)面底部，常用于添加頁(yè)碼、日期或法律聲明。這些元素對(duì)于報(bào)告、合同和正式文件至關(guān)重要，不僅提升了可讀性，還符合規(guī)范要求。本文將介紹如何使用 Spire.PDF for Java，通過(guò) Java 在現(xiàn)有的 PDF 文檔中添加頁(yè)眉和頁(yè)腳，并提供詳細(xì)的步驟和代碼示例。

• Java 在現(xiàn)有 PDF 文檔中添加頁(yè)眉
• Java 在現(xiàn)有 PDF 文檔中添加頁(yè)腳

安裝 Spire.PDF for Java

首先，您需要在 Java 程序中添加 Spire.Pdf.jar 文件作為依賴項(xiàng)。JAR 文件可以從此鏈接下載。如果您使用 ，則可以將以下代碼添加到項(xiàng)目的 pom.xml 文件中，從而在應(yīng)用程序中導(dǎo)入 JAR 文件。

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>//repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.pdf</artifactId>
        <version>11.2.3</version>
    </dependency>
</dependencies>

背景知識(shí)

 在使用 Spire.PDF for Java 處理現(xiàn)有的 PDF 文檔時(shí)，需要了解其坐標(biāo)系的原點(diǎn)位于頁(yè)面左上角，X 軸向右延伸，Y 軸向下延伸。向頁(yè)面添加頁(yè)眉是指在頁(yè)面上方的空白區(qū)域內(nèi)插入內(nèi)容，如文本、圖片、自動(dòng)字段和形狀等；而添加頁(yè)腳實(shí)際上就是在頁(yè)面底部的空白區(qū)域插入內(nèi)容。

如果空白區(qū)域不足以容納您要添加的內(nèi)容，您可以考慮增大 PDF 頁(yè)邊距。

Java 在現(xiàn)有 PDF 文檔中添加頁(yè)眉

Spire.PDF for Java 幫助用戶通過(guò) PdfCanvas.drawString()、PdfCanvas.drawImage() 和 PdfCanvas.drawLine() 等方法在 PDF 文檔的頁(yè)面上繪制文本、圖像和形狀。為了在頁(yè)眉中添加頁(yè)碼、章節(jié)、日期等動(dòng)態(tài)信息，您需要使用自動(dòng)字段。Spire.PDF for Java 提供了 PdfPageNumberField 類、PdfSectionNumberField 類和 PdfCreationDateField 類等來(lái)實(shí)現(xiàn)這些數(shù)據(jù)的動(dòng)態(tài)添加。

下面是使用 Spire.PDF for Java 向 PDF 文檔添加包含文本、圖像、日期和線條的頁(yè)眉的詳細(xì)步驟：

• 創(chuàng)建一個(gè) PdfDocument 對(duì)象。
• 通過(guò) PdfDocument.loadFromFile() 方法加載 PDF 文檔。
• 創(chuàng)建字體、畫筆和畫刷對(duì)象，用于繪制文本或形狀。
• 使用 PdfPageBase.getCanvas().drawString() 方法在頁(yè)面上方的空白區(qū)域繪制文本。
• 利用 PdfPageBase.getCanvas().drawLine() 方法在頁(yè)面上方的空白區(qū)域繪制一條線。
• 通過(guò) PdfImage.fromFile() 方法加載圖片。
• 使用 PdfPageBase.getCanvas().drawImage() 方法將圖片繪制到頁(yè)面上方的空白區(qū)域。
• 創(chuàng)建一個(gè) PdfCreationDateField 對(duì)象，用以反映文檔的創(chuàng)建時(shí)間。
• 使用 PdfCreationDateField.draw() 方法將文檔的創(chuàng)建時(shí)間繪制到頁(yè)面上方的空白區(qū)域。
• 通過(guò) PdfDocument.saveToFile() 方法將文檔保存為新的 PDF 文件。

import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;
import com.spire.pdf.automaticfields.PdfCompositeField;
import com.spire.pdf.automaticfields.PdfCreationDateField;
import com.spire.pdf.graphics.*;

import java.awt.*;

public class AddHeaderToPdf {
   public static void main(String[] args) {


       // 創(chuàng)建一個(gè) PdfDocument 對(duì)象
       PdfDocument doc = new PdfDocument();

       // 加載 PDF 文件
       doc.loadFromFile("/示例.pdf");

       // 加載添加到頁(yè)眉的圖像
       PdfImage headerImage = PdfImage.fromFile("/Logo1.png");

       // 獲取圖像的像素寬度
       float width = headerImage.getWidth();

       // 將像素轉(zhuǎn)換為點(diǎn)
       PdfUnitConvertor unitCvtr = new PdfUnitConvertor();
       float pointWidth = unitCvtr.convertUnits(width, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point);

       // 自定義頁(yè)眉文本
       String headerText = "冰藍(lán)科技\nwww.e-iceblue.cn";

       // 創(chuàng)建字體
       PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("DengXian", Font.BOLD, 12),true);

       // 創(chuàng)建筆刷
       PdfBrush brush = PdfBrushes.getPurple();

       // 創(chuàng)建畫筆
       PdfPen pen = new PdfPen(brush, 1.0f);

       // 創(chuàng)建文檔創(chuàng)建日期字段
       PdfCreationDateField creationDateField = new PdfCreationDateField(font, brush);
       creationDateField.setDateFormatString("yyyy-MM-dd");

       // 創(chuàng)建組合字段用以顯示文本和日期
       PdfCompositeField compositeField = new PdfCompositeField(font, brush, "創(chuàng)建時(shí)間: {0}", creationDateField);
       compositeField.setLocation(new Point(55, 58));

       // 遍歷文檔中的頁(yè)面
       for (int i = 0; i < doc.getPages().getCount(); i++)
       {
           // 獲取當(dāng)前頁(yè)面
           PdfPageBase page = doc.getPages().get(i);

           // 將圖像繪制到頁(yè)面上方空白區(qū)域
           page.getCanvas().drawImage(headerImage, page.getActualSize().getWidth() - pointWidth - 55, 20);

           // 繪制文本
           page.getCanvas().drawString(headerText, font, brush, 55, 33);

           // 繪制線條
           page.getCanvas().drawLine(pen, new Point(55, 73), new Point((int)page.getActualSize().getWidth() - 55, 70));

           // 將組合字段繪制到頁(yè)眉區(qū)域
           compositeField.draw(page.getCanvas());
       }

       // 保存修改后的文檔
       doc.saveToFile("/添加頁(yè)眉.pdf");
       doc.dispose();
   }
}

Java 在現(xiàn)有 PDF 文檔中添加頁(yè)腳

同樣的，PdfCanvas.drawString()、PdfCanvas.drawImage() 和 PdfCanvas.drawLine() 方法也可以用來(lái)在 PDF 文檔中添加頁(yè)腳。通過(guò)調(diào)整 X 軸和 Y 軸坐標(biāo)，你可以在 PDF 頁(yè)面上的任何位置繪制想要添加的信息。如果需要在頁(yè)腳添加動(dòng)態(tài)數(shù)據(jù)，如頁(yè)碼、章節(jié)號(hào)、日期等，可以使用由 Spire.PDF for Java 提供的 PdfPageNumberField、PdfPageCountField、PdfSectionNumberField 等類，以實(shí)現(xiàn)動(dòng)態(tài)信息的自動(dòng)添加。

以下是使用 Spire.PDF for Java 在 PDF 文檔中添加包含圖像和頁(yè)碼的頁(yè)腳的具體流程：

• 創(chuàng)建一個(gè) PdfDocument 對(duì)象。
• 通過(guò) PdfDocument.loadFromFile() 方法加載一個(gè) PDF 文檔。
• 使用 PdfImage.fromFile() 方法加載圖像。
• 利用 PdfPageBase.getCanvas().drawImage() 方法在頁(yè)面底部的空白區(qū)域繪制圖像。
• 創(chuàng)建 PdfPageNumberField 和 PdfPageCountField 對(duì)象，并將它們組合到 PdfCompositeField 對(duì)象中，以返回“第 {0} 頁(yè)，共 {1} 頁(yè)”格式的頁(yè)碼字符串。
• 使用 PdfCompositeField.draw() 方法在頁(yè)面底部空白區(qū)域繪制頁(yè)碼。
• 使用 PdfDocument.saveToFile() 方法將文檔保存為新的 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.PdfBrush;
import com.spire.pdf.graphics.PdfBrushes;
import com.spire.pdf.graphics.PdfImage;
import com.spire.pdf.graphics.PdfTrueTypeFont;

import java.awt.*;
import java.awt.geom.Dimension2D;
import java.awt.geom.Point2D;

public class AddFooterToPdf {
   public static void main(String[] args) {
       // 創(chuàng)建一個(gè) PdfDocument 對(duì)象
       PdfDocument doc = new PdfDocument();

       // 加載 PDF 文件
       doc.loadFromFile("/示例.pdf");

       // 加載一張圖片
       PdfImage footerImage = PdfImage.fromFile("/banner.png");

       // 創(chuàng)建字體
       PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("DengXian", Font.BOLD, 12),true);

       // 創(chuàng)建筆刷
       PdfBrush brush = PdfBrushes.getWhite();

       // 創(chuàng)建當(dāng)前頁(yè)碼字段
       PdfPageNumberField pageNumberField = new PdfPageNumberField();

       // 創(chuàng)建總頁(yè)數(shù)字段
       PdfPageCountField pageCountField = new PdfPageCountField();

       // 創(chuàng)建一個(gè)組合字段，將頁(yè)碼和頁(yè)數(shù)字段組合為字符串
       PdfCompositeField compositeField = new PdfCompositeField(font, brush, "第 {0} 頁(yè)，共 {1} 頁(yè)", pageNumberField, pageCountField);

       // 獲取字體大小
       Dimension2D fontSize = font.measureString(compositeField.getText());

       // 獲取頁(yè)面大小
       Dimension2D pageSize = doc.getPages().get(0).getSize();

       // 設(shè)置組合字段的位置
       compositeField.setLocation(new Point2D.Double((pageSize.getWidth() - fontSize.getWidth())/2,  pageSize.getHeight() - 45));

       // 遍歷文檔中的頁(yè)面
       for (int i = 0; i < doc.getPages().getCount(); i++)
       {
           // 獲取指定頁(yè)面
           PdfPageBase page = doc.getPages().get(i);

           // 在頁(yè)面底部空白區(qū)域繪制圖片
           page.getCanvas().drawImage(footerImage, 55, pageSize.getHeight() - 65, pageSize.getWidth() - 110, 50);

           // 在頁(yè)面底部空白區(qū)域繪制組合字段
           compositeField.draw(page.getCanvas());
       }

       // 保存結(jié)果文檔
       doc.saveToFile("/添加頁(yè)腳.pdf");
       doc.dispose();
   }
}

————————————————————————————————————————

關(guān)于慧都科技：

慧都科技是專注軟件工程、智能制造、石油工程三大行業(yè)的數(shù)字化解決方案服務(wù)商。在軟件工程領(lǐng)域，我們提供開(kāi)發(fā)控件、研發(fā)管理、代碼開(kāi)發(fā)、部署運(yùn)維等軟件開(kāi)發(fā)全鏈路所需的產(chǎn)品，提供正版授權(quán)采購(gòu)、技術(shù)選型、個(gè)性化維保等服務(wù)，幫助客戶實(shí)現(xiàn)技術(shù)合規(guī)、降本增效與風(fēng)險(xiǎn)可控。慧都科技E-iceblue的官方授權(quán)代理商，提供E-iceblue系列產(chǎn)品免費(fèi)試用，咨詢，正版銷售等于一體的專業(yè)化服務(wù)。E-iceblue是國(guó)產(chǎn)文檔處理領(lǐng)域的優(yōu)秀產(chǎn)品，支持國(guó)產(chǎn)化信創(chuàng)，幫助企業(yè)高效構(gòu)建文檔處理的應(yīng)用程序。

歡迎下載|體驗(yàn)更多E-iceblue產(chǎn)品